How to Set Up a Local Jira Server on a Mac
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:
- Edit this file: /opt/jira//atlassian-jira/WEB-INF/classes/jira-application.properties.
- 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.)
- Start Jira (the standalone Tomcat server) from the Jira installation folder: ./bin/startup.sh.
- 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.
Restart the Jira Tomcat server after editing and saving.