In this guide we'll run you through installing aJiraapplication 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 Jirausing the Windows installer.
- Linux– install Jiraon 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:
|
Are you using a 32-bit operating system? | Tell me more about this... If you’re installing Jira on a 32-bit system, you need to decrease the maximum heap size available to Jira. The default for 64-bit systems is 2GB, which is too much for a 32-bit system, and may not fit into the available memory. Complete these steps after extracting files from the archive, but before starting Jira. Step 1: Rename the default setenv file.
Step 2: Add the properties to the jira-config.properties file.
|
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:
|
What database do you plan to use? | Tell me more about this... To run Jirain production you'll need an external database. Check theSupported platformspage 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:
|
Do you have a Jira license? | Tell me more about this... You'll need a valid Data Center license for Jira Software, Jira Core, or Jira Service Management to use Jira. Good to know:
|
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 Jira applications can run with OpenJDK, Oracle JDK or JRE. To check the JAVA_HOME variable: Open a command prompt and type
|
Install a Jiraapplication
1.DownloadJira
Download the zip file for your operating system:
- Jira Core athttps://www.atlassian.com/software/jira/core/download
- Jira Software athttps://www.atlassian.com/software/jira/download
- Jira Service Managementathttps://www.atlassian.com/software/jira/service-desk/download
2. Create the installation directory
Create your installation directory (with full control permission) –this is where Jirawill be installed. Avoid using spaces or special characters in the path. We'll refer to this directory as your
<installation-directory>
.- Extract the Jirazip file to your
<installation-directory>
.We recommend using7ziporWinzip.
3. Create the home directory
- Create your home directory (with full control permission) –this is where Jiradata 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>
. Tell Jirawhere to find your
<home-directory>
when it starts up. There are two ways to do this:(Preferred) 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.
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
4. Check the ports
By default Jiralistens on port8080
. If you have another application running on your server that uses the same ports, you'll need to tell Jirato use a different port.
To change the ports:
Edit
<installation-directory>\conf\server.xml
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. StartJira
- Run
<installation-directory>/bin/start-jira.bat
to start the install process.
A command prompt will open. Closing this window will stop Jira. - Go to
http://localhost:8080/
to launch Jirain your browser (change the port if you've updated the Connector port).
- If the command prompt window closes immediately, your JAVA_HOME variable may not be set correctly.
Set up your Jiraapplication
6. Choose set up method
ChooseI'll set it up myself.
7. 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.
- ChooseMy own database.
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 extract the appropriate database JDBC drivers. See Supported platforms to get the right version.
- Drop the JAR file into your
<jira-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.
- UsernameandPassword– A valid username and password that JIRA can use to access your database.
8. Set application properties
- Give your Jirasite 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 Jirasite.
9. Enter your license
Follow the prompts to log in tomy.atlassian.comto 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 Jirato send notifications when issues change.
12. Start usingJira
That's it!Your Jirasite 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:
- Add and invite usersto get your team on board, or configure user directories for slightly bigger teams.
- Create your first projectto have something to work on.
- Configure SSL or HTTPS to keep Jiraand your team more secure.
Troubleshooting
- 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.