Installing JIRA Standalone

On Windows:

You have two options on Windows:

• Windows Installer (recommended):
  1. Download the JIRA Standalone Windows Installer (.EXE) file here.
  2. Run the .EXE file.
  3. You will be prompted for input (such as the directory in which to install JIRA). Note that installing the JIRA files in certain directories, for example the default "C:\Program Files", may require you to have local administrator rights on your PC.
  4. If you have local administrator rights on your PC, you will be prompted to install JIRA as a service (recommended). You can also do this manually later, as described in Configuring JIRA Standalone to run as a Service.
  5. You may be prompted to choose the port that JIRA runs on. (This will happen if you have already installed JIRA and it is running, or if you have some other existing network service running on JIRA's default ports.) If you are not sure which port number to choose, try new numbers one by one, starting with '8080' and incrementing by one. Keep going until you find an available port number.
• Windows Archive:
  1. Download the JIRA Standalone Windows Archive (.ZIP) file here.
  2. Unzip the downloaded file. Note: do not use Windows XP's built-in UNZIP — it silently fails to extract files with long names (see JRA-2153). Other users have also reported problems using WinRAR. Please use another tool like WinZIP to unpack JIRA.
  3. Extract all the files to 'c:\' or another short path to avoid Windows path size limitations.
  4. If you are installing JIRA 3.2.2 or earlier and use WinZIP version 9, please manually create a temp\ directory in the root directory (alongside bin\, conf\ etc), as WinZIP doesn't extract this (resulting in index errors).

On Mac or UNIX/Linux:

1. Download the JIRA Standalone TAR (.GZ) file here.
2. Unzip the downloaded file (note: Solaris users will need to use GNU tar to handle the long filenames. Do not use the Solaris default tar utility).

• On Windows (Installer), JIRA will start automatically when the Installer finishes. You can also use the Windows 'Start' menu to start and stop JIRA.

• On Windows (Archive), run bin\startup.bat (or if that immediately exits, try bin\catalina.bat run). Note: assuming you unzipped to 'c:', the file is located here: c:\atlassian-jira-enterprise*-X.X.X-standalone\bin\startup.bat (*'enterprise'or 'professional' or 'standard').

  JIRA will be launched in a black ‘Tomcat’ window (do not close this window). Wait until the following message appears:

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

• On Mac OSX, run bin/startup.sh to start JIRA.
• On UNIX/Linux, run bin/startup.sh. Logs will be written to logs/catalina.out.
  Note, you are strongly recommended to create a dedicated user to run JIRA under UNIX/Linux. For further details, please refer to the JIRA Server Requirements section on the Requirements page.

To access JIRA, go to your web browser and type this address: http://localhost:8080.

See Running the Setup Wizard.

• If you are using Windows, you should configure JIRA Standalone to run as a service. NOTE: If you used the Windows Installer (.EXE), and have Administrator rights to your PC, then you may have already done this as part of the installation process. If you used the Windows Archive (.ZIP), note that once you configure JIRA to run as a service, you will start and stop JIRA via the Services control panel in Windows (instead of the method described in "2. Starting JIRA", above), and there will be no black 'Tomcat' window.
• 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.