Documentation for JIRA 4.4. Documentation for other versions of JIRA is available too.
JIRA running on Mac OS X should only be used for evaluation purposes!
Mac OS X is not a supported operating system for the JIRA server because Oracle JDK and JRE (formerly Sun JDK and JRE), which are the only supported Java platforms for JIRA, are not available for this operating system. Mac OS X is packaged with a JDK optimised for its hardware.
Please note:
To install JIRA Standalone on Mac OS X, follow these steps:
Please ensure that you have set JAVA_HOME. (You don't need to install Java as it comes with Mac OS X.)
To specify the location of your JIRA Home Directory:
jira-application.properties
file and set the value of the 'jira.home
' property to the desired location for your JIRA Home Directory.JIRA_HOME
in your operating system whose value is the location of your JIRA Home Directory. To do this, do one of the following:
export JIRA_HOME=/path/to/jira/home
Please note that you cannot use the same JIRA home directory for multiple instances of JIRA. We recommend locating your JIRA Home Directory completely independently of the JIRA Installation Directory (i.e. not nesting one within the other) as this will minimise information being lost during major operations (e.g. backing up and restoring instances).
$ sudo /usr/sbin/useradd --create-home --comment "Account for running JIRA" --shell /bin/bash jira
> net user jira mypassword /add /comment:"Account for running JIRA"
Ensure that only the following directories can be written to by this dedicated user account (e.g. 'jira'):
logs
temp
work
Do not make the JIRA Installation Directory itself writeable by the dedicated user account.
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.