How to change Base URL?


We have JIRA installed on, we need to shrink that URL to

I know we need to change a base URL in JIRA configuration from a webUI. But how do we change our current tomcat settings to reflect our requested url of I know it's being done somewhere in  server.xml file, but what exactly need to be changed there?

Thanks in advance!



2 answers

0 votes

Hi Tara, 

At first glance it looks like you might have a reverse proxy such as Apache set up in front of JIRA. If this is the case the modification would need to occur at the proxy, and at the server.xml level for the change to be effective. Can you confirm if this is the case?

Hi David, Confirm.

0 votes

Hi Taras,
Thanks for the confirmation. The top level view is that you'll need to have a reverse proxy listening on, and then the server.xml will need to have this proxy server added to the configuration like the following example.

<Connector acceptCount="100" connectionTimeout="20000" disableUploadTimeout="true" enableLookups="false" maxHttpHeaderSize="8192" maxThreads="150" minSpareThreads="25" port="8080" protocol="HTTP/1.1" redirectPort="8443" useBodyEncodingForURI="true" 
scheme="https" proxyName="" proxyPort="443" secure="true"/>

Once this is done you can simply change your base_url to reflect this change. Additional information on this configuration can be found in the following article.

Let us know if this helps :).


Hi David, Thanks for your answer. I'll definatelly let you know if that worked when I have a chance to try it. One thing that I'm not sure about now is if we have some kind of reverse proxy, because I'm really familiar with what our customer has installed. Today I was told that they just installed whatever was in a package with Jira, I can tell it's a Tomcat but not sure if it's working as a reverse proxy. Could you please advice if it's working as a reverse proxy out of the box?

Hi Taras, A vanilla installation of JIRA does not have any sort of reverse proxy, and just uses a Tomcat webserver. This server by default will listen on port 8080, which would mean your customers would need to navigate to the url plus the port. Many organizations choose to add their own reverse proxy in front of JIRA for more control over security, and to proxy from a public facing url like to JIRA (which would be on servername:8080).

So as far as I understood to change a URL of Jira I have to 1. Change DNS records 2. Log in and change BASE URL's from a Web UI 3. Edit server.xml and change proxyName parameter Could you please confirm if that's the case? Just in case something will go wrong what is the recomended recovery plan, so that I can have Jira up and running asap?

Suggest an answer

Log in or Sign up to answer
Community showcase
Published Jan 08, 2019 in Jira

How to Jira for designers

I’m a designer on the Jira team. For a long time, I’ve fielded questions from other designers about how they should be using Jira Software with their design team. I’ve also heard feedback from other ...

1,294 views 5 10
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