Installing Java for Confluence

This page contains instructions for installing the Java Development Kit (JDK). This is a manual step that's only required if you're installing Confluence from a zip or archive file.  If you're using the Confluence installer, you do not need to install Java manually. 

Check the Supported Platforms page to find out which Java versions are supported for Confluence.

Installing Java

The JDK (Java Development Kit) needs to be installed on the same server that will have Confluence installed.  We support running Confluence with the JDK or JRE (Java Runtime Environment). These instructions will just cover installing the JDK. 

  For Windows: (click to expand)

Installing the JDK on Windows

Before you start, go to Control Panel > Programs and Features to check whether a JDK is already installed.

To install the JDK on Windows:

  1. Download the appropriate JDK version.
    Check the Supported Platforms page to find out which JDK / JRE versions are supported for your version of Confluence.
  2. Run the Java installer. Make a note of the installation directory, as you'll need this later.
  3. Once the Java installation is complete, check that the JAVA_HOME  environment variable has been set correctly.
    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 the JAVA_HOME environment variable manually. See Setting the JAVA_HOME Variable in Windows for a step by step guide.  
  For Linux: (click to expand)

Installing the JDK on Linux

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 properly configured.
  • If nothing is displayed, you'll need to install the JDK or set the $JAVA_HOME environment variable.
    You can set this environment variable in your user account's 'profile' file. Alternatively, you can set this after installing Confluence, by defining this path in your Confluence installation's setenv.sh file, usually located in the Confluence bin directory.
  • If you have installed an unsupported JDK and you want to use SSL then you need to install the Sun JSSE package.

To install the JDK on Linux:

  1. Download the appropriate JDK version.
    Check the Supported Platforms page to find out which JDK / JRE versions are supported for your version of Confluence.
  2. Run the Java installer. Detailed installation instructions are provided on Oracle's website.
  3. Open a shell console and type echo $JAVA_HOME and hit Enter to check that it has installed correctly (see notes above).

Note: Any Java or JDK version numbers on this page are examples only. Please refer to the Supported Platforms page for supported versions of Java.

Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

Have a question about this article?

See questions about this article

Powered by Confluence and Scroll Viewport