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, it is possible that any anti-virus or other Internet security tools installed on your Linux operating system 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 Linux Installer:

Using the Console Wizard

1. Download and Install the JIRA 'Linux Installer'

1. Download the appropriate JIRA 'Linux 64-bit / 32-bit Installer' (.bin) file from the JIRA Download page. Please Note:
   • To access the 32-bit installer, you may need to click the 'Show all' link on the 'JIRA Download' page to access the other installation packages.
   • The difference between the 64-bit / 32-bit .bin installers relates to their bundled Java platforms that run JIRA. Bear in mind that a JIRA installation installed using the 64-bit installer may require additional memory (to run at a similar level of performance) to a JIRA installation installed using the 32-bit installer. This is because a 64-bit Java platform's object references are twice the size as those for a 32-bit Java platform.
2. Open a Linux console and change directory (cd) to the '.bin' file's directory. If the '.bin' file is not executable after downloading it, make it executable, for example: chmod a+x atlassian-jira-X.Y.bin (where X.Y represents your version of JIRA)
3. Execute the '.bin' file to start the console wizard.
4. When prompted to choose between 'Express Install', 'Custom Install' or 'Upgrade an existing JIRA installation', choose either 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 console wizard. Please Note:
     • If you are running the installer with 'root' user privileges, JIRA will be installed as a service.
     • If you want to customize any of these options:
     1. 1. Enter 'e' to exit the console wizard.
        2. Execute the console wizard again (step 3 above).
        3. 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 console 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 TCP ports (i.e. an HTTP and a Control port) that JIRA will run through.
     • If you are running the installer with 'root' user privileges, you will be prompted to 'Run JIRA as a service' (recommended). You can also do this manually later, as described inStarting JIRA Automatically on Linux.
5. The console wizard will install JIRA onto your operating system and will start JIRA automatically when the wizard finishes.

• If you executed the Linux Installer with 'root' user privileges, the Linux Installer creates a dedicated Linux user account with username 'jira' and no password, which is used to run JIRA. This account has only:
  • Full write access to your JIRA Home Directory.
  • Limited write access to your JIRA Installation Directory.
• The bundled installer expects the 'root' user to have have the default umask (0022 or 002), if this is not set it can cause problems with the install as per  JRA-32435 - JIRA Linux Installer does not set files with correct permissions when a non-default umask is used VERIFIED . Please ensure this is set prior to installation.
• If you executed the Linux Installer without 'root' user privileges, be aware that JIRA can still be run with 'root' privileges. However, to protect the security of your operating system, this is not recommended.
• Depending on how big the JIRA instance may become, you may need to increase the maximum number of files available on the operating system. This is further covered in our Loss of functionality due to too many open files errors KB - please review it for further information.

2. Start JIRA

2.1 Starting and Stopping JIRA manually

• service jira start (to start JIRA)
• service jira stop (to stop JIRA)

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

*******************************************************

 ... You can now access JIRA through your web browser.

*******************************************************

2.2 Accessing JIRA from a Browser

• 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).

• If JIRA does not appear, you may need to change the port that JIRA runs on.
• Application server logs (i.e. for Apache Tomcat) will be written to the logs/catalina-YYYY-MM-DD.log file within the JIRA Installation Directory.

3. Run the Setup Wizard

4. Next Steps

• See JIRA 101 to start creating Projects, creating Users, and customizing your JIRA instance.
• If you did not install JIRA to run as a service, you will need to start JIRA manually every time you restart your computer. To change your JIRA installation to run as a service, please seeStarting JIRA Automatically on Linux.
• To get the most out of JIRA, please see Optimizing Performance.

Performing an Unattended Installation

• 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=/opt/atlassian/jira Unattended installations will fail if any relative directory paths have been specified in this file.

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

1. Download the JIRA 'Linux Installer' (.bin) file from the JIRA Download Center to a suitable location.
2. Open a Linux console.
3. Copy (cp) the file .install4j/response.varfile located in your previous JIRA installation directory, to the same location as the downloaded 'Linux Installer' file. 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 'Linux Installer' file and execute the following command:
   1

   atlassian-jira-X.Y.bin -q -varfile response.varfile
   Where:
   • 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).