Supported platforms

Before installing Jira 8.5, 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.5 with this platform.

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

(warning) Deprecated - you can use Jira 8.5 with this platform, but we're planning to end support in an upcoming release.

Further information:

Java

Oracle JRE / JDK:

(tick) Java 8

(tick) Java 11

OpenJDK:

(tick) Java 8

(tick) Java 11

Good to know:

Oracle JRE / JDK

  • We recommend using the Critical Patch Update (CPU) releases.

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.
  • You don't need to install Java if using the Windows Installer or Linux Installer as AdoptOpenJDK JRE is bundled with Jira.
  • We support AdoptOpenJDK up to version 11.0.2.

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:

  • We perform tests on Ubuntu.

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)

(warning) 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 view Jira on a mobile device using the Jira mobile app or the mobile view (browser).

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 19c

(tick) Oracle 18c

(tick) Oracle 12c R2

(tick) Oracle 12c R1

    • Jira will not work on:
      • Oracle Advanced Compression Option (ACO)

    • JDBC Driver: For all Oracle versions, use the JDBC 19.3 (ojdbc8) driver listed here. This is the driver we’re using to test Jira with Oracle.

Jira 8.x

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

Microsoft SQL Server

(tick) SQL Server 2017

(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 7.2.1 Driver.

Microsoft Azure

(tick) Azure SQL

Amazon Aurora (Data Center only)

(tick) PostgreSQL 9.6


  • The only supported Amazon Aurora config is a PostgreSQL-compatible clustered database with one writer replicating to zero or more readers. Learn more

Embedded database

(info) H2 (evaluation only)

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

Environment and Infrastructure

Containerization

  • You can use official templates to deploy Jira in a Docker container, or customize a Docker deployment on your own.
  • We support the Jira templates and can help with Jira-related problems, but we don't provide support for Docker itself.

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 Nov 5, 2019

Was this helpful?

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