Last updated Jan 4, 2019

Downloads

Before you begin

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

First time users

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

Download the installer

For Windows and macOS users, you can download the latest version of the installer via Atlassian Marketplace:

Installing from Package Managers

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.

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 uninstall.sh 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 http://mxcl.github.com/homebrew/

To install the Atlassian Plugin SDK in Brew:

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

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

    1
    2
    brew install atlassian/tap/atlassian-plugin-sdk
    

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

1
2
brew update
brew upgrade atlassian/tap/atlassian-plugin-sdk

Installing an earlier version of the SDK

If you need to install an earlier version of the SDK for any reason, you will find it on the Atlassian Marketplace.

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

    1
    2
    sudo apt-get --purge remove atlassian-plugin-sdk
    
  2. Download the version you want from the Atlassian Marketplace:

  3. Once you have the package for the version you want, install it using the method appropriate for your operating system.

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

    1
    2
    /usr/share/atlassian-plugin-sdk-4.1.5/bin
    

Rate this page: