This article is written for those who were searching for a detailed and simple for the understanding guide on how to install Jira on Ubuntu Server.

Jira is a proprietary issue tracking product developed by Atlassian that allows bug tracking and agile project management.

In this guide, we will consider the case when you already have a server with the Ubuntu Server 18.04 LTS operating system installed on it.

You can read more about how to install Ubuntu Server 18.04 LTS in my guide «Installing Ubuntu Server 18.04 LTS».

In addition, OpenSSH must be installed on the server, and port 22 must be open in order to be able to connect to the server using the SSH protocol.

To install OpenSSH on the server, you can use the command:

sudo apt-get install openssh-server

If you plan to connect to the server using the Windows operating system, you can use PuTTY, a freeware client for various remote access protocols, including SSH, Telnet, rlogin.

This guide covers connecting to a server using the iTerm2 terminal emulator installed on the macOS operating system.

Please note that you will need to open the following TCP ports to access your server:

  • 80 – to receive a free cryptographic certificate through the Let’s Encrypt certificate authority.
  • 443 – to access the Jira web interface.
  • 8080 – to access the Jira web interface.

Connect to the server on which it is planned to install Jira.

This guide discusses how to obtain a free cryptographic certificate through the Let’s Encrypt Certificate Authority. To receive and further update the free SSL certificate, we will use the Certbot software client, which is designed to simplify the receipt and renewal of the certificate through the Let’s Encrypt certificate authority.

Add the Certbot repository using the command:

sudo add-apt-repository ppa:certbot/certbot

Press the “Enter” button to confirm the addition of a new repository.

Now install the packages necessary for Jira to work using the command:

sudo apt-get install -y postgresql apache2 fontconfig certbot python-certbot-apache

Please note that in this guide, PostgreSQL will be used as the database management system, and Apache will be used as the webserver.

Configure Apache for further work with the Jira.

Enable the Apache webserver module called “proxy_http” with the command:

sudo a2enmod proxy_http

Please note that the “proxy_http” module acts like a proxy server for the HTTP and HTTPS protocols.

Enable the Apache webserver module called “rewrite” with the command:

sudo a2enmod rewrite

Please note that the “rewrite” module is one of the most commonly used Apache webserver modules and provides a flexible and powerful way to manipulate URLs.

Now you need to create two virtual host files (called block in Nginx), with which Jira will continue to work.

Two virtual host files will be required to provide access to Jira via HTTPS, as well as to realize the possibility of using Jira at https://jira.heyvaldemar.net, without specifying port 8080 in the address bar of the browser.

In this manual, the jira.heyvaldemar.net subdomain will be used to access the Jira control panel from the Internet. You will need to specify your domain or subdomain by which your Jira will be accessible from the Internet.

Create the first virtual host file using a text editor using the command:

sudo vim /etc/apache2/sites-available/jira.heyvaldemar.net.conf

Press the “i” button to enter the editing mode, then insert the following configuration for the webserver to work:

In this manual, the jira.heyvaldemar.net subdomain will be used to access the Jira control panel from the Internet. You will need to specify your domain or subdomain by which your Jira will be accessible from the Internet.

Now press the “Esc” button to exit the editing mode, and then enter “:x” and press the “Enter” button to save the changes and exit the editor.

Create a second virtual host file using a text editor using the command:

sudo vim /etc/apache2/sites-available/jira.heyvaldemar.net-ssl.conf

Press the “i” button to enter the editing mode, then insert the following configuration for the webserver to work:

In this manual, the jira.heyvaldemar.net subdomain will be used to access the Jira control panel from the Internet. You will need to specify your domain or subdomain by which your Jira will be accessible from the Internet.

Now press the “Esc” button to exit the editing mode, and then enter “:x” and press the “Enter” button to save the changes and exit the editor.

Activate the first virtual host using the command:

sudo a2ensite jira.heyvaldemar.net.conf

Activate the second virtual host using the command:

sudo a2ensite jira.heyvaldemar.net-ssl.conf

Deactivate the default virtual host using the command:

sudo a2dissite 000-default.conf

Make sure that there are no errors in the syntax of the new Apache configuration file using the command:

sudo apache2ctl configtest

Restart Apache to apply the changes using the command:

sudo systemctl restart apache2

Verify that Apache started successfully using the command:

sudo systemctl status apache2

Now, to increase the security level of the webserver, it is necessary to obtain a cryptographic certificate for the domain or subdomain, through which the Jira will be accessible from the Internet.

To obtain and subsequently renew a free SSL certificate, we will use the Let’s Encrypt Certificate Authority, as well as the Certbot software client, which is designed to simplify the receipt and renewal of the certificate through the Let’s Encrypt Certificate Authority.

