This documentation relates to Confluence 3.1.x
If you are using an earlier version, please view the previous versions of the Confluence documentation and select the relevant version.

Configuring the Server Base URL

The Server Base URL is the URL via which users access Confluence. The base URL must be set to the same URL by which browsers will be viewing your Confluence site.

Confluence will automatically detect the base URL during setup, but you may need to set it manually if your site's URL changes or if you set up Confluence from a different URL to the one that will be used to access it publicly.

You need to have System Administrator permissions in order to perform this function.

To configure the Server Base URL,

  1. In Confluence, open the 'Browse' menu and select 'Confluence Admin'. The 'Administration Console' will open.
  2. Click 'General Configuration' in the left-hand panel.
  3. Click the 'Edit' button next to 'Site Configuration'.
  4. Enter the new URL in the 'Server Base URL' text box.
  5. 'Save' your changes.
If you configure a different base URL or if visitors use some other URL to access Confluence, it is possible that you may encounter errors while viewing some pages.
Example

If Confluence is installed to run in a non-root context path (that is, it has a context path), then the server base URL should include this context path. For example, if Confluence is running at http://www.foobar.com/confluence, the server base URL should be http://www.foobar.com/confluence.
RELATED TOPICS
Configuring the Site Home Page
Configuring the Destination of View Space Links
Configuring the Server Base URL
Configuring the Site Support Address
Customising Default Space Content
Editing the Global Logo
Editing the Site Title
Showing Link Icons
Editing the Site Welcome Message

Labels

url url Delete
base base Delete
server server Delete
site-configuration site-configuration Delete
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.
  1. Apr 27, 2007

    Mark says:

    Server Base URL is problematic if you want to run your (same) wiki instance from...

    Server Base URL is problematic if you want to run your (same) wiki instance from multiple subdomains.

    Say I create four spaces:  one, two, three, four

    I want to run http://one.foobar.com/   two.foobar.com  three.foobar.com  four.foobar.com, and as each group logs in they see their space.

    This won't work right?

    Is there a workaround for this? 

    Can the base URL be set according to the server.xml file, where you can enter multiple hosts? 

    1. May 07, 2007

      David Chui says:

      Hi Mark, To confirm, Confluence does not support such configuration as discusse...

      Hi Mark,

      To confirm, Confluence does not support such configuration as discussed here.

      Unfortunately, there is no workaround. Also, each instance of Confluence is limited to one base URL.

      Regards,
      David

  2. Mar 08

    Anonymous says:

    we just started using confluence for our external documentation repository. ...

    we just started using confluence for our external documentation repository. 

    our confluence instance is accessible via: https://<businessname>.onconfluence.com.  Now the powers that be want our clients to
    access the site via a friendlier name.  Do we have to create a new instance of Confluence or is there an easier way to modify this.  Changing the Base URL alone won't do it, right?

    Thanks for any guidance.

  3. Mar 08

    Anonymous says:

    Oh, the friendlier name is still pending but may be something like: <business...

    Oh, the friendlier name is still pending but may be something like: <businessname>.com/support or supportDocuments.onconfluence.

    Thanks.

  4. Mar 10

    Jordi Wauters says:

    I raised a support request, but no solution there. I wonder if this can be impl...

    I raised a support request, but no solution there.

    I wonder if this can be implemented as an Improvement Request?
    A lot of companies work with subdomains, can't the server base url be retrieved from the request?

  5. Mar 10

    Anonymous says:

    We implemented a subdomain solution.  Didn't even have to change the base u...

    We implemented a subdomain solution.  Didn't even have to change the base url.  It seems to be working fine.

    1. Mar 11

      Jordi Wauters says:

      Hi anon, Can you tell me how you did it? Is it tomcat or confluence configurati...

      Hi anon,

      Can you tell me how you did it? Is it tomcat or confluence configuration?

      Thanks in advance!

      jordi.wauters@securex.be

Add Comment