'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>.

(Auto-migrated image: description temporarily unavailable)

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:

  1. Go to ⚙ > General Configuration

  2. Choose Edit

  3. 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:

  1. Go to ⚙ > Add-ons > System

  2. Disable the Confluence Base URL plugin system add-on.

For Confluence versions 7.3 or greater:

The base URL warning should no longer appear.

Updated on April 15, 2025

Still need help?

The Atlassian Community is here for you.