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, if you have selected the option to launch JIRA at the end of the Installer wizard. Once JIRA has been installed, the following Windows 'Start' menu shortcuts will also be added which you can also use to start and stop JIRA:
  
  • 'Access JIRA' — this shortcut opens a web browser window to access your JIRA application (via http://localhost:8080). Please note that your JIRA server must be running to access the JIRA application via your browser.
  • 'Start JIRA Server — this shortcut starts the JIRA instance on your application server, so that you can access it with your browser.
  • 'Stop JIRA Server' — this shortcut stops the JIRA instance on your application server. You will not be able to access the JIRA application via your browser, if a JIRA instance is not running on your application server.

• 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. Alternatively, you can use the 'Access JIRA' shortcut in the 'Start' menu if you are using Windows.

See Running the Setup Wizard.

• If you are using Windows, we highly recommend that you configure JIRA Standalone to run as a service. If you do not do this, you will need to start the JIRA server manually (via the 'Start' menu shortcut or using the bin\startup.bat file) every time you restart your computer. NOTE: If you used the WindowsInstaller (.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.