View Source

To install JIRA Standalone on UNIX/Linux, follow these steps:

Before you begin

Please ensure that you have installed Java and set JAVA_HOME.

Linux note: Linux distributions frequently have an open-source implementation of Java called GCJ installed. Do not use this — it is incomplete and will cause JIRA to fail in obscure ways.

1. Download and Install JIRA Standalone

Download the JIRA Standalone TAR (.GZ) file here.
Unzip the downloaded file.

2. Set JIRA Home

3. Start JIRA

Run bin/startup.sh. Wait until the following message appears in the application's log file:

***************************************************
 You can now access JIRA through your web browser.
***************************************************

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.

Note: Logs will be written to logs/catalina.out.

If something goes wrong, please verify that Java is installed correctly. If the problem persists, please contact us — we're happy to help.

4. Run the Setup Wizard

See Running the Setup Wizard.

Next Steps

If you like to set up JIRA Standalone to start automatically every time you restart your computer, please see Starting JIRA Standalone automatically on Linux.
By default, JIRA Standalone uses the standard Tomcat port (i.e. 8080). If you need another application to run on that port, either now or in the future, please see Changing JIRA Standalone's port.
As part of its installation process, JIRA Standalone automatically installs, configures and connects itself to an HSQLDB database. This is fine for evaluation purposes, however HSQLDB is prone to data corruption. For production installations, we strongly recommend that you connect JIRA to an external database.
To get the most out of JIRA, please see Optimising Performance.