Run Jira as a systemd service on linux

Still need help?

The Atlassian Community is here for you.

Ask the community

Linux/Solaris system administration is outside the scope of Atlassian support. This page is provided for your information only.


Purpose

This article explains how to install Jira as a systemd service in linux. 

Pre-requisites

JIRA is installed and working, but does not automatically start on boot. For example, JIRA is installed via the .zip package rather than the .bin installer, or you have migrated JIRA to a different server,

Solution

    1. Login to the machine as root user
    2. Create the following systemd unit file for JIRA service as root:

      touch /lib/systemd/system/jira.service
      chmod 664 /lib/systemd/system/jira.service
    3. Edit the systemd unit file as root 

      vi /lib/systemd/system/jira.service
    4. Add the following content into the systemd unit file to define the JIRA service:

      [Unit] 
      Description=Atlassian Jira
      After=network.target
      
      [Service] 
      Type=forking
      User=jira
      LimitNOFILE=20000
      PIDFile=/opt/atlassian/jira/work/catalina.pid
      ExecStart=/opt/atlassian/jira/bin/start-jira.sh
      ExecStop=/opt/atlassian/jira/bin/stop-jira.sh
      
      [Install] 
      WantedBy=multi-user.target 

      (info) The above defined 'jira' user would be the user that is used to run JIRA, change this if you are running JIRA under a different user.

      (info) '/opt/atlassian/jira' would the default JIRA installation path, change this if your JIRA installation path is different.
      (warning) Do not run the Jira in the foreground as this will prevent the catalina.out file from being created. 

    5. Enable the service and start it:

      systemctl daemon-reload
      systemctl enable jira.service
      systemctl start jira.service
      systemctl status jira.service


Last modified on Jul 20, 2021

Was this helpful?

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