Documentation for JIRA 4.3. Documentation for other versions of JIRA is available too.

Skip to end of metadata
Go to start of metadata

On this page:

Icon

You can skip this page if you are using the Windows Installer.

1. Installing Java

JIRA requires Oracle's (formerly Sun's) Java Development Kit (JDK) or Java Runtime Environment (JRE) platform version 6 (1.6) update 10 or later to run. The JDK may be obtained from Oracle's website (get the 'offline' edition if you're using Windows).

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 Java platform by running java -version :

On recent Linux distributions, Oracle's (formerly Sun's) JDK 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 or JRE is installed, you will need to set the JAVA_HOME environment variable, pointing to the root directory of the JDK or JRE. Some JDK/JRE installers set this automatically (check by typing 'echo %JAVA_HOME%' in a Windows command prompt, or 'echo $JAVA_HOME' in a Linux/UNIX shell prompt).

If this environment variable is not set on a Windows-based computer, you can set it in the Control Panel using the following procedure:

  1. Open the Windows 'Advanced' system properties dialog box:
    • On Windows XP-based operating systems, right-click on the My Computer icon on your desktop (or via the Start menu), select 'Properties' and click the 'Advanced' tab.
    • On Windows 7-based operating systems, right-click the Computer icon on your desktop (or via the Start menu), select 'Properties', click 'Advanced system settings', select 'Properties' and click the 'Advanced' tab.
  2. Click the Environment Variables button.
  3. Click one of the New buttons (to define a new environment variable for your user account, or if available, system-wide).
  4. Type JAVA_HOME as the variable name and the directory where you installed Java.
  5. After clicking the required 'OK' buttons to save your changes, your JAVA_HOME environment variable should be available in a new command prompt window. If not or if necessary, 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.

Next Step

Install JIRA Standalone