In this manual, the jira.heyvaldemar.net subdomain will be used to access the Jira control panel from the Internet. You will need to specify your domain or subdomain by which your Jira will be accessible from the Internet.

Request a cryptographic certificate using the command:

sudo certbot --apache -d jira.heyvaldemar.net

Next, indicate the email address to which Let’s Encrypt will send notifications about the expiration of the cryptographic certificate and press the “Enter” button.

The next step is to read and accept the terms of use of the services provided.

Press the “a” button, then “Enter” if you agree to the terms of use of the services provided.

At the next stage, you need to choose: do you want to share the email address indicated above with the Electronic Frontier Foundation to receive newsletters.

Press the “n” button, then “Enter”.

The next step is to choose: do you want the parameters to automatically redirect HTTP traffic to HTTPS be automatically added to the Apache configuration file.

Press the button “2”, then “Enter”.

Please note that the cryptographic certificates received through the Let’s Encrypt Certificate Authority are valid for ninety days. Certbot automatically adds a script to renew the certificate in the task scheduler, and the script runs twice a day, automatically updating any cryptographic certificate that expires within thirty days.

You can check the operability of the cryptographic certificate renewal process using the command:

sudo certbot renew --dry-run

Now you need to create a database that Jira will use in the future, as well as a user with the necessary rights to this database.

Switch to the “postgres” user, who has administrator rights in PostgreSQL using the command:

sudo su - postgres

Next, switch to the PostgreSQL command line using the command:

psql

Create a new user using the command:

CREATE USER jiradbuser WITH PASSWORD 'bX^JR]v$56DW%$c+M';

The user name will be “jiradbuser” with the password “bX^JR]v$56DW%$c+M”.

Create a new database and give it rights to the previously created user using the command:

CREATE DATABASE jiradb WITH OWNER "jiradbuser" ENCODING 'UNICODE' LC_COLLATE 'C' LC_CTYPE 'C' TEMPLATE template0;

In this manual, “jiradb” will be used as the name for the database.

Exit the PostgreSQL command line using the command:

\q

Exit the user “postgres” using the command:

exit

Now you need to download the Jira installer using the command:

wget https://www.atlassian.com/software/jira/downloads/binary/atlassian-jira-core-8.8.0-x64.bin

Please note that the latest version of Jira can be found on the official Atlassian website https://www.atlassian.com/software/jira/core/download

This guide covers the installation of Jira 8.8.0.

Let’s enable the execution of the file “atlassian-jira-core-8.8.0-x64.bin” with the command:

sudo chmod a+x atlassian-jira-core-8.8.0-x64.bin

Run the Jira installation using the command:

sudo ./atlassian-jira-core-8.8.0-x64.bin

Please note that your team will differ from the one specified in this article since you will install the current version of Jira at the time of reading.

At the first stage, the installer will warn that Jira will be installed on your server.

Press on the “Enter” button.

Next, select “Custom Install (recommended for advanced users)”.

Press on the “Enter” button.

In the next step, you can choose where to install Jira.

This guide describes how to set Jira to “/opt/atlassian/jira”.

Press on the “Enter” button.

Next, you can choose where to store the Jira data.

This tutorial covers setting Jira to “/var/atlassian/application-data/jira”.

Press on the “Enter” button.

Now you can select the ports that Jira will use.

This guide describes how to install Jira using port 8080 for HTTP and port 8005 for Control.

Press on the “Enter” button.

Next, you will be offered the opportunity to install Jira as a service.

Press on the “Enter” button.

Press the “Enter” button to start the installation of Jira.

Jira installation completed successfully.

Please note that you do not need to run Jira.

Specify “n” and press the “Enter” button.

Now you need to make changes to the Jira configuration file by opening it in a text editor using the command:

sudo vim /opt/atlassian/jira/conf/server.xml

Press the “i” button to enter the editing mode, find the section “DEFAULT – Direct connector with no proxy for unproxied HTTP access to Jira” and comment it out by setting <!-- on the line above the section parameters and --> below the section options that you want to comment out.

Next, find the “HTTPS – Proxying Jira via Apache or Nginx over HTTPS” section and uncomment it by removing the <!-- sign on the line above the section parameters and the --> below the section parameters that you want to uncomment.

Then set the parameter “proxyName” to “jira.heyvaldemar.net”.

In this manual, the jira.heyvaldemar.net subdomain will be used to access Jira from the Internet. You will need to specify your domain or subdomain by which your Jira will be available from the Internet.

Now press the “Esc” button to exit the editing mode, and then enter “:x” and press the “Enter” button to save the changes and exit the editor.

