Documentation for JIRA 4.4. Documentation for other versions of JIRA is available too.
To install JIRA Standalone on Windows from a 'zip' archive file or Linux/Solaris from a 'tar.gz' archive file, follow these steps:
Please ensure that you have installed Java and set JAVA_HOME.
Linux distributions frequently have an open-source implementation of Java called GCJ installed. Do not use this Java platform — it is incomplete and JIRA will not run successfully on it.
jira-application.properties
file and set the value of the 'jira.home
' property to the desired location for your JIRA Home Directory. If you are specifying this location's path on Windows, use double back-slashes ("\") between subdirectories. For example, X:\\path\\to\\JIRA\\Home
JIRA_HOME
in your operating system whose value is the location of your JIRA Home Directory. To do this:
set JIRA_HOME=X:\path\to\JIRA\Home
JIRA_HOME
environment variable value using this format, where:
X
is the drive letter where your JIRA Home Directory is located and=
')export JIRA_HOME=/path/to/jira/home
Please note that you cannot use the same JIRA home directory for multiple instances of JIRA. We recommend locating your JIRA Home Directory completely independently of the JIRA Installation Directory (i.e. not nesting one within the other) as this will minimise information being lost during major operations (e.g. backing up and restoring instances).
This step is optional if you are evaluating JIRA but should be mandatory for JIRA installations used in production.
$ sudo /usr/sbin/useradd --create-home --comment "Account for running JIRA" --shell /bin/bash jira
> net user jira mypassword /add /comment:"Account for running JIRA"
Ensure that only the following directories can be written to by this dedicated user account (e.g. 'jira'):
logs
temp
work
Do not make the JIRA Installation Directory itself writeable by the dedicated user account.
See also Tomcat security best practices.
Enter the bin
subdirectory of your JIRA installation directory and execute the appropriate file to start running JIRA:
start-jira.sh
(on Linux/Solaris)start-jira.bat
(on Windows)To run JIRA as the dedicated user account (e.g. 'jira') created above:
runas
command to run start-jira.bat
. For example,runas /env /user:<DOMAIN>\jira start-jira.bat
<DOMAIN>
is your Windows domain or computer name.)su
command before running start-jira.sh
(or use su
to run start-jira.sh
as the 'jira' account).Wait until the following message appears in the application's log file:
******************************************************* ... You can now access JIRA through your web browser. *******************************************************
You can access JIRA from any computer with network access to your JIRA server by opening a supported web browser on the computer and visiting this URL:
http://<computer_name_or_IP_address>:<HTTP_port_number>
where:
<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 (8080 by default).If JIRA does not appear in your web browser, you may need to change the port that JIRA runs on.
Logs will be written to logs/catalina.out
.
If something goes wrong, please verify that Java is installed correctly. If the problem persists, please contact us — we're happy to help.