Supported platforms

Before installing Jira 8.0, make sure you have the right software and infrastructure to run it. If a platform and version is not listed on this page, it means we don't test it, fix bugs or provide assistance for it.

Definitions:

(tick) Supported - you can use Jira 8.0 with this platform.

(info) Limited - you can evaluate Jira 8.0 on this platform, but you can't run a production site on it. 

(warning) Deprecated - support for this platform will end in an upcoming release.

Further information:

Java

Oracle JRE / JDK:

(tick) Java 8

OpenJDK:

(tick) Java 8

Good to know:

Oracle JRE / JDK

  • We recommend using the Critical Patch Update (CPU) releases.
  • You don't need to install Java if using the Windows Installer or Linux Installer, as Oracle JRE is bundled with Jira. 

OpenJDK / AdoptOpenJDK

  • Our Support and Engineering teams use AdoptOpenJDK to replicate any issues raised with OpenJDK. If you’re using a different distribution of OpenJDK (e.g. Zulu), we’ll still provide support for our products. However, if the bug is caused by a problem in Java distribution, we’ll ask you to reach out to the Java distributor for help.

  • Unlike Oracle JRE, AdoptOpenJDK is not bundled with the Jira installers, and you need to install it on your own.

Operating systems

Operating systems:

(tick) Microsoft Windows

(tick) Linux / Solaris

(info) Mac OS X

(tick) Amazon Web Services (AWS)

(tick) Microsoft Azure

Good to know:

  • Jira is a pure Java-based application and should run on any supported operating system, provided that the JDK / JRE requirements are satisfied.

Microsoft Windows:

Linux / Solaris:

AWS / Azure:

  • If you’re creating your own deployment in AWS or Azure, you can use any configuration (e.g. OS or database) that’s supported both by Jira and AWS/Azure.
  • If you’re using our reference templates, you will deploy a pre-configured environment, with some level of customizations available. For more info on our templates, see Jira Data Center on AWS or Jira Data Center on Azure.

Browsers

Desktop browsers:

(tick) Chrome (latest stable version)

(tick) Internet Explorer 11

(tick) Microsoft Edge 

(tick) Mozilla Firefox (latest stable version) 

(tick) Safari on Mac OS X only (latest stable version)

Mobile browsers:

(tick) Chrome (latest stable version)

(tick) Safari on iOS only (latest stable version)

(tick) Android 4.0 (Ice Cream Sandwich) 

Good to know:

  • We support a minimum screen resolution of 1024 x 768 (when browsers are maximized).

Internet Explorer:

  • 'Compatibility View' won't work on Internet Explorer.

Mobile:

  • You can only view Jira on a mobile device using the mobile view. The native app is only available for Cloud sites.

Databases 

PostgreSQL:

(tick) PostgreSQL 9.6

(tick) PostgreSQL 9.5

(tick) PostgreSQL 9.4

Jira is tested and bundled with the 9.4 JDBC driver. You can also use the latest JDBC driver for your PostgreSQL version, though we can't guarantee it will work with your version of Jira. To use a different JDBC driver:

  1. Stop your Jira instance.
  2. Remove the bundled driver from <JIRA_INST>/lib/.
  3. Download the new driver and place it in <JIRA_INST>/lib/.
  4. Restart your Jira instance.

Jira 8.x

Jira does not support reducing the blocksize parameter below its default value.

MySQL:

(tick) MySQL 5.7 

(tick) MySQL 5.6

  • Jira will not work on:
    • 4 byte characters in MySQL 5.6 (it works with MySQL 5.7)
    • MariaDB nor PerconaDB
  • We recommend running MySQL in strict mode.
  • Supported MySQL databases use the MySQL Connector/J 5.1 driver.

Jira 8.x

Jira does not support reducing the innodb_page_size parameter below its default value.

Oracle

(tick) Oracle 12c R1

    • Jira will not work on:
      • Oracle Advanced Compression Option (ACO)
    • Supported Oracle databases use the 12.2.0.1 driver listed here

Jira 8.x

Jira does not support reducing the DB_BLOCK_SIZE parameter below its default value.

Microsoft SQL Server

(tick) SQL Server 2016

(tick) SQL Server 2014

(tick) SQL Server 2012

    • Jira will not work on:
      • Express Editions of Microsoft SQL Server
    • Supported Microsoft SQL databases use the Microsoft JDBC 6.2.1 Driver.
    • To start Jira 8.0 on SQL Server using OpenJDK 11, see Start Jira 8.x with OpenJDK 11 and SQL Server

Embedded database

(info) H2 (evaluation only)

    • Jira ships with a built-in database (H2).

Environment and Infrastructure

Hardware

  • NFS mounts are supported only for Jira Data Center's shared home directory. They won't work for Server, or DC's local home directory due to Lucene requirements. Read the IndexWriter docs for more information. 
  • We only support Jira running on x86 hardware and 64-bit derivatives of x86 hardware.
  • If you are installing Jira from an archive, create a dedicated user account on the operating system to run Jira, since Jira runs as the user it is invoked under, it can potentially be abused.

Virtualization

  • VMware supports all of the operating systems listed under 'Operating systems'.
  • We don't provide support for VMWare itself.
  • Read Virtualizing Jira for information on how to configure VMWare.

Application server

  • We support Apache Tomcat 8.5.35. 
  • We don't support deploying multiple Atlassian applications in a single Tomcat container. 

Internet protocols (IP)

  • We support IPv4.
  • We support IPv6 with some limitations. See IPv6 in Jira.

External user directories

You can manage users in the following LDAP directories:

  • Apache Directory Server 1.0.x
  • Apache Directory Server 1.5.x
  • Apple Open Directory (Read-Only)
  • FedoraDS (Read-Only Posix Schema)
  • Generic Directory Server
  • Generic Posix/RFC2307 Directory (Read-Only)
  • Microsoft Active Directory
  • Novell eDirectory Server
  • OpenDS
  • Open LDAP
  • Open LDAP (Read-Only Posix Schema)
  • Sun Directory Server Enterprise Edition

Mail servers

  • SMTP servers must be able to support the multipart content type.

Last modified on Aug 14, 2019

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.