How to Install JIRA on Ubuntu Linux

install jira ubuntu linux

Developed by Atlassian, JIRA is a proprietary and comprehensive software tool mainly used for project management, issue tracking, and bug fixing. JIRA comes with an intuitive dashboard that helps you track issues.

These issues could be software defects or bugs, new features or requirements to mention just a few. It also ships with workflows that enable you to track work progress and pinpoint where a problem is.

In this tutorial, you will learn how to install JIRA on Ubuntu Linux.

Jira linux Installation Prerequisites

Before we get started with  the installation, ensure you have the following:

  1. An instance of Ubuntu 18.04 / Debian 10
  2. Have MySQL database installed on your instance. JIRA requires a database to install all the files so MySQL will come in handy.

Let's now dive in and get along with the installation.

Step 1: Create a database for JIRA

JIRA software requires a database for its installation, therefore the first step will be to create a database in the MySQL database engine.

Login to MySQL as a root user

# mysql -u root -p

Create a database for JIRA

CREATE DATABASE jira_db;

Next, create a user for JIRA

CREATE USER 'jira_user'@'localhost' IDENTIFIED BY 'Your_Password';

Grant all privileges to the JIRA user in order to access the JIRA  database.

GRANT ALL PRIVILEGES ON jira_db.* TO 'jira_user'@'localhost' IDENTIFIED by 'Your_Password';

To wrap it up flush the privileges

FLUSH PRIVILEGES;

 Create database for JIRA

Step 2: Download JIRA &  assign necessary permissions

Having created the database for JIRA, our next step will be to download JIRA's binary file.  Download the file using the wget command as shown.

# wget https://www.atlassian.com/software/jira/downloads/binary/atlassian-jira-software-7.8.2-x64.bin

 Download Atlassian JIRA

Next, assign execute permissions to the binary file

# chmod a+x atlassian-jira-software-7.8.2-x64.bin

WIth execute permissions assigned, run the binary file:

./ atlassian-jira-software-7.8.2-x64.bin

When running the binary file you will be prompted to answer a couple of questions as highlighted below.

Ensure you make the selections as highlighted below.

Install JIRA on Ubuntu 18.04

Install JIRA on Ubuntu 18.04

If the installation goes well as expected, you will get the output highlighted in. You can proceed and access JIRA on the web interface via port 8080. But first, let's open some ports on the UFW firewall to give access to external users to access JIRA.

Step 3: Open JIRA ports

To successfully access and configure JIRA on the web console, we need to open a few ports on the UFW firewall that will enable us to access JIRA.

If UFW is not installed on your system, run the command

# apt install ufw

Install ufw firewall on Debian

Now, you can proceed and open ports 8080, 8181 and 8005

# ufw allow 8181

# ufw allow 8005

# ufw allow 8080

Then enable the firewall for the  rules to come into effect

# ufw enable

open JIRA ports

To confirm that the rules exist. run the command:

# ufw status

Check ufw status

Step 4: Accessing JIRA

All is now set to access JIRA and proceed with the web setup. Fire up  your browser and browse your server's IP as shown:

http://server-IP:8080

The first page presents two options as shown. Click on 'I'll set it up myself' and click on the 'Next' button.

Install JIRA on Ubuntu 18.04

On the next Window, click on 'My own database'  and for the Database type value, click and select 'MySQL'.  You will get a notification that JIRA requires you to download a MySQL driver and thereafter restart JIRA after installing it.

Select own database

To download the MySQL driver, use the wget command to download it from MySQL's official site.

wget https://dev.mysql.com/get/archives/mysql-connector-java-5.1/mysql-connector-java-5.1.36.zip

 Download mysql-connector

Once downloaded, unzip the zipped file

# unzip mysql-connector-java-5.1.36.zip

Next, navigate into the  mysql-connector-java directory and copy the jar file to the path /opt/atlassian/jira/lib

# cp mysql-connector-java-5.1.36-bin.jar  /opt/atlassian/jira/lib

 copy the mysql-connector jar file

Next, restart JIRA using the commands:

#  /etc/init.d/jira stop

# /etc/init.d/jira start

Now head back to your browser and fill out all the details and click on 'Test connection' button at the bottom.

The notification below is a confirmation that the test was successful.

database connection successful

Click  Next and fill out the 'Application title', 'Mode' and click the  'Next' button.

install JIRA on Ubuntu 18.04

Next, you will be required to enter the license key of JIRA. Click on the link as shown which will redirect you to Atlassian site from where you will be able to generate the license key.

Specify-License-Key

Follow the instructions to generate the key and paste the key in the text field and click 'Next'.

install JIRA on Ubuntu 18.04

In the next Window, set up the Administrators account as shown and click 'Next'.

Set-up-admin-account

Choose whether to set up email notification or not and click the 'Finish' button.

install JIRA on Ubuntu 18.04

Finally, the wizard will prompt you to select your language. Do so and click Next.

install JIRA on Ubuntu 18.04

And voila!  there goes the JIRA dashboard!

install JIRA on Ubuntu 18.04

Conclusion

JIRA can be a great source of information, or to know the status of the running project. As the whole team working on it, and would agree on the points mention in it. It keeps on giving reminders or updating with the running state of the project. So if you are new to JIRA and are working in Software Development or Testing and not aware of how to install and use JIRA effectively, then we hope have at the end of this tutorial you are now able to install JIRA without any problem. If you still find any problem then feel free to contact us right here.

Winnie Ondara 4:50 am

Comments

Your email address will not be published. Required fields are marked *

9 Comments

  1. Hello,
    thank you for the detailed guide on installation, I have followed everything according to the guide but i am unble to access via the localhost IP, it keeps coming up with page not found. any advise please?

    1. Hi Wale,

      You can try telnet to localhost with the port number to see if it is connecting. If its not connecting check firewall

  2. This was very helpful! I did get this up and running, but my PuTTY timed out the connection while Jira was running and now whenever I try to connect to it with PuTTY, I keep getting this error: "Network error: Connection timed out". Do you have any idea of how I can connect again?

  3. Hello,
    Thank you for detail explanation. I also have followed everything according to the guide but while set up application properties I had an error like this. I input my own application title "MY JIRA" and chose mode in radio box "private" and set url "http://localhost:8080".
    The error is discribed like this. "com.atlassian.jira.exception.DataAccessException: org.ofbiz.core.entity.GenericDataSourceException: SQL Exception while executing the following:SELECT ID, delaytime, CLAZZ, servicename, CRON_EXPRESSION FROM serviceconfig WHERE servicename=? (Illegal mix of collations (latin1_swedish_ci,IMPLICIT) and (utf8_general_ci,COERCIBLE) for operation ".

    How can I solve it ?

    Thank you.

  4. Hi Winnie,
    thank you for your excellent tutorial. I managed to install and setup Jira on our Ubuntu-Server with ease, I just used some newer versions (jira > atlassian-jira-software-8.5.4-x64.bin & mysql connector > mysql-connector-java-5.1.49.zip).
    Many greetings!
    Björn