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 until recently no supported Oracle JDK and JRE (formerly Sun JDK and JRE) was available for this operating system. It is our view that the cost of supporting JIRA on OS X would be better spent fixing bugs and developing other requested features.

Please note:

  • If you encounter problems with your JIRA server running on Mac OS X, they may not be fixed as we do not test JIRA with unsupported Java platforms.
  • However, JIRA users can still access your JIRA server through a supported browser on Mac OS X.

To install JIRA on Mac OS X, follow these steps:

Before you begin

Please ensure that you have installed a supported version of Java (see Supported Platforms) and set the JAVA_HOME

1. Download and Install JIRA

  1. Download the JIRA tar.gz file here.
  2. Unzip the downloaded file.

2. Set JIRA Home

To specify the location of your JIRA Home Directory:

3. Create a Dedicated User Account on the Operating System to Run JIRA

4. Start JIRA

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.

5. Run the Setup Wizard

See Running the Setup Wizard.

Next Steps