Installing JIRA applications on Windows from Zip File

In this guide we'll run you through installing a JIRA application in a production environment, with an external database, manually using a zip file.

This method gives you the most control of the installation process.
 

Other ways to install JIRA: 

  • Evaluation - get your free trial up and running in no time.
  • Installer – install JIRA using the Windows installer. 
  • Linux – install JIRA on a Linux operating system.

On this page:

Before you begin

Before you install JIRA, there's a few questions you need to answer. 

 

Are you using a supported operating system and Java version?
  Tell me more about this...

Check the Supported platforms page for the version of JIRA you are installing. This will give you info on supported operating systems, databases and browsers.

Good to know:

  • We don't support installing JIRA on OSX.
  • We don't support OpenJDK. You'll need to install the Oracle Java JRE or JDK.
  • You can use either the JDK (Java Development Kit) or JRE (Java Runtime Environment).
  • We only support the version of Apache Tomcat that is bundled with JIRA.
Do you want to run JIRA as a Windows Service?
  Tell me more about this...

Running JIRA as a service in Windows means that your JIRA application will automatically start up when Windows is started.

You should use the Windows installer if you want to run JIRA as a Service.

If you choose not to run JIRA as a service:

  • You will start and stop JIRA by running the start-jira.bat file in your JIRA installation directory.
  • JIRA will be run as the Windows user account that was used to install JIRA, or you can choose to run as a dedicated user (this user must have full read and write access to the installation directory and home directory).
  • JIRA will need to be restarted manually if your server is restarted.
What database do you plan to use? 
  Tell me more about this...

To run JIRA in production you'll need an external database. Check the  Supported platforms page for the version you're installing for the list of databases we currently support. If you don't already have a database, PostgreSQL is free, easy to set up and has been extensively tested with JIRA.

Good to know:

  • Set up your database before you begin. Step-by-step guides are available for PostgreSQLOracleMySQL, and SQL Server.
  • Use UTF-8 character encoding.
  • If you're using Oracle or MySQL you'll need to download the driver for your database.
  • The embedded H2 database can be used for evaluating JIRA, but you'll need to migrate to another database before running in production. You may find it easier to use external database from the start.

Do you have a JIRA license?

  Tell me more about this...

You'll need a valid JIRA Software Server, JIRA Core Server or JIRA Service Desk Server license to use JIRA.

Good to know:

  • If you have not yet purchased a JIRA application license you'll be able to create an evaluation license during setup.
  • If you already have a license key you'll be prompted to log in to my.atlassian.com to retrieve it, or you can enter the key manually during setup.
  • If you're migrating from JIRA Cloud, you'll need a new license.

Is your JAVA_HOME variable set correctly?
  Tell me more about this...

Before you install JIRA, check that you're running a supported Java version and that the JAVA_HOME environment variable is set correctly.

JIRA applications can only run with Oracle JDK or JRE.

To check the JAVA_HOME variable:

Open a command prompt and type echo %JAVA_HOME% and hit Enter. 

  • If you see a path to your Java installation directory, the JAVA_Home environment variable has been set correctly.
  • If nothing is displayed, or only %JAVA_HOME% is returned, you'll need to set the JAVA_HOME environment variable manually.

Install a JIRA application

1. Download JIRA

Download the zip file for your operating system – https://www.atlassian.com/software/jira/download

2. Create the installation directory

  1. Create your installation directory (with full control permission) – this is where JIRA will be installed. Avoid using spaces or special characters in the path. We'll refer to this directory as your <installation-directory>

  2. Extract the JIRA zip file to your <installation-directory>. We recommend using 7zip or Winzip.

