JIRA is now available as three separate applications, JIRA Software, JIRA Service Desk, and JIRA Core. For more information on administering these applications, refer to the Administering JIRA Applications documentation.

Installing JIRA on Windows

If you're upgrading to JIRA 7.0, you should consult the Migration hub. JIRA 7.0 contains functionality that affects your user management, application access and log in permissions, and it's very important that you understand the requirements and the implications before you upgrade. The Migration hub has all this information in one handy space.

This guide describes how to install a new JIRA installation on Windows using the automated 'Windows Installer'. If you are upgrading JIRA, please refer to the Upgrading JIRA guide.

You can also install JIRA from a 'zip' archive — see Installing JIRA from an Archive File on Windows, Linux or Solaris for details. This is useful if you want JIRA to use a pre-existing supported Java platform, since the Windows Installer installs its own JRE to run JIRA.

On this page:

Before you begin

  • We strongly recommend that you install the latest production version available. If you install an older version of JIRA, it may contain security vulnerabilities that were patched or fixed in subsequent versions. If you have to install an older version, check if there are any security advisories that apply to the version.
  • Note, some anti-virus or other Internet security tools may interfere with the JIRA installation process and prevent the process from completing successfully. If you experience or anticipate experiencing such an issue with your anti-virus/Internet security tool, disable this tool first before proceeding with the JIRA installation.

Installing JIRA

There are two ways to install JIRA using the Windows Installer:

Using the Installation Wizard

Use the installation wizard if you are installing JIRA on your server for the first time or you wish to specify your installation options.

If you have previously installed JIRA using the installation wizard and wish to re-install JIRA again with the same installation options, you can re-install JIRA in 'unattended mode' without any user input required (see below for details).

1. Download and Run the JIRA 'Windows Installer'

(tick) To install JIRA as a service, the Windows Installer must be run using a Windows administrator account. While you can run the Windows Installer with a non-administrator account, your installation options will be much more limited.

  1. Download the JIRA 'Windows Installer' (.exe) file from the JIRA Download page.
  2. Run the '.exe' file to start the installation wizard.
    (info) If a Windows 7 (or Vista) 'User Account Control' dialog box requests if you want to allow the installation wizard to make changes to your computer, specify 'Yes'. If you do not, the installation wizard will have restricted access to your operating system and any subsequent installation options will be limited.
  3. At the 'Upgrading JIRA?' step, choose between the 'Express Install' or 'Custom Install' options:
    • Express Install — If you choose this option, JIRA will be installed with default settings which are shown in the next step of the installation wizard. If you want to customize any of these options, click the 'Back' button and choose the 'Custom Install' option instead.
    • Custom Install — If you choose this option, JIRA will prompt you to specify the following options (which are presented during subsequent steps of the installation wizard and pre-populated with default values):
      • The 'Destination Directory' in which to install JIRA.
      • The JIRA Home directory (which must be unique for each JIRA installation).
      • The Windows 'Start' menu folder options.
      • The TCP ports (i.e. an HTTP and a Control port) that JIRA will run through.
      • If you are running the installer using an administrator account, you will be prompted to 'Install JIRA as a service' (recommended). You can also do this manually later, as described in Running JIRA as a Service.
        (tick) If you installed JIRA as a service, you must start JIRA through the Windows 'Start' menu, since JIRA will not start if you run start-jira.bat at the Windows Command Prompt.
  4. The installation wizard will install JIRA onto your operating system and will start JIRA automatically when the wizard finishes. JIRA will also be launched automatically in your browser window if you chose this option.

(info) Please Note:

  • If you chose to install JIRA as a service, the JIRA service will be run as the Windows 'SYSTEM' user account. To change this user account, see Changing the Windows user that the JIRA service uses.
  • If you do not install JIRA as a service, then once started, JIRA will be run as the Windows user account under which JIRA was installed.
  • If you use JIRA running on a Windows Server in production, we strongly recommend creating a dedicated user account (e.g. with username 'jira') for running JIRA.
    • For more information about creating a dedicated user account and defining which directories this account should have write access to, refer to our guidelines.
      (tick) If your Windows Server is operating under a Microsoft Active Directory, ask your Active Directory administrator to create a dedicated user account that you can use to run JIRA (with no prior privileges).
    • If JIRA is installed as a service, do not forget to change the user account that runs the JIRA service to your dedicated user account for running JIRA.

