Documentation for JIRA 6.3 EAP developer (EAP) releases only. Not using this? See below:
(JIRA 6.2.x documentation | JIRA OnDemand documentation | earlier versions of JIRA)

Skip to end of metadata
Go to start of metadata

It's possible to run multiple JIRA instances on one machine as long as the instance completes the following requirements:

  • Not sharing the same listening or shutdown port of any other instance or service.
  • Not sharing the same database with another instance.
  • When using services within windows, using 2 different windows service definitions.
  • Not sharing the same JIRA home folder.
  • Not deploying multiple instances using a Single Tomcat Application Container.
  • Having separate licenses for each of the instances.

By default, JIRA runs on port 8080 (and hence is available at (http://<yourserver>:8080, eg. http://localhost:8080).

If you want to run another JIRA instance but 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: java.net.BindException: Address already in use:8080

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

Here, change the shutdown port from "8005" to "8015" and change the listening port from "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>:8090 (eg. http://localhost:8090).

Icon

If you are running on a Unix server and bind the ports below 1024 (such as port 80 for example), you will need to start JIRA as root in order to successfully bind to the port

Which port number should I choose? 

If you are not sure which port number to choose, use a tool such as netstat to determine which port numbers are free to use by JIRA. The highest port number that can be used is 65535 because it is the highest number which can be represented by an unsigned 16 bit binary number. The Internet Assigned Numbers Authority (IANA) lists the registration of commonly used port numbers for well-known Internet services, it's advisable to avoid any of those ports.

  • No labels

2 Comments

  1. Anonymous

    "When using services within windows, using 2 different windows service definitions."

    And how does one do that?

    1. Anonymous

      It looks like the standalone Windows installer will automatically create additional services and resolve this problem for you. It is very clean and very nice.

      I have three instances running on the same machine. My only problem is getting the external URLs to resolve correctly...