Confluence requires URL rewriting for proper functionality, if Confluence is accessible via different domain names. If Confluence is configured for multiple domains without URL rewriting, you will experience an array of problems. See Various Issues Caused when Server Base URL Does Not Match the URL Used to Access Confluence.

An example of why you may want to access Confluence from different domains:

  • From an internal network:

    http://wiki
  • The externally visible domain:

    http://wiki.domain.com

Using URL rewriting to access Confluence over multiple domains

To configure Confluence over multiple domains:

  1. Add a DNS entry mapping http://wiki to the externally visible IP address of the Confluence server.
  2. Set Confluence's server base URL to http://wiki.domain.com.
  3. Add Apache HTTP proxy, using the instructions from Running Confluence behind Apache.
  4. Add the mod_rewrite module to change the URL.

Further information

You may be interested in the UrlRewriteFilter that is Java web filter that works in a similar way of the Apache's mod_rewrite.

  • No labels