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:
- An instance of Ubuntu 18.04 / Debian 10
- 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;
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
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.
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
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
To confirm that the rules exist. run the command:
# 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.
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.
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
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
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.
Click Next and fill out the 'Application title', 'Mode' and click the 'Next' button.
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.
Follow the instructions to generate the key and paste the key in the text field and click 'Next'.
In the next Window, set up the Administrators account as shown and click 'Next'.
Choose whether to set up email notification or not and click the 'Finish' button.
Finally, the wizard will prompt you to select your language. Do so and click Next.
And voila! there goes the JIRA dashboard!
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.
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?
Hi Wale,
You can try telnet to localhost with the port number to see if it is connecting. If its not connecting check firewall
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?
Hi Sam,
Do you have console access.. check the firewall rules
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.
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
Thanks for the nice feedback Bjoern. It's our pleasure that the article was beneficial to you.
Could not create a connection to database server MYSQL 8.0. Refer jira supported platforms. JIRA requires a database to install all the files so MySQL will come in handy.
Hello,
Thank you very much! It was very useful.