Installing Java
Here you will find instructions for installing the Java Development Kit (JDK). This is a manual step that's only required if you're installing a Jira application from a zip or archive file. If you're using the Windows installer or Linux installer, you don't need to install Java manually.
Check the Supported platforms page to find which Java versions are supported for Jira.
Installing Java
You'll need to install the JDK on the same server that will have your Jira application.
On Linux and Mac OS X
Before you start, check whether a JDK is already installed.
- Open a shell console and type
echo $JAVA_HOME
and hit Enter:- If it returns something like
/opt/JDK7
or/usr/lib/jvm/java-7
then your JDK is installed and configured - If nothing displays, you'll need to install the JDK or set the
$JAVA_HOME
environment variable
- If it returns something like
- Check the Supported platforms page to find out which JDK versions are supported for your version of Jira.
- Download the appropriate Oracle JDK or AdoptOpenJDK version.
- Run the Java installer. Detailed installation instructions are provided on http://www.oracle.com/technetwork/java/javase/index-137561.html.
- Open a shell console and type
echo $JAVA_HOME
and hit Enter to check that it has installed correctly.
On Windows
Before you start, check whether a JDK is already installed.
- Go to Control Panel > Programs and Features to see what JDK version is installed.
- Check the Supported platforms page to find out which JDK versions are supported for your version of Jira applications.
- Download the right Oracle JDK or AdoptOpenJDK version.
- Run the Java installer. Make a note of the installation directory, as you'll need this later.
- Open a command prompt and type
echo %JAVA_HOME%
and hit Enter:- If you see a path to your Java installation directory, the
JAVA_Home
environment variable has been set correctly. - If nothing is displayed, or only
%JAVA_HOME%
is returned, you'll need to set theJAVA_HOME
environment variable manually.
- If you see a path to your Java installation directory, the
Set the JAVA_Home
If you installed the JDK, you'll be setting the JAVA_HOME
environment variable. If you installed the Java Runtime Environment (JRE), follow the same steps, but set the JRE_HOME
environment variable instead.
On Linux
The JAVA_HOME
environment variable is sometimes set in the /etc/environment
file. You'll need to modify its value to JAVA_HOME="path/to/JAVA_HOME".
If
JAVA_HOME
is not defined in this file, set it using the following command at a shell prompt, when logged in with 'root' level permissions:export JAVA_HOME="path/to/JAVA_HOME" >> /etc/environment
- Log out for these changes to apply.
On Mac OS X
The JAVA_HOME
environment variable is set in the ~/.bash_profile
file. You'll need modify its value to JAVA_HOME="path/to/JAVA_HOME"
.
If
JAVA_HOME
is not defined in this file, set it using the following command at a shell prompt, when logged in with 'root' level permissions:export JAVA_HOME="path/to/JAVA_HOME" >> ~/.bash_profile
- You'll need to open a new terminal for these changes to apply.
On Windows
- Locate your Java installation directory, it will be something like
C:\Program Files\Java\jdk1.8.0_65
- Do one of the following:
- Windows 7 – Right click My Computer and select Properties > Advanced
- Windows 8 – Go to Control Panel > System > Advanced System Settings
- Windows 10 – Search for Environment Variables then select Edit the system environment variables
- Click the Environment Variables button.
- Under System Variables, click New.
- In the Variable Name field, enter:
JAVA_HOME
if you installed the JDKJRE_HOME
if you installed the JRE
In the Variable Value field, enter your JDK or JRE installation path.
For Windows users on 64-bit systems:
Progra~1 = 'Program Files'
Progra~2 = 'Program Files(x86)'
Click OK and Apply Changes as prompted.
You'll need to close and re-open any command windows that were open before you made these changes. If the changes don't take effect after reopening the command window, restart Windows.
If you start Jira and you get an error like Windows cannot find '-Xms128m' you've probably not set JAVA_HOME
correctly.