JIRA
Install
Admin
Use
Search JIRA documentation:

Installing JIRA WAR/EAR

PDF
PDF
Note
Not sure whether to install JIRA Standalone or JIRA WAR/EAR? Read the requirements and recommendations.

Installing JIRA WAR/EAR

The distribution ZIP file contains an Ant build script to create a deployable EAR or WAR for your particular application server (and any necessary library directories).

The basic set of steps to install JIRA WAR/EAR is as follows:

  1. Download and unzip JIRA (but not with XP's unzipper nor the default tar utility on Solaris). Ensure that you download the WAR/EAR version, not the Standalone version that is recommended on the downloads page.
  2. Follow the instructions in the readme.txt file, located in the root directory of the unpacked JIRA distribution. This refers to the server-specific installation guides.
    Note, regardless of your choice of server, if your operating system is UNIX/Linux you are strongly recommended to create a dedicated user to run JIRA. For further details, please refer to the JIRA Server Requirements section on the Requirements page.
  3. Access JIRA using your web browser and run through the brief setup wizard.
Note
Avoid the Windows XP built-in unzip tool! The built-in unzip tool in Windows XP is broken — it silently fails to extract files with long names (see JRA-2153). Other users have also reported problems using WinRAR. Please use another tool like WinZIP to unpack JIRA.
Avoid the Solaris default tar utility! On Solaris, please use GNU tar to unpack JIRA in order to handle long filenames.

Increasing application server memory

For production use, please check that your application server is allocated sufficient memory. Java apps claim up to only 64Mb by default, and this usually isn't enough for JIRA. See the Increasing JIRA memory page for more information.

Next step