Configuring the Base URL

On this page

Still need help?

The Atlassian Community is here for you.

Ask the community

The Base URL is the URL via which users access Jira applications. The base URL must be set to the same URL by which browsers will be viewing your Jira instance.

Jira will automatically detect the base URL during setup, but you may need to set it manually if your site's URL changes or if you set up Jira from a different URL to the one that will be used to access it publicly.

You need to have the system administrator global permission in order to perform this function.

To configure the Base URL:

  1. Choose > System
  2. Choose General Configuration in the left-hand panel.
  3. Choose Edit Settings.
  4. Enter the new URL in the Base URL text box.
  5. Choose Save.


If Jira is installed to run in a non-root context path (that is, it has a context path), then the server base URL should include this context path. For example, if Jira is running at:

then the server base URL should be:


  • Using different URLs. If you configure a different base URL or if visitors use some other URL to access Jira, it is possible that you may encounter errors while viewing some pages.
  • Changing the context path. If you change the context path of your base URL, you may also need to edit the web server's server.xmlfile to reflect the new path:
    1. Stop the Jira server.
    2. Go to your Jira 'destination directory'. This is the directory where the Confluence installation files are stored. For example,  C:\Program Files\Atlassian\JIRA. Let's call this directory '{Jira_INSTALLATION}'.
    3. Edit the configuration file at {Jira_INSTALLATION}\conf\server.xml.
    4. Change the value of the path attribute in the Context element to reflect the context path. For example, if Jira is running at, then your path attribute should look like this:

      <context path="/JIRA" docBase="../JIRA" debug="0" reloadable'"false" useHttpOnly="true">
    5. Save the file.
  • Proxies. If you are running behind a proxy, ensure that the proxy name matches the base URL.  For example: proxyName="" proxyPort="443" scheme="https". This will make sure we are passing the information correctly.
  • This information needs to be added in the Connector element at {Jira_INSTALLATION}\conf\server.xml.
Last modified on Oct 18, 2019

Was this helpful?

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