Documentation for JIRA 4.2. Documentation for other versions of JIRA is available too.
To install JIRA Standalone on Mac OS, follow these steps:
Please ensure that you have set JAVA_HOME. (You don't need to install Java as it comes with Mac OS.)
Before you begin, you may want to watch the installation video.
jira-application.properties
file (see the JIRA Installation Directory page to find where this file is located), add a 'jira.home' property and set it to your desired location for the JIRA home directory.Please note that you cannot use the same JIRA home directory for multiple instances of JIRA. We recommend that you do not specify your JIRA home directory to be inside your installation directory, to prevent information from being accidentally lost during major operations (e.g. backing up and restoring instances).
$ sudo /usr/sbin/useradd --create-home --home-dir /usr/local/jira --shell /bin/bash jira
Ensure that only the following directories can be written to by Tomcat:
See also Tomcat security best practices
Run bin/startup.sh
to start JIRA.
JIRA will be launched in a black 'Tomcat' window (do not close this window). Wait until the startup messages have finished.
To access JIRA, go to your web browser and type this address: http://localhost:8080.
If JIRA does not appear, you may need to change the port that JIRA runs on.
If something goes wrong, please verify that Java is installed correctly. If the problem persists, please contact us — we're happy to help.