'Your URL doesn't match warning' displayed in Confluence 6.1 or later
Platform Notice: Data Center Only - This article only applies to Atlassian products on the Data Center platform.
Note that this KB was created for the Data Center version of the product. Data Center KBs for non-Data-Center-specific features may also work for Server versions of the product, however they have not been tested. Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.
*Except Fisheye and Crucible
Problem
Confluence displays the following message to administrators:
Your URL doesn't match
Confluence's base URL is set to <address> but you are accessing Confluence from <address>.

Cause
This message appears when you are accessing Confluence via a URL that is different to the URL that was set as Confluence's base URL. This can cause errors and unexpected behaviour in some parts of Confluence.
If the URLs displayed are identical, this could be because the ProxyName
and ProxyPort
in your server.xml
file have incorrect values. If you do not use a reverse proxy, make sure ProxyName
and ProxyPort
is not configured in your server.xml
.
Solution
You can choose to ignore this error, but we do find that Confluence works best when the base URL is set correctly. This should be the same URL that your reverse proxy or load balancer uses.
To update your base URL:
Go to ⚙ > General Configuration
Choose Edit
Enter your actual Confluence URL (the URL that users will use to access Confluence) and save your changes.
The base URL warning should no longer appear.
Workaround
If there is a reason you don't access Confluence via the base URL (for example you have multiple URLs configured in your reverse proxy), or if the Base URL check is incorrectly detecting your base URL you can disable the check.
For Confluence Versions below 7.3:
To disable this check in your site:
Go to ⚙ > Add-ons > System
Disable the Confluence Base URL plugin system add-on.
For Confluence versions 7.3 or greater:
Disable the Confluence Base URL plugin through the UI has been disabled on Confluence 7.3+.
Follow the instructions on this suggestion to disable the plugin through the REST API: Add an option to disable the Base URL warning
The base URL warning should no longer appear.
Was this helpful?