Changing the JIRA Base URL

[Ajay Madar]

Hello I am trying to change our base URL for our JIRA non-prod instance from http://localhost:8080 to http://jira-uat.dx.local but when I do this I cant use this URL to access JIRA remotely and I get all kinds of "base URL mismatch" errors when I access the server locally.

I have found page = https://confluence.atlassian.com/adminjiraserver071/configuring-the-base-url-802593107.html, but the section on "Changing the context path" doesnt make sense to me?

Any thoughts?

Ajay

[Nic Brough -Adaptavist-]

The base url in Jira is used internally by the application for internal linking, putting on emails, connecting to remote and local systems and so-on.

Jira runs on Tomcat, which can relocate systems it runs on different "contexts" if you need to run more than one, or want them to run as part of another site.

Imagine a really simple Jira running on a machine called just "tcs".  Without any context, it will run on http://tcs/  If you want to run it on http://tcs/jira, you need to change the base url, but also tell Tomcat it should be running under http://tcs/jira - to do that, change the context in the server.xml to match where you want to run it. 

In your case http://jira-uat.dx.local is a full path without a context, so your Tomcat server needs to be set with just context = ""

You have not really mentioned the port (8080) either.  How are you getting rid of that?  Running Tomcat on port 80?  Or with a proxy?

[Ajay Madar]

Hi Nic, i hadn't considered the impact of the port; in our example above could we keep port = 8080 and therefor use a base url of http://jira-uat.dx.local:8080? We don't use a proxy as all our JIRA users are internal within our domain.

With reference to the server.xml file, would this mean that we still leave context =""? Would any other changes be required to this file?

Ajay

[Nic Brough -Adaptavist-]

Absolutely, just leaving the port in place is a really simple approach, and there's nothing wrong with it.  Getting rid of the port is something humans like doing, but in reality, running on port 80 just means "Browser: please assume no port = 80 for http".

Yes, for http://jira-uat.dx.local:8080 you need context = "", and you don't need to change anything else in the file.

[Jonathan Davies]

Thanks for your support Nic. In addition to the above we had to ask our IT infrastructure team to add the DNS CNAME records for the new URLs and now it works fine.