In this guide we’ll run you through installing a Jira application in a production environment, with an external database, using the Windows installer.
This is the most straightforward way to get your production site up and running on a Windows server.
Other ways to install Jira:
Evaluation — get your free trial up and running in no time.
Zip – install Jira manually from a zip file.
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?
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 or mac OS.
The Jira installer includes Java (JRE) and Tomcat, so you don’t need to install these seperately.
Do you want to run Jira as a Windows Service?
Running Jira as a service in Windows means that your Jira application will automatically start up when Windows is started.
If you choose to run Jira as a service:
You must run the installer as administrator to be able to install Jira as a service.
The Jira service will be run as the Windows ‘SYSTEM’ user account.
We strongly recommend creating a dedicated user account (e.g. with username ‘jira’) on Windows for running Jira.
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.
Jira will need to be restarted manually if your server is restarted.
Is your database set up and ready to use?
Good to know:
Set up your database before you begin. Step-by-step guides for all supported databases are available in Connecting Jira applications to a database.
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?
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 licenseJira
Install a Jira application
1. Download Jira
Download the installer for your operating system:
2. Run the installer
Run the installer. We recommend using a Windows administrator account.
Follow the prompts to install Jira. You’ll be asked for the following info:
Destination directory – this is where Jira will be installed.
Home directory – this is where Jira data like logs, search indexes and files will be stored.
TCP ports – these are the HTTP connector port and control port Jira will run on. Stick with the default unless you’re running another application on the same port.
Install as service – this option is only available if you ran the installer as administrator.
Jira will start up in your browser once installation is complete.
Set up your Jira application
3. Choose set up method
4. Connect to your database
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.
Choose My own database.
Choose your database type then enter the details for your database.
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 extract the appropriate database JDBC drivers. See Supported platforms to get the right version.
Drop the JAR file into your /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.
5. Set application properties
Give your Jira site a name.
Choose whether your site should be private or anyone can sign up. You can change this later.
Enter your base URL — this is the address people will use to access your Jira site.
6. Enter your license
7. Create your administrator account
Enter details for the administrator account. You can add more administrators after set up is complete.
8. Set up email notifications
Enter details of your mail server. This will allow Jira to send notifications when issues change.
9. Start using Jira
Here’s a few things that will help you get your team up and running:
Add and invite users to get your team on board, or configure user directories for slightly bigger teams.
Create your first project to have something to work on.
Configure SSL or HTTPS to keep Jira and your team more secure.
Troubleshooting
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.
Administering Jira applications Support
Products
Jira Software
Project and issue tracking
Jira Service Management
Service management and customer support
Jira Core
Manage any business project
Confluence
Bitbucket
Git code management
Resources
Documentation
Usage and admin help
Community
Answers, support, and inspiration
Suggestions and bugs
Feature suggestions and bug reports
Marketplace
Billing and licensing
Frequently asked questions
Viewport
Confluence
Versions
Installing Jira applications on Windows
Installing Jira applications
On this page
In this section
Related content
Still need help?
The Atlassian Community is here for you.
In this guide we’ll run you through installing a Jira application in a production environment, with an external database, using the Windows installer.
This is the most straightforward way to get your production site up and running on a Windows server.
Other ways to install Jira:
Evaluation — get your free trial up and running in no time.
Zip – install Jira manually from a zip file.
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?
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 or mac OS.
The Jira installer includes Java (JRE) and Tomcat, so you don’t need to install these seperately.
Do you want to run Jira as a Windows Service?
Running Jira as a service in Windows means that your Jira application will automatically start up when Windows is started.
If you choose to run Jira as a service:
You must run the installer as administrator to be able to install Jira as a service.
The Jira service will be run as the Windows ‘SYSTEM’ user account.
We strongly recommend creating a dedicated user account (e.g. with username ‘jira’) on Windows for running Jira.
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.
Jira will need to be restarted manually if your server is restarted.
Is your database set up and ready to use?
Good to know:
Set up your database before you begin. Step-by-step guides for all supported databases are available in Connecting Jira applications to a database.
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?
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 licenseJira
Install a Jira application
1. Download Jira
Download the installer for your operating system:
2. Run the installer
Run the installer. We recommend using a Windows administrator account.
Follow the prompts to install Jira. You’ll be asked for the following info:
Destination directory – this is where Jira will be installed.
Home directory – this is where Jira data like logs, search indexes and files will be stored.
TCP ports – these are the HTTP connector port and control port Jira will run on. Stick with the default unless you’re running another application on the same port.
Install as service – this option is only available if you ran the installer as administrator.
Jira will start up in your browser once installation is complete.
Set up your Jira application
3. Choose set up method
4. Connect to your database
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.
Choose My own database.
Choose your database type then enter the details for your database.
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 extract the appropriate database JDBC drivers. See Supported platforms to get the right version.
Drop the JAR file into your /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.
5. Set application properties
Give your Jira site a name.
Choose whether your site should be private or anyone can sign up. You can change this later.
Enter your base URL — this is the address people will use to access your Jira site.
6. Enter your license
7. Create your administrator account
Enter details for the administrator account. You can add more administrators after set up is complete.
8. Set up email notifications
Enter details of your mail server. This will allow Jira to send notifications when issues change.
9. Start using Jira
Here’s a few things that will help you get your team up and running:
Add and invite users to get your team on board, or configure user directories for slightly bigger teams.
Create your first project to have something to work on.
Configure SSL or HTTPS to keep Jira and your team more secure.
Troubleshooting
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.
