Configuring the base URL
The base URL is the URL via which users access Jira applications. It can be any address you select, but it must be set to the same URL that’s used by browsers to view your Jira instance.
If Jira is installed to run in a non-root context path (i.e. it has a context path), then the server Base URL should include this context path. For example, if Jira is running at http://www.foobar.com/Jira
, then the server base URL should be http://www.foobar.com/Jira
.
Modifying Jira base URL
Jira automatically detects the base URL during setup. However, 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 publicly access the app.
For all of the following procedures, you must be logged in as a user with the Jira system administrator global permissions.
To configure the base URL:
- In the upper-right corner of the screen, select Administration > System.
In the sidebar, select General configuration.
Select Edit settings.
Enter the new URL in the Base URL text box.
Select Update to save your changes.
Using different URLs
If you configure a different base URL or if users use some other URL to access Jira, 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.xml
file to reflect the new path:
- Stop the Jira server.
- 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}
'. - Edit the configuration file at {
Jira_INSTALLATION}\conf\server.xml
. Change the value of the
path
attribute in theContext
element to reflect the context path. For example, if Jira is running athttp://www.foobar.com/Jira
, then yourpath
attribute should look like this:<context path="/JIRA" docBase="../JIRA" debug="0" reloadable'"false" useHttpOnly="true">
- Save the file.
Setting base URLs behind proxies
If you are running behind a proxy, ensure that the proxy name matches the base URL. For example: proxyName="foobar.com" 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
.