Installing JIRA Standalone on Mac OS

Before you Begin

1)Download the JIRA Standalone TAR(.GZ) File  standalone.tar.gz

2)Unzip the downloaded file.

Note: Please ensure Java Home is Setup preperly

$ Whereis java

$ export JAVA_HOME /usr/bin/java


Installing JIRA

1)Copy the unzipped JIRA Folder to Application folder

2) Then Navigate /Applications/atlassian-jira-enterprise-4.1.1-standalone/atlassian-jira/WEB-INF/classes/ to edit file

3) Edit the file .add a ‘jira.home’ property and set it to your desired location for the JIRA Home Directory ( /Application/Jira/HOME)

Note :By default, JIRA Standalone runs on port 8080 (and hence is available at (http://<yourserver&gt;:8080, eg. http://localhost:8080).

If the server on which you run JIRA Standalone already has a service claiming port   8080, there will be a conflict, and JIRA will fail to start. You may see errors like this

LifecycleException:  Protocol handler initialization failed: Address already in use:8080

This can be fixed by changing JIRA to use another port (eg. 8090). This is done by editing conf\server.xml (eg. in Wordpad). The start of the file looks like:

<Server port=”8005” shutdown=”SHUTDOWN”>

<Service name=”Catalina”>

<Connector port=”8080

maxHttpHeaderSize=”8192″ maxThreads=”150″ minSpareThreads=”25″ maxSpareThreads=”75″

enableLookups=”false” redirectPort=”8443″ acceptCount=”100″ connectionTimeout=”20000″ disableUploadTimeout=”true” />

Here, change “8005” to “8006”, and change “8080” to “8090” (or some other free port — see below).

Then restart JIRA (bin\shutdown.bat; bin\startup.bat) and point a browser to http://<yourserver&gt;:8090

Which port number should I choose?

If you are not sure which port number to choose, try new numbers one by one, starting with default port numbers and incrementing by one. Keep going until you find an available port number.

A note about firewalls

When you choose a port number for JIRA, bear in mind that your firewall may prevent people from connecting to JIRA based on the port number. Organizations with a local network protected by a firewall typically need to consider modifying their firewall configuration whenever they install a web-based application (such as JIRA) that is running on a new port or host. Even personal laptop and desktop machines often come with firewall software installed that necessitates the same sort of change as described above.

If JIRA does not need to be accessed from outside the firewall, then no firewall configuration changes will be necessary.


Starting JIRA

Run bin/ to start JIRA.


JIRA will be launched in a black ‘Tomcat’ window (do not close this window). Wait until the startup messages have finished.

To access JIRA, go to your web browser and type this address: http://localhost:8080.


Backing and Restoring Data

cheduled XML backups,  )

  1. Log in as a user with the ‘JIRA System Administrators’ global permission
  2. Bring up the administration page by clicking either the ‘Administration’ link on the top bar or the title of the Administration box on the dashboard.
  3. Under the ‘Import & Export’ sub-menu in the left-hand navigation column, click the ‘Backup Data to XML’ link. This will display the ‘Backup JIRA data’ page:
  1. pastedGraphic.pdf

If you see the following message at the top of this page, you will need to set a safe backup path first

  1. You have not named a safe backup directory and hence you are not allowed to make backups for security reasons. You must edit and explicitly set ‘’. Restart JIRA and then you will be able to make arbitrary backups. NOTE :use double \ characters, for example
  2. In ‘File name’ field, type the full path, including filename, of the location to which you want JIRA to write the backup file. Note: Ensure that JIRA has rights to write to this location.
  3. (Optional but recommended) Select the ‘Backup as Zip’ checkbox.
  4. Click the ‘Backup’ button, and wait while your JIRA data is backed up.
  5. When the backup is complete, a message will be displayed, confirming that JIRA has written the data to the file you specified.

Define the SMTP Mail Server

  1. Log in as a user with the ‘JIRA System Administrators’ global permission.
  2. Bring up the administration page by clicking either the ‘Administration’ link on the top bar or the title of the Administration box on the dashboard.
  3. Click “Mail Servers” in the left-hand column (under “Global Settings”).
  4. Click “Configure new SMTP mail server”.
  5. This will display the “Add SMTP Mail Server” screen. Complete the top section as follows:


Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Google+ photo

You are commenting using your Google+ account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )


Connecting to %s