We are the Dev Teams of
  • brands
  • ebay_main
  • ebay
  • mobile

How to Set Up a Local Jira Server on a Mac

by Patrick Hund
in Tutorials

I wanted to write a plug-in for Jira to measure our team's cycle times and lead times. To do that, I needed a Jira server running locally on my machine, which happens to be a Mac (OS X 10.8.3).

I followed this how-to from Atlassian:

I downloaded Jira 4.4 (the version mobile.de uses) from here:

I untarred the file in /opt and created a symlink named jira, so I can easily access the Jira installation directory like so: cd /opt/jira.

To adjust the settings for the new local Jira installation:

  1. Edit this file: /opt/jira//atlassian-jira/WEB-INF/classes/jira-application.properties.
  2. Set the jira.home property to match the location of your Jira home directory. (Note: this is NOT the installation folder — I put mine under ~/jira-home.)
  3. Start Jira (the standalone Tomcat server) from the Jira installation folder: ./bin/startup.sh.
  4. Create a new database "jira" on your local MySQL server (as a developer, you probably already have one running locally, don't you?) I used UTF-8 encoding.

Go to: http://localhost:8080.

Set up the database as shown below:


I chose US English as language.


If your company has a Jira license, you system admins should be able to give you a developer license key, it comes at no extra cost. I generated an evaluation key for starters.

I disabled email notification for now, can't be bothered with setting up a local email server :-)


Setting Port to 8082

I usually have a local Tomcat running on port 8080 to test the webapp I'm working on, and a local Jenkins runnting on port 8081 for building and deploying, so I want Jira to run on another post, such as 8082.

I found these instructions on how to change Jira's port: https://confluence.atlassian.com/display/JIRA/Changing+JIRA%27s+TCP+Ports.

Edit /opt/jira/conf/server.xml.


Restart the Jira Tomcat server after editing and saving.

You're done!

jira, server, mac