2. Starting JIRA

If JIRA is not already started, you can start JIRA using the appropriate Windows 'Start' menu shortcut or command prompt option.

Once JIRA is started, you can access JIRA from the appropriate Windows 'Start' menu shortcut or a browser on any computer with network access to your JIRA server.

2.1 Windows 'Start' Menu Shortcuts

The Installer will have created the following Windows 'Start' menu shortcuts:

  • Access JIRA — opens a web browser window to access your JIRA application.
    (info) Your JIRA server must have been started for this shortcut to work.
  • Start JIRA Server — starts up the Apache Tomcat application server which runs your JIRA installation, so that you can access JIRA through your web browser.
  • Stop JIRA Server — stops the Apache Tomcat application server which runs your JIRA installation. You will not be able to access JIRA through your web browser after choosing this shortcut.
  • Uninstall JIRAuninstalls JIRA from your Windows operating system.

2.2 Starting and Stopping JIRA from a Command Prompt

Enter the bin subdirectory of your JIRA installation directory and run the appropriate file:

  • start-jira.bat (to start JIRA)
  • stop-jira.bat (to stop JIRA)

(info) If you followed our guidelines for running JIRA with a dedicated user account, then to run JIRA as this user account (e.g. 'jira'), use the runas command to execute start-jira.bat. For example:

  • > runas /env /user:<DOMAIN>\jira start-jira.bat
    (where <DOMAIN> is your Windows domain or computer name.)

2.3 Accessing JIRA from a Browser

You can access JIRA from any computer with network access to your JIRA server by opening a supported web browser on the computer and visiting this URL:

  • http://<computer_name_or_IP_address>:<HTTP_port_number>


  • <computer_name_or_IP_address> is the name or IP address of the computer on which JIRA is installed and
  • <HTTP_port_number> is the HTTP port number specified when you installed JIRA (above).

(info) If JIRA does not appear in your web browser, you may need to change the port that JIRA runs on.

3. Run the Setup Wizard

See Running the Setup Wizard.

4. Next Steps

Performing an Unattended Installation

If you have previously installed JIRA using the installation wizard (above), you can use a configuration file from this JIRA installation (called response.varfile) to re-install 'unattended mode' without any user input required.

Installing JIRA in unattended mode saves you time if your previous JIRA installation was used for testing purposes and you need to install JIRA on multiple server machines based on the same configuration.

(warning) Please Note:

  • The response.varfile file contains the options specified during the installation wizard steps of your previous JIRA installation. Hence, do not uninstall your previous JIRA installation just yet.
  • If you intend to modify the response.varfile file, please ensure all directory paths specified are absolute, for example, sys.installationDir=C\:\‌\Program Files\\Atlassian\‌\JIRA
    Unattended installations will fail if any relative directory paths have been specified in this file.

Download and Run the JIRA 'Windows Installer' in Unattended Mode

  1. Download the JIRA 'Windows Installer' (.exe) file from the JIRA Download Center to a suitable location.
  2. Open the Windows command prompt and perform the remaining steps in the command prompt.
  3. copy the response.varfile file located in the .install4j subdirectory of your previous JIRA installation directory, to the same location as the downloaded 'Windows Installer' file.
    (info) You can uninstall your previous JIRA installation after this step. Save your response.varfile if you need to install JIRA on multiple machines.
  4. Change directory (cd) to the location of the 'Windows Installer' file and run the following command:

    atlassian-jira-X.Y.exe -q -varfile response.varfile


    • X.Y — refers to the version of JIRA you are about to install.
    • -q — instructs the installer to operate in unattended mode (i.e. 'quietly').
    • -varfile response.varfile — specifies the configuration file containing the configuration options used by the installer. The location and name of the configuration file should be specified after the -varfileoption.

  5. JIRA will start automatically when the silent installation finishes. Continue from step 2 Starting JIRA (above).

Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

