Moving Bitbucket Server to a different context path

There are various reasons why you may wish to change the context path for Bitbucket Server. Two of those are:

Upgrade Note

Note that the location of server.xml changed in Bitbucket Server 3.8. See the Bitbucket Server upgrade guide.

Changing the context path for Bitbucket Server:

  1. Navigate to your Bitbucket Server home directory.
  2. Stop Bitbucket Server. See Starting and stopping Bitbucket Server.
  3. Edit <Bitbucket home directory>/shared/server.xml  and find the element below:

    <Context path="" docBase="${catalina.home}/atlassian-bitbucket" reloadable="false" useHttpOnly="true"/>

    Update the path attribute to reflect the context path that you want Bitbucket Server to be accessible at, e.g. "/bitbucket":

    <Context path="/bitbucket" docBase="${catalina.home}/atlassian-bitbucket" reloadable="false" useHttpOnly="true"/>

    Then save the file.

     

  4. Start Bitbucket Server. See Starting and stopping Bitbucket Server.

    Bitbucket Server should now be available at the same host as before under the new context path. For example a server that was at http://localhost:7990 will now be reachable at http://localhost:7990/bitbucket.
  5. Once Bitbucket Server has started, go to the administration area and click Server settings (under 'Settings'). Append the new context path to your base URL:

    https://my-bitbucket-hostname:7990/bitbucket
  6. Click Save.

Bitbucket Server + Apache

Note that if you are running Bitbucket Server behind Apache:

  • You will need to make sure that the host or context path that Bitbucket Server is exposed on is not also being used by another web application that is listening on a different port.
  • If you have updated the Bitbucket Server context path using the steps outlined above, you will need to update your Apache configuration, as described in Integrating Bitbucket Server with Apache HTTP Server.

Application Links

If you had Application Links set up before changing the context path in Bitbucket Server, you will have to recreate those using the new Bitbucket Server URL. See Linking Bitbucket Server with JIRA.

SSH

The context path does not affect the URL at which SSH operations occur. After changing the context path so that Bitbucket Server is accessible at https://my-bitbucket-hostname:7990/bitbucket, SSH operations occur without the context path at ssh://my-bitbucket-hostname:7999.

Last modified on May 1, 2017

Was this helpful?

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