Install the Atlassian SDK on a Linux or Mac system
On this page, you install the SDK on your Linux or Mac system. You also configure your operating system to recognize the SDK commands in your environment.
Step 1: Configure your environment
Verify that you JAVA_HOME is set in your system by running echo $JAVA_HOME from the terminal
If the output resembles the above skip ahead to Step 2: Download and Install the SDK
JAVA_HOME environment variable specifies the location of the JDK on your system. On Mac OS X, if you accepted the defaults when you installed the JDK, this is
/Library/Java/JavaVirtualMachines/1.8.0.jdk/Contents/Home. On Linux, it may be
/usr/local/jdk, or a similar location. You should add the JDK's
bin directory to your
PATH environment variable as well. This ensures your environment is configured and can locate the
To set your
.bashrcfile in your home directory using your favourite editor (we use vi in this example).
Add the following lines at the end of the file:
- Save and close the file.
Enter the following at the command line to pick up your changes:
Verify you are now seeing the correct result when you enter the command
javac -versionin terminal
Step 2: Download and install the SDK
There are native installers for a number of operating systems available, as well as a TGZ (GZipped tar file) which can be used for manual installation.
Select the installation instructions that best suit you:
- Download the PKG file.
- Double click the PKG file to launch the installer.
- Follow the prompts to complete the installation.
- Next: Verify that you have set up the SDK correctly
Open a Terminal window and add the Atlassian "Tap" to your Brew using the command:
Then install the SDK via the atlassian/tap using the command:
Debian, Ubuntu Linux
On a Debian based Linux like Ubuntu, you can install the Atlassian Plugin SDK using
aptitude, but first you have to set up the Atlassian repositories. You only need to do this once and it requires
To set up the Atlassian repositories,
Open a terminal window and enter the following:
After the prompt returns, add the public key:
Once you have set up the Atlassian repositories, enter the following to install the SDK:
Note: You can use the same
apttools to upgrade the SDK to a new version when an update becomes available.
The first command makes sure that you have
apt-transport-httpspackage installed to make
aptbe able to access https repositories.
Red Hat Enterprise Linux, CentOS, Fedora (RPM)
All you should have to do to download the latest version of the SDK is:
If this does not work, try downloading and installing manually:
Then, open a Terminal window and start the installation:
remember that you will need to modify your path in the above example, it should be something like ~/Downloads/atlassian-plugin-sdk-6.2.9.noarch.rpm
To install the latest version of SDK, do the following:
- Download a TGZ (GZipped tar file) of the SDK
- Locate the downloaded SDK file.
Extract the file to your local directory.
Rename the extracted folder to
If you are comfortable working with symbolic links, you can set up a symbolic link instead of renaming the directory.
Step 3: Verify that you have set up the SDK correctly
Open a terminal window and run the following command:
You should see something similar to:
You now have a local development environment configured for the Atlassian SDK and you're ready to build your first plugin!
Need help? Request support at Developer Technical Support Portal