Technology Blog

How to Setup JIRA on Ubuntu 15.04


Hi, in today’s article we are going to work on Jira, where we will show you about its installation and configuration process on Ubuntu 15.04 64-Bit Operating system. Before starting its installations let me introduce you about JIRA. Jira is a web based software that is used for bug and issues tracking and projects management developed by Atlassian. It allows you to track any kind of unit of work through a predefined workflow where all of your project items/issues lie at a team wide, company or individual level. Collaboration’s also a big point of emphasis in JIRA about its mentioning, formatted commenting , and sharing issues via email all help make your work more visible to your teams so folks stay on the same page throughout their project, release, or set of tasks.

JIRA Basic Requirements

JIRA can run well on any reasonably fast workstation computer as its memory requirements depend on how many projects and issues you will store, but 300MB – 1GB (of Java heap size) is enough for most evaluation purposes for JIRA Setup.

Jira is a cross platform web based application that runs centrally on a server while the users interact with it through web browsers from any other computer. So on the server side we will need a browser with JavaScripts enabled on it with addition to the JAVA installed on your system.

JAVA Installation

JIRA requires a Java Developers Kit (JDK) or Java Runtime Environment (JRE) platform to be installed on your server’s operating system. But in case of Linux Installer to install JIRA, there is no need to install and configure a separate JDK/JRE since these executable files will install and configure their own JRE to run JIRA.

Database for JIRA

JIRA requires a relational database to store its issue data. JIRA supports most popular relational database servers, so we suggest using the one that you are most comfortable with administering.
We will be using MySQL database in this tutorial. So, if you intend to use JIRA in your production environment, we strongly recommend that you connect JIRA to an enterprise database.

So, in order to create the separate database and user for the Jira, connect to your mysql server or whatever you are using and run the below commands in case you are using MySQL.

mysql> create database jiradb character set utf8;
Query OK, 1 row affected (0.17 sec)

mysql> create user ‘jira’@’localhost’ identified by ‘jira123’;
Query OK, 0 rows affected (0.25 sec)

mysql> GRANT ALL Privileges ON jiradb.* TO ‘jira’@’localhost’ IDENTIFIED by ‘jira123’ with grant option;
Query OK, 0 rows affected (0.17 sec)

mysql> flush privileges;
Query OK, 0 rows affected (0.14 sec)

mysql> quit

Download JIRA Linux Installer

Now we are going to install a new JIRA installation on Linux using the automated ‘Linux Installer’ script. Let’s download the appropriate JIRA ‘Linux 64-bit / 32-bit Installer’ (.bin) file from the JIRA page.

Jira Download

You can also copy the download link and put it on your server using “wget” command given below.

[email protected]:~# wget

jira package

Installing JIRA on Linux Ubuntu

According to the Jira Documentation there are two ways to install JIRA using the Linux Installer, Using the “Console Wizard” or by “Performing Unattended Installation”. So we are going to Use the console wizard and if you are installing JIRA on your server for the first time or you wish to specify your installation options then choose the same.

Let’s execute the recently downloaded Linux Installer with ‘root’ user privileges, the installer will create a dedicated user account for JIRA. To run JIRA as a service, the Linux Installer must be executed with ‘root’ user privileges.

Run the below commands to give the execute permission to the binary script and then execute it within its downloaded directory.

[email protected]:~# chmod +x atlassian-jira-6.4.10-x64.bin

Now you can start the binary script to run the installer.

[email protected]:~# ./atlassian-jira-6.4.10-x64.bin

Unpacking JRE …
Starting Installer …

This will install JIRA 6.4.10 on your computer.
OK [o, Enter], Cancel [c]

Choose the appropriate installation or upgrade option as shown below.

Jira Installer

Open Ports for JIRA

If are working with your firewalld enabled and active then make sure that the ports that you configured for JIRA during the above installation process are open in your firewall.

In ubuntu you can enable and open the JIRA ports by running the below commands.

#sudo ufw enable
#sudo ufw allow 8181
#sudo ufw allow 8005

Starting and Stoping JIRA

If JIRA is not already started, you can start/stop JIRA using the appropriate command at the Linux console as given below.

To stop JIRA
#service jira stop
#/etc/init.d/jira stop

To start JIRA
#service jira start
#/etc/init.d/jira start

JIRA service startup script will be executed as shown below on your terminal.

jira service

JIRA Web Setup

Now you can access JIRA from any computer with network access to your JIRA server by opening a supported web browser on the computer and visiting the below URL, by giving the name or IP address of the computer on which you have installed JIRA and the HTTP port number specified when you installed JIRA.


Choose the method you would like for the Jira setup, whether you want to install it in production or demostration environment and then click to the NEXT button.

Jira web

JIRA Database Setup

Here we need to choose the database setup from the two available options whether to chose the built in database or choose our own. So, we will be going with our own database that we had created on earlier step.

After choosing the MySQL databse, you will be asked to for JIRA requires that you download and install the MySQL driver. You will have to restart JIRA after installing the driver.

MySQL Driver

So, let’s follow the instructions for Connecting JIRA to MySQL as below to install the driver.

Open this link and click on the download button as shown below.

mysql connector

Now upload it to the server and extract the zipped package and place the required .JAR file into the directory where we have intalled JIRA in its lib directory.

mysql connector

Now restart JIRA service and with “/etc/init.d/jira stop/start” command.

Testing JIRA Database

Now refresh your JIRA web setup page choose the database options an click on the “Test Database Connection”, so when you get a message that database connection is successful click on the “NEXT”.

Database Test

Then it will take few minutes while preparing the database for JIRA.

JIRA Application Set Up Properties

Once you database has been setup then we will be directed to the next screen where we have to configure and setup the application properties for JIRA by choosing its Name, Mode and Base URL.

jira propertise

Then moving to the next step we have to choose the type of JIRA according the requirement and purpose you want to use it for. so We’ll install JIRA and JIRA Agile to enable agile software development workflows and task boards.

jira type

Specify Your License Key

We need a license key to set up JIRA. Enter your license key or generate a new license key below. You need an account at to generate a license key. Let’s choose the appropriate option to generate the license key and move to NExt.

jira key

Check your Email and verify that you have mentioned for Jira Key generation.

Setup Admin Account

Then setup your administrator account provided with your username and passowrd.

admin account

Now Finish the installation setup after configuring a connection to an outgoing mail server so that JIRA can send email notifications. You can configure a mail server now or after you have set up JIRA.

Finish Jira Setup

Welcome To JIRA

Greetings! Welcome to JIRA , After you first time login to JIRA you will be guided to use Jira and how you can create your first Project and raise Issues within that project.

Here is the first look of it Dashboard, where you can create new projects or raise your issues.

Jira Dashboard


JIRA can be 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 how to install and use JIRA effectively, then we hope have at the end of this tutorial you are now able to setup JIRA without any problem. If you still find any problem then feel free to contact us right here.