19 Archived comments

  1. User avatar


    You should mention that having CATALINA_HOME defined in another tomcat installation will make installation a pain.

    14 Aug 2010
    1. User avatar



      Thank you so much for this tip. Just FYI, set your CATALINA_HOME and JAVA_HOME to a single version. I was pointing it to 2 different versions separated by ;

      03 Mar 2011
  2. User avatar


    Yea, I had a similar issue. When I tried to change the .bat file to force the use of the correct CATALINA_HOME it still failed.

    09 Jan 2011
  3. User avatar


    Had some problem launching it with google chorme 10.6.042. It works fine with IE8 tho.

    26 Jan 2011
  4. User avatar


    There is no plugin/installed-plugins folder do i have to create i manually?

    11 Feb 2011
  5. User avatar


    Its worth mentioning that if you want to use a different database then you can use the standalone installer and then before requesting the licence, etc follow the steps to connect to another database.

    *Then* open jira, request the licence, etc.

    11 Mar 2011
    1. User avatar


      I'll try it this afternoon.

      not exactly.

      If u use hsql at first, u can backup ur system, mostly it's automaticly, u can import ur backup file when the licence required.

      It means that the backup file include the licence!

      The licence will be definately required if u don't have backup. Because the page is the first config guide.

      16 Aug 2011
  6. User avatar



    Could someone elaborate on the CATALINA_HOME issue please - have you installed a seperate version of Tomcat or have you pointed CATALINA_HOME to C:\Program Files\Atlassian\JIRA\bin (which contains tomcat6.exe)?


    10 Apr 2013
  7. User avatar


    Yeah it doesn't work for me either. I have multiple instances of Tomcat installed and a CATALINA_HOME env var set. Trial is gone well so far!

    30 Apr 2013
    1. User avatar

      Andrew Lui [Atlassian Technical Writer]


      We are not aware of any known issues regarding this. Can I ask you to raise a support request at https://support.atlassian.com? We will be able to better diagnose what is going wrong and help you resolve it.

      Kind Regards,

      30 Apr 2013
  8. User avatar


    Line 11 of "startup_bundled_jre.bat" checks for the existance of a CATALINA_HOME variable, and if it finds it, tells the rest of the script to use it.  On my system, at least, it kept launching my existing Tomcat installation which has no knowledge of Jira.

    Fix is to simply rem (#) line 11 of that file and then launch... went straight into the startup for me.

    12 Aug 2013
  9. User avatar


    Thanks... commenting line 11 helped starting it up.

    27 Sep 2013
  10. User avatar

    Fahmi Hachicha

    For the same issue, I have deleted all CATALINA variables CATALINA_HOME, CATALINA_BASE and CATALINA_OPTS. 


    It works now !


    28 Feb 2014
  11. User avatar

    David Turner

    Most non-trivial JIRA instance upgrades would require some manual copying of custom files back into JIRA and JIRA_HOME directories along with correct configuration of the service run-as-user and various java properties (proxy, ldap, email, plugin-timeout, scriptrunner root, etc).

    Can you please make comment on whether it is possible to NOT automatically start the Jira service at the end of installation so that these manual activities can be completed? E.g. please provide a full list of the command-line options for the installer?

    EDIT: It appears to use install4j (options here), and some options can be found by providing '-help' on the command line, but there is no obvious flag to prevent the service from executing after installation?

    EDIT: Either the --install-demand option might do it, or perhaps -Vapp.install.service$Boolean=false, if you could please confirm?

    30 Jun 2014
  12. User avatar

    Allister Farn

    I installed JIRA as a test installation on a workstation. At some stage in the process JIRA stopped allowing me to login (I believe it was after I tried to connect Confluence). I then wanted to trial setting it up with MySql, so I uninstalled Confluence and uninstalled Jira. I've now installed MySql, and reinstalled Jira. When I first access Jira, it appears as if it has already been set up - i.e. the setup wizard does not run again, and it prompts me for login straight away. However I'm still unable to login.


    What do I need to delete/reconfigure between uninstalling and reinstalling JIRA so that it's treated as a new instance and I'm able to run the setup wizard again?

    06 Feb 2015
    1. User avatar


      del <jira-home>/dbconfig.xml

      06 Feb 2015
      1. User avatar

        Allister Farn

        And on windows? (Sorry, I should have specified that...)

        06 Feb 2015
        1. User avatar

          Allister Farn

          ok - I'm sure I'd carried out a folder search and not found it. I've now found it. 


          On windows, with a default install, it's at c:\Program Files\Atlassian\Application Data\Jirs\dbconfig.xml

          06 Feb 2015
  13. User avatar


    How come every time i update it bombs out spectacularly and i have to spend the day fixing a failed installation, its really starting to get on my nerves. 6.4 upgrade doesn't install the JIRA windows service, 

    18 Mar 2015
Powered by Confluence and Scroll Viewport