Change JIRA base URL

We would like to install jira at a custom URL. This is not asked during the install, but during the initial configuration and has been configured as:


This appears on the System --> General Configuration --> Base URL as: http://hostname:8080/jira but however clicking on it results in a page not found message.

However JIRA is accessible through the following default URL: http://hostname:8080

Is there a way to change it post installation or during the installation itself. Why is the Base URL shown in the General Configuration page not valid?

3 answers

1 accepted

Hello there, I hope this will help:

If you are attempting to change the URL through which JIRA is accessed - e.g. changing from:




This change is actually made within an app server configuration file. For example, in Tomcat the server.xml file is modified to include an entry within the path argument of the Context element - e.g.:

<Context docBase="/home/keithb/src/atlassian/jira-3.6.branch/src/webapp" reloadable="false" debug="0" path="/jira">

Once the app server is restarted, JIRA will now be available at the new URL as noted above.

It will be necessary to ensure that the Base URL correctly reflects these changes so as all emails generated from JIRA correctly link back to the JIRA instance.



5 votes

Also, if you want to change from http://hostname:8080/jira to http://hostname:8080 or to any custom URL, you will need to change the JIRA Options in the General Configuration (Administration » General Configuration).

You are prompted for the Base URL during the first step of the setup through the browser, right above the License field. However, if you don't enter any manually, JIRA will use the URL you're using to access the setup page. You can change this by navigating to the General Configuration and clicking Edit Configuration in the bottom of the page.

Hi nexusadmin,

If that is the case, you can configure the context path of the JIRA instance.
In order to set the context path, you can customize the context path in <installation-directory>\config\server.xml.

&lt;Engine name="Catalina" defaultHost="localhost"&gt;
            &lt;Host name="localhost" appBase="webapps" unpackWARs="true" autoDeploy="true"&gt;

                &lt;Context path="/jira" docBase="${catalina.home}/atlassian-jira" reloadable="false" useHttpOnly="true"&gt;

To clear your doubt, the base URL is the URL which users access JIRA. The base URL must be set to the same URL by which browsers will be viewing your JIRA site.
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.

*Any mismatch between this Base URL setting and the URL requested by your JIRA users(the address that user access in browser) will cause problems with dashboard gadgets and the email notifications*

For more information about configure JIRA options you can look up to this [documentation].


Suggest an answer

Log in or Sign up to answer
How to earn badges on the Atlassian Community

How to earn badges on the Atlassian Community

Badges are a great way to show off community activity, whether you’re a newbie or a Champion.

Learn more
Community showcase
Published Thursday in Jira

5 ways you can make the most of Jira Software and Bitbucket Cloud

As part of the Bitbucket product team I'm always interested in better understanding what kind of impact the use of our tools have on the way you work. In a recent study we conducted of software devel...

76 views 0 5
Read article

Atlassian User Groups

Connect with like-minded Atlassian users at free events near you!

Find a group

Connect with like-minded Atlassian users at free events near you!

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you