Rate this page:
Last updated 04 Dec 2015 By downloading and/or using this SDK you agree to the Atlassian Developer Terms
To install the Atlassian Plugin SDK, you'll also need the following:
Java SE Development Kit (JDK) 8 or AdoptOpenJDK 8
Your JAVA_HOME variable set
A note on OpenJDK
The Atlassian Plugin SDK currently supports AdoptOpenJDK 8 only.
If you're installing the Atlassian SDK for the first time, you can find detailed instructions for setting your JAVA_HOME, downloading and installing the Atlassian Plugin SDK and creating your first project.
› Set up the Atlassian SDK and Build a Project
For Windows and macOS users, you can download the latest version of the installer via Atlassian Marketplace:
If you prefer you can use a suitable package manager for your operating system to install the Atlassian SDK.
If you previously installed the SDK using
tar.gz and added the SDK folder to your
PATH, you'll need to remove it from your
PATH before starting.
On a Debian-based Linux system like Ubuntu, you can install the SDK using
First, set up the Atlassian SDK repositories:
sudo sh -c 'echo "deb https://packages.atlassian.com/debian/atlassian-sdk-deb/ stable contrib" >>/etc/apt/sources.list'
Download the public key using
Add the public key to
apt to verify the package signatures automatically:
sudo apt-key add public
Then, run the install:
sudo apt-get update sudo apt-get install atlassian-plugin-sdk
To install on systems that use the Yum package manager:
Create the repo file in your /etc/yum.repos.d/ folder:
sudo vi /etc/yum.repos.d/artifactory.repo
Configure the repository details:
[Artifactory] name=Artifactory baseurl=https://packages.atlassian.com/yum/atlassian-sdk-rpm/ enabled=1 gpgcheck=0
Install the SDK:
sudo yum clean all sudo yum updateinfo metadata sudo yum install atlassian-plugin-sdk
As of 4.0, a
pkg installer is available for OSX. It installs the SDK in
/usr/share and adds links for the
atlas commands into
uninstall.sh script is also provided in
Alternatively Homebrew (aka, Brew) is an open source package manager for OS X and is an alternative to MacPorts. You can learn more about Homebrew and how to it install it at http://mxcl.github.com/homebrew/
To install the Atlassian Plugin SDK in Brew:
Add the Atlassian "Tap" to your Brew:
brew tap atlassian/tap
Next, install the SDK via the
brew install atlassian/tap/atlassian-plugin-sdk
This installs the SDK. Later, if you want to upgrade the SDK to a new version, use:
brew update brew upgrade atlassian/tap/atlassian-plugin-sdk
If you need to install an earlier version of the SDK for any reason, you will find it on the Atlassian Marketplace.
The Atlassian Marketplace contains versions of the Atlassian Plugin SDK after 4.0. If you need an older version than what is available on the Marketplace, you can get it from the Atlassian Public Maven repository.
Remove an existing install, if necessary, using the method appropriate for your operating system. For example, for Debian / Ubuntu Linux, enter the command:
sudo apt-get --purge remove atlassian-plugin-sdk
Download the version you want from the Atlassian Marketplace:
Once you have the package for the version you want, install it using the method appropriate for your operating system. For example, for Debian / Ubuntu Linux, use:
sudo dpkg -i package_name
Where package_name is the name of the file you downloaded. For example:
sudo dpkg -i atlassian-plugin-sdk_4.1.5_all.deb
The PATH isn't set automatically, so add the
bin directory to your PATH manually, say in
Rate this page: