Getting Started Tutorial FAQ
Here you will find a list of Frequently Asked Questions about the 'Set up the Atlassian Plugin SDK and Build a Project' Tutorial.
How do I check if Oracle Java SE Development Kit 8 (JDK) is installed?
You can check which version of JAVA you have installed on your system by opening a Terminal window and running the following command:
If you're running the Oracle JAVA 8 you'll see a response like
If you see an error like 'command not found' or just no response, then you'll need to install the Java SE Development Kit.
You can get this at Oracle Java SE Development Kit 8 Downloads.
I get a BUILD FAILURE Error with 'Please verify you invoked Maven from the correct directory'
You might come across the following error when you try to start up your plugin using the
atlas-run command if you have not changed to the directory with the plugin skeleton you created:
How to fix it
Make sure you're in your plugin directory and make sure the
pom.xml file has been created.
I get a BUILD FAILURE error with 'Unsupported major.minor version 52.0'
You may see the following error if you are using the Oracle Java SE Development Kit 7 with the latest version of the Atlassian Plugin SDK:
The latest version of the Atlassian Plugin SDK requires Oracle Java SE Development Kit 8.
How to confirm
You can check which version of JAVA you are using by entering the following command:
The output will look something like:
Lines 10 and 11 in the above output show the Java version is 1.7.x rather than 1.8.x
How to fix it
Step 1. Install Oracle Java SE JDK 8
You can download the install files for the latest version on the Oracle website at http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html.
Follow the instructions on the Oracle website to install Java for your system.
Step 2. Set your JAVA_HOME variable
JAVA_HOME environment variable specifies the location of the JDK on your system. For Windows users, the default directory is
C:\Program Files\Java\jdk1.8.x_y , where x_y is the Java JDK 8 version you have installed. To set JAVA_HOME:
- Browse to the
C:\Program Files\Java\jdk1.8.x_yfolder on your system and copy the path to the folder.
- Open Control Panel > System>Advanced System Settings.
- On the Advanced tab click Environment Variables.
- Locate the System variables section and click New.
- Enter JAVA_HOME in the Variable name field and paste the folder path you copied into the Variable value field.
- Click OK to close the dialog.
- Click on Path variable in the System variables section and click Edit.
- Click New and type
%JAVA_HOME%\binin the available space.
- Close all dialog windows.
Open a new Command Prompt window, and run the following command:
verify that your output is similar to what appears above.
Mac / Linux
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
Still Stuck? Request support at Developer Technical Support Portal