Documentation for JIRA 4.0. Documentation for other versions of JIRA is available too.

Skip to end of metadata
Go to start of metadata
Icon

This Installation Guide applies if you are installing JIRA for the first time. If you are upgrading JIRA, please refer to the Upgrade Guide.

To install JIRA Standalone on Windows, follow these steps:

1. Download and Install JIRA Standalone

  1. Download the JIRA Standalone Windows Installer (.EXE) file from the JIRA Download Center.
  2. Run the .EXE file.
  3. You will be prompted for input (such as the directory in which to install JIRA and the JIRA Home directory).
    Icon

    There are known problems with permissions when installing JIRA on Windows, for example on Windows Vista / Windows 7 the default "C:\Program Files", may require you to have local administrator rights - please see JRA-19683 for a workaround for this and see Install JIRA on Windows Vista for a guide on installing JIRA as a service.

  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.

2. Start JIRA

JIRA will start automatically when the Installer finishes, if you have selected the option to launch JIRA at the end of the Installer wizard.

Note that the Installer will also create the following Windows 'Start' menu shortcuts, 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.

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.

Icon

If JIRA does not appear, you may need to change the port that JIRA runs on.

3. Run the Setup Wizard

See Running the Setup Wizard.

Next Steps

  • See JIRA 101 to start creating Projects, creating Users, and customising your JIRA instance.
  • 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.batfile) every time you restart your computer. NOTE: If you have Administrator rights to your PC, then the Windows Installer may have already done this as part of the installation process
  • 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.