3. Create the home directory

  1. Create your home directory (with full control permission) – this is where JIRA data like logs, search indexes and files will be stored. This should be seperate to your installation directory. We'll refer to this directory as your <home-directory>
  2. Tell JIRA where to find your <home-directory> when it starts up.  There are two ways to do this:

      Edit the jira-application.properties file...

    Edit <installation-directory>\atlassian-jira\WEB-INF\classes\jira-application.properties file in any text editor.

    After jira.home add the absolute path to your home directory. You will need to escape the backslashes, for example:

    jira.home=X:\\path\\to\\jira-home

    If you define an UNC path you will need to double escape the leading backslash, for example:

    jira.home=\\\\machinename\\path\\to\\jira-home

      

      Set an environment variable...

    You can set an environment variable named JIRA_HOME in your operating system with the absolute path to your <home-directory>.

    Open Command Prompt and execute the following:

    set JIRA_HOME=X:\path\to\jira-home

    where x is the drive where you created your <home-directory>.

    You can then specify the command above in a script used to start JIRA.

4. Check the ports

By default JIRA listens on port 8080. If you have another application running on your server that uses the same ports, you'll need to tell JIRA to use a different port. 
 

  Show me how to do this...

To change the ports:

  1. Edit <installation-directory>\conf\server.xml

  2. Change the Server port (8005) and the Connector port (8080) to free ports on your server.

    In the example below we've changed the Server port to 5005 and the Connector port to 5050.

    <Server port="5005" shutdown="SHUTDOWN">
    ...
       <Service name="Catalina">
          <Connector port="5050"
             maxThreads="150"
             minSpareThreads="25"
             connectionTimeout="20000"
             enableLookups="false"
             maxHttpHeaderSize="8192"
             protocol="HTTP/1.1"
             useBodyEncodingForURI="true"
             redirectPort="8443"
             acceptCount="100"
             disableUploadTimeout="true"/>

 

5. Start JIRA

  1. Run <installation-directory>/start-jira.bat to start the install process.  
     
    A command prompt will open. Closing this window will stop JIRA.
     
  2. Go to  http://localhost:8080/ to launch JIRA in your browser (change the port if you've updated the Connector port).
      
  Trouble starting JIRA?
  • If the command prompt window closes immediately, your JAVA_HOME variable may not be set correctly.

 

Set up your JIRA application

6. Choose set up method

Choose  I'll set it up myself.

7. Connect to your database

  1. If you've not already done so, it's time to create your database. See the 'Before you begin' section of this page for details. 
  2. Choose My own database
  3. Choose your database type then enter the details for your database. 
      

      Show me how to do this...

    JIRA connects to your database using a standard JDBC database connection. Connection pooling is handled within JIRA, you can change this using JIRA configuration tool later.

    If you're using Oracle or MySQL there's an extra step: 

    • Download and and extract the appropriate Database JDBC Drivers.
    • Drop the JAR file into your <confluence-installation>/lib folder before continuing with the setup wizard.

    In the setup wizard:

    • Driver Class Name – the Java class name for your database driver. If you're not sure, check the documentation for your database.
    • Database URL – the JDBC URL for your database. If you're not sure, check the documentation for your database.
    • Username and Password – A valid username and password that JIRA can use to access your database.

8. Set application properties

  1. Give your JIRA site a name.
  2. Choose wether your site should is private or if anyone can sign up. You can change this later. 
  3. Enter your base URL - this is the address people will use to access your JIRA site. 

9. Enter your license

Follow the prompts to log in to  my.atlassian.com to retrieve your license, or enter a license key.

10. Create your administrator account

Enter details for the administrator account.  You can add more administrators after set up is complete.

11. Set up email notifications

Enter details of your mail server.  This will allow JIRA to send notifications when issues change.

12. Start using JIRA

That's it! Your JIRA site is accessible from your base URL or a URL like this: http://<computer_name_or_IP_address>:<port>

Here's a few things that will help you get your team up and running:

Troubleshooting

  Running into problems installing JIRA?
  • If your web browser window shows an error the first time you try to access JIRA, wait for 30 seconds or so and then refresh the page.
  • If the command prompt window closes immediately, your JAVA_HOME variable may not be set correctly.

 Head to Installation Troubleshooting in our Knowledge Base for more help.  

Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

Have a question about this article?

See questions about this article

Powered by Confluence and Scroll Viewport