To get the Atlassian Plugin SDK, download and run the installer appropriate for your operating system.

Additional Requirements

All installations require version 1.7.x of the JDK. The Atlassian Plugin SDK does not support OpenJDK. If you're installing the SDK for the first time, follow the instructions here:

›› Set up the Atlassian Plugin SDK and Build a Project

Installing from Package Managers

The following instructions describe how to use package managers to install the 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.

Debian / Ubuntu Linux

On a Debian-based Linux system like Ubuntu, you can install the SDK using apt-get or aptitude:

  1. First, set up the Atlassian repositories:

  2. Add the public key:

  3. sudo apt-key fingerprint should include

  4. And lastly, run the install:

RPM / RHEL / CentOS / Fedora (Yum)

To install on systems that use the Yum package manager:

  1. Download the repo files to your /etc/yum.repos.d/ folder:

  2. Install the SDK:

Homebrew (OS X)

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 /usr/local/bin. An script is also provided in /usr/share/atlassian-plugin-sdk-N.N

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

To install the Atlassian Plugin SDK in Brew:

  1. Add the Atlassian "Tap" to your Brew:

  2. Next, install the SDK via the atlassian/tap:

This installs the SDK. Later, if you want to upgrade the SDK to a new version, use:

Installing an earlier version of the SDK

If you need to install an earlier version of the SDK for any reason, follow these steps:

  1. Remove an existing install, if necessary, using the method appropriate for your operating system. For example, for Debian / Ubuntu Linux, enter the command:

  2. Download the version you want from the Atlassian Marketplace:

    The Atlassian Marketplace contains only relatively recent version of the Atlassian Plugin SDK. If you need an older version than what is available on the Marketplace, you can get it from the Atlassian Maven repository.

  3. Once you have the package for the version you want, install it using the method appropriate for your OS. For example, for Debian / Ubuntu Linux, use:

    Where package_name is the name of the file you downloaded. For example:

  4. The PATH isn't set automatically, so add the bin directory to your PATH manually, say in etc/environment:

Powered by Confluence and Scroll Viewport