JIRA Displays an Error Banner about the Base URL

Still need help?

The Atlassian Community is here for you.

Ask the community

Symptoms

  1. JIRA may display a yellow ribbon at the top of the main dashboard screen with the error message "JIRA's base URL is set to <<address>>, but you are accessing Jira from <<same address>>. Click here to fix this problem.".
  2. JIRA can also display broken avatars in Activity Stream and create malformed links to its issues.

For example:

Cause

This error is most often caused by the below:

  • A reverse-proxy or load-balancer has not been configured as required when offloading HTTPS.
  • The Base URL is not correct, as in Configuring JIRA Options.
  • Context path under <jira-install>/conf/server.xml is not correct.

Resolution

The content on this page relates to platforms which are supported by JIRA, however are out of scope of our Atlassian Support Offerings. Consequently, Atlassian can not guarantee providing any support for it. Please be aware that this material is provided for your information only and using it is done so at your own risk.

  1. Make sure that the base URL is correctly set and this same address is reachable from the same server. JIRA's gadgets will proxy themselves, so it must be able to communicate to itself.
  2. Ensure that the appropriate configuration has been applied as in our Integrating JIRA with Apache using SSL documentation, specifically proxyName, proxyPort and scheme.
  3. Make sure that the Proxy or Load balancer is properly configured to the same base URL as JIRA.

(info) Please keep proxyName value in lower-case and must match the Base URL of the JIRA instance. For example, a proxyName of ServerName will not match a Base URL of http://servername.com. To fix this, change the proxyName to servername.com

Disable the Warning

Although not recommended, you can disable the warning by disabling the Jira Base URL plugin with the following steps. 

  • Navigate to Manage Apps -> All Applications -> Jira Base URL Plugin
  • Click disable
  • Restart Jira
Last modified on Aug 17, 2022

Was this helpful?

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