Start Jira with the command:

sudo /etc/init.d/jira start

Open the Jira log to verify that Jira starts correctly using the command:

sudo less /opt/atlassian/jira/logs/catalina.out

On the keyboard, press the key combination “Shift” and “f” to start monitoring changes in the Jira log in real-time.

On the keyboard, press the key combination “Ctrl” and “c”, then “q” to close the Jira log.

To continue the process of installing the Jira, you must go from workstation to the link https://jira.heyvaldemar.net, where jira.heyvaldemar.net is the name of my server. Accordingly, you need to specify the name or IP address of your server with the Jira installed.

This guide describes how to install Jira for a production environment.

Select “I’ll set it up myself” and click on the “Next” button.

Now you need to specify the database management system and the previously created database that will be used for Jira.

In the “Database Type” field select “PostgreSQL”.

In this manual, the database for running Jira is on the same server as Jira.

In the “Hostname” field specify “localhost”.

In the “Port” field specify the value “5432”.

In this manual, “jiradb” is used as the database name for Jira.

In the “Database” field specify “jiradb”.

In this manual, “jiradbuser” is used as the user name that has the rights to the database for running Jira.

In the “Username” field specify “jiradbuser”.

In the “Password” field indicate the password assigned to the user “jiradbuser”.

Click on the button “Test connection”.

The message “The database connection test was successful.” means that all data was specified correctly.

Click on the “Next” button.

In the next step, you can specify permissions.

Private – only administrators can register new users in Jira.

Public – anyone can register and create tasks in Jira.

In this manual, Jira will be used for internal organization tasks.

In the “Mode” section, select “Private”.

The “Base URL” field must contain the domain or subdomain by which your Jira is accessible from the Internet.

In this manual, the jira.heyvaldemar.net subdomain will be used to access Jira from the Internet. You will need to specify your domain or subdomain by which your Jira will be available from the Internet.

Click on the “Next” button.

Now you need to specify the license key for Jira.

If you do not already have a license key, you can request a temporary key to familiarize yourself with Jira.

This guide covers the installation of Jira with a temporary license key.

Click on “generate a Jira trial license”.

Next, click on the “Sign up for an account” button if you do not already have an Atlassian account.

The next step is to specify: email address, first name, last name and password to create an Atlassian account.

Click on the “Sign up” button.

Please note that you will receive an email to the email address provided during registration. In the letter, you will find a link to complete the registration.

If you already have an Atlassian account, then enter the email address associated with the Atlassian account in the “Enter email” field and click on the “Continue” button.

Specify the password for the Atlassian account and click on the “Log in” button.

The next step is to indicate which product you need a temporary license key, as well as the name of your organization.

Click on the “Generate License” button to generate a temporary license key for Jira.

Next, you need to confirm that the temporary license key for Jira will be installed on your server.

Click on the “Yes” button.

In the “Your License Key” field, insert the previously received temporary license key and click on the “Next” button.

In the next step, you must specify a name, email address, username and password to create a Jira administrator account.

Click on the “Next” button.

In the next step, you can configure sending notifications.

This guide covers installing Jira without setting up notifications.

Select “Later” and click on the “Finish” button.

Next, select the language in which you plan to use Jira, and click on the “Next” button.

In the next step, you can select an avatar for the previously created Jira administrator account.

Click on the “Next” button.

The next step will be the opportunity to choose from several options: upload a demo project, create a new project or import data from another system.

This guide covers installing Jira without importing any data.

Click on the “Create new project” button.

Select the desired type of project and click on the “Next” button.

The next step will show the workflow (graphical representation of the task flow) for the project.

Click on the “Select” button.

In the “Name” field, indicate the name of the project and click on the “Submit” button.

The project has been successfully created.

Now you can register a new task as part of this project.

In the “New Task” field, indicate a brief description of the task and click on the “Open in dialog” button.

In the “Summary” field specify a brief description of the task.

In the “Reporter” field specify the user who set the task.

In the “Due Date” field, you can specify the deadline for completing the task.

In the “Description” field specify the full description of the task.

In the “Assign” field, you can specify the specialist responsible for the task.

In the “Priority” field, you can specify the priority of the task.

Click on the “Create” button to create the task.

Task successfully created.

Author

Hi, I’m Vladimir Mikhalev, but my friends call me Valdemar. I have a lot of experience in the design and maintenance of various information systems. On my website, you will find detailed and clear guides for setting up IT solutions. Dive into the ocean, full of positive and technology! For cooperation: callvaldemar@gmail.com

Leave a Reply

This site uses Akismet to reduce spam. Learn how your comment data is processed.