This page contains instructions for installing Java and setting JAVA_HOME.
You can skip this page if you are using the Windows Installer.
1. Installing Java
JIRA requires a Java Development Kit (JDK) version 5 (1.5) or above to run. The JDK may be obtained from Sun's website (get the 'offline' edition if you're using Windows).
If you are running the Sun JRE version 6 (1.6), please ensure that you are running Update 10 or higher.
Linux note: Linux distributions frequently have an open-source implementation of Java called GCJ installed. Do not use this - it is incomplete and will cause JIRA to fail in obscure ways. You can test whether you have the correct Sun Java by running
java -version :
On recent Linux distributions, Sun's Java can be installed with a command like
sudo apt-get install sun-java6-jdk (for Ubuntu).
Linux note: On recent X.org-based distros (eg. FC4+) to avoid getting errors like:
you will need to install the xorg-x11-deprecated-libs package (Fedora) or equivalent (check Google ).
2. Setting JAVA_HOME
Once the JDK is installed, you will need to set the JAVA_HOME environment variable, pointing to the root directory of the JDK. Some JDK installers set this automatically (check by typing '
echo %JAVA_HOME% ' in a DOS prompt, or '
echo $JAVA_HOME ' in a shell). If it is unset, set it by hand in the Control Panel.
- Right click on the My Computer icon on your desktop and select properties
- Click the Advanced Tab
- Click the Environment Variables button
- Click New
- Enter JAVA_HOME as the variable name and the directory where you installed Java.
- Restart your computer.
3. Confirming that Java works
When the above steps have been done correctly, it should be possible to open a Windows command prompt and type
%JAVA_HOME%\bin\java -version (or
"%JAVA_HOME%"\bin\java -version if your
%JAVA_HOME% value contains spaces) and see output similar to this:
If, later on when you try to start JIRA, you get the error Windows cannot find '-Xms128m', it is because you have not correctly set JAVA_HOME.