Change the context path used to access Jira server

Still need help?

The Atlassian Community is here for you.

Ask the community


Context paths are useful in cases where you want to either have your application resolve at or make your application unique. 


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



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

    After change:

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

    (info) The 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 of your choosing as long as it starts with a forward slash.

    (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, for example:
  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.
  • 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 Aug 5, 2021

Was this helpful?

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