How to change the JIRA application context path

Still need help?

The Atlassian Community is here for you.

Ask the community

Symptoms

Context paths are useful in cases where you want to either have your application resolve at http://yourdomain.com/jira or make your application unique. 

Resolution

  1. Shut down your JIRA application instance;
  2. Locate the file server.xml which located on your $JIRA_installation_folder\conf;
  3. Edit the server.xml, and add the context path inside the Context path = "" quotation area, view example below:

    Example

    Original:

    <Context path="" docBase="${catalina.home}/atlassian-jira" reloadable="false"> </Context>

    After change:

    <Context path="/jira" docBase="${catalina.home}/atlassian-jira" reloadable="false"> </Context>

    (info) Path is not always in the beginning of the Context parameters. You might have to read over the entire list of parameters to find it. You can also define any word you'd like there as long as you have a forward slash at the beginning.

    (info) For more details you can see Apache context configuration.

  4. Save the server.xml;
  5. Start your JIRA applications;
  6. Access your applications with the context path (e.g. original: http://localhost:8080, now access from http://localhost:8080/jira);
  7. Configure the 'Base URL' in JIRA Administration > Global Settings > General Configuration to the new location from which your users will access JIRA applications.

 

Alternative methods for setting the default Tomcat application include:

  • Rename WAR file to ROOT.war, and re-start Tomcat.
    OR
  • Place WAR file outside of $CATALINA_BASE/webapps (to avoid double deployment). Put a context file named ROOT.xml in $CATALINA_BASE/conf/. Set the docBase attribute to point at the location of WAR file. Leave the path element blank, as it is derived from the name of the xml file (ROOT.xml).
Last modified on Feb 19, 2016

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.