Installing Jira applications on Linux

In this guide we'll run you through installing a Jira application in a production environment, with an external database, using the Linux installer.

This is the most straightforward way to get your production site up and running on a Linux server.



Other ways to install Jira: 

  • Evaluation - get your free trial up and running in no time.
  • TAR.GZ – install Jira manually from an archive file. 
  • Windows – install Jira on a Windows server.

On this page:

The Linux and Windows installer already includes the bundled JRE.

If you decide to install Jira with the tar.gz archive file, you should also install the JRE or the JDK. Learn more about the supported versions:

Before you begin

Before you install Jira, there are a few questions you need to answer. 


Are you using a supported operating system?
Tell me more...

Check the Supported Platforms page for the version of Jira you are installing. This will give you info on supported operating systems, databases and browsers.

Good to know:

  • We don't support installing Jira on OSX or mac OS for production sites.
  • The Jira installer includes Java (JRE) and Tomcat, so you don't need to install these separately.

Do you want to run Jira as a service?

Tell me more...

Running Jira as a service means that Jira will automatically start up when Linux is started.

If you choose to run Jira as a service:

  • You must use sudo to run the installer to be able to install Jira as a service. 
  • The installer will create a dedicated user account, jira, that will run the service.

If you choose not to run Jira as a service:

  • You will start and stop Jira by running the start-jira.sh file in your Jira installation directory.
  • Jira will be run as the user account that was used to install Jira, or you can choose to run as a dedicated user.
  • Jira will need to be restarted manually if your server is restarted.
Is your database set up and ready to use?
Tell me more...

To run Jira in production you'll need an external database. Check the Supported platforms page for the version you're installing for the list of databases we currently support. If you don't already have a database, PostgreSQL is free, easy to set up and has been extensively tested with Jira.

Good to know:

  • Set up your database before you begin. Step-by-step guides for all supported databases are available in Connecting Jira applications to a database.
  • Use UTF-8 character encoding.
  • If you're using Oracle or MySQL you'll need to download the driver for your database.
  • The embedded H2 database can be used for evaluating Jira, but you'll need to migrate to another database before running in production. You may find it easier to use external database from the start.

Do you have a Jira license?

Tell me more...

You'll need a valid Jira Software, Jira Core, or Jira Service Management license to use Jira.

Good to know:

  • If you have not yet purchased a Jira application license you'll be able to create an evaluation license during setup.
  • If you already have a license key, you'll be prompted to log in to my.atlassian.com to retrieve it, or you can enter the key manually during setup.
  • If you're migrating from Jira Cloud, you'll need a new license forJira.

Check some known issues
Tell me more...

For Linux installations, we've noticed some problems when displaying certain system text in the application (CAPTCHA and gadgets). Instead of showing regular alphanumeric letters, the text will appear to be garbled and look like symbols. To avoid this problem, you should install several fonts that are required by Jira. For more info, see Jira UI shows unreadable text.


Install a Jira application

1. Download Jira

Download the installer for your operating system:

The installer already includes the bundled JRE.

2. Run the installer

  1. Make the installer executable.

    Show me how to do this...

    Change to the directory where you downloaded Jira then execute this command:

    Jira Core
    $ chmod a+x atlassian-jira-core-X.X.X-x64.bin
    Jira Software
    $ chmod a+x atlassian-jira-software-X.X.X-x64.bin
    Jira Service Desk
    $ chmod a+x atlassian-servicedesk-X.X.X-x64.bin

    Where -X.X.X is is the Jira version you downloaded.

  2. Run the installer, we recommend using sudo to run the installer as this will create a dedicated account to run Jira and allow you to run Jira as a service.
     

    Show me how to do this...

    To use sudo to run the installer execute this command:

    Jira Core
    $ sudo ./atlassian-jira-core-X.X.X-x64.bin
    Jira Software
    $ sudo ./atlassian-jira-software-X.X.X-x64.bin
    Jira Service Desk
    $ sudo ./atlassian-servicedesk-X.X.X-x64.bin

    Where -X.X.X is is the Jira version you downloaded.

    You can also choose to run the installer as with root user privileges.

  3. Follow the prompts to install Jira. You'll be asked for the following info:
     
    • Install type – choose option 2 (custom) for the most control. 
    • Destination directory – this is where Jira will be installed.
    • Home directory – this is where Jira data like logs, search indexes and files will be stored.
    • TCP ports – these are the HTTP connector port and control port Jira will run on. Stick with the default unless you're running another application on the same port.
    • Install as service – this option is only available if you ran the installer as sudo
  4. Once installation is complete head to http://localhost:8080 in your browser to begin the setup process. 
    (Replace 8080 if you chose a different port during installation) . 

Set up your Jira application

3. Choose set up method

Choose I'll set it up myself.

4. Connect to your database

  1. If you've not already done so, it's time to create your database. See the 'Before you begin' section of this page for details. 
  2. Choose My own database
  3. Choose your database type then enter the details for your database. 
      

    Show me how to do this...

    JIRA connects to your database using a standard JDBC database connection. Connection pooling is handled within JIRA, you can change this using JIRA configuration tool later.

    If you're using Oracle or MySQL there's an extra step: 

    • Download and extract the appropriate database JDBC drivers. See Supported platforms to get the right version.
    • Drop the JAR file into your <jira-installation>/lib folder before continuing with the setup wizard.

    In the setup wizard:

    • Driver Class Name – the Java class name for your database driver. If you're not sure, check the documentation for your database.
    • Database URL – the JDBC URL for your database. If you're not sure, check the documentation for your database.
    • Username and Password – A valid username and password that JIRA can use to access your database.

5. Set application properties

  1. Give your Jira site a name.
  2. Choose whether your site should be private or anyone can sign up. You can change this later. 
  3. Enter your base URL - this is the address people will use to access your Jira site. 

6. Enter your license

Follow the prompts to log in to my.atlassian.com to retrieve your license, or enter a license key.

7. Create your administrator account

Enter details for the administrator account.  You can add more administrators after set up is complete.

8. Set up email notifications

Enter details of your mail server.  This will allow Jira to send notifications when issues change.

9. Start using Jira

That's it! Your Jira site is accessible from your base URL or a URL like this: http://<computer_name_or_IP_address>:<port>

Here's a few things that will help you get your team up and running:

Troubleshooting

Running into problems installing Jira?
  • Some anti-virus or other Internet security tools may interfere with the Jira installation process and prevent the process from completing successfully. If you experience or anticipate experiencing such an issue with your anti-virus/Internet security tool, disable this tool first before proceeding with the Jira installation.
  • The Linux OOM Killer can sometimes kill Jira processes when memory on the server becomes too low. See How to Configure the Linux Out-of-Memory Killer.

 Head to Installation Troubleshooting for more help.  

Last modified on Mar 28, 2023

Was this helpful?

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