Versions
- 9.3
- 9.2
- 9.1
- 9.0
- 8.19
- 8.18
- 8.17
- 8.16
- 8.15
- 8.14
- 8.13
- 8.12
- 8.11
- 8.10
- 8.9
- 8.8
- 8.7
- 8.6
- 8.5
- 8.4
- 8.3
- 8.2
- 8.1
- 8.0
- 7.21
- 7.20
- 7.18
- 7.19
- 7.17
- 7.16
- 7.15
- 7.14
- 7.13
- 7.12
- 7.11
- 7.10
- 7.9
- 7.8
- 7.7
- 7.6
- 7.5
- 7.4
- 7.3
- 7.2
- 7.1
- 7.0
- 6.10
- 6.9
- 6.8
- 6.7
- 6.6
- 6.5
- 6.4
- 6.3
- 6.2
- 6.1
- 6.0
- 5.16
- 5.15
- 5.14
- 5.13
- 5.12
- 5.11
- 5.10
- 5.9
- 5.8
- 5.7
- 5.6
- 5.5
- 5.4
- 5.3
- 5.2
- 5.1
- 5.0
- See all
Moving Bitbucket Server to a different context path
Administering Bitbucket Server
- Users and groups
- External user directories
- Global permissions
- Setting up your mail server
- Integrating Bitbucket Server with Atlassian applications
- Connecting Bitbucket Server to an external database
- Migrating Bitbucket Server to another server
- Specifying the base URL for Bitbucket Server
- Configuring the application navigator
- Managing add-ons
- Audit logging in Bitbucket Server
- Running Bitbucket Server as a Windows service
- Updating your Bitbucket Server license details
- Bitbucket Server config properties
- Moving Bitbucket Server to a different context path
- Data recovery and backups
- Disabling HTTP(S) access to Git repositories in Bitbucket Server
- Smart Mirroring
- Git Large File Storage
- Enabling SSH access to Git repositories in Bitbucket Server
- Using diff transcoding in Bitbucket Server
- Changing the port that Bitbucket Server listens on
- Lockout recovery process
- Proxying and securing Bitbucket Server
- High availability for Bitbucket Server
- Enabling JMX counters for performance monitoring
- Bitbucket Server debug logging
- Scaling Bitbucket Server
- Getting started with Bitbucket Server and AWS
- Add shortcut links to a Bitbucket Server repository
- Data Center Migration
- Git Virtual File System (GVFS)
- Diagnostics for third-party apps
- Administer code search
On this page
Related content
- No related content found
There are various reasons why you might need to change the context path for Bitbucket Server. Two of those are:
- You are running Bitbucket Server behind a proxy.
- You have another Atlassian application, or Java web application, available at the same hostname and context path as Bitbucket Server, and are experiencing login problems (see Login and session conflicts with multiple Atlassian applications).
To change the context path for Bitbucket Server
- Navigate to your Bitbucket Server home directory.
- Stop Bitbucket Server. See Starting and stopping Bitbucket Server.
Open the
shared/bitbucket.propertiesfile, and add theserver.context-pathproperty. Set it to reflect the context path that you want Bitbucket Server to be accessible at. For example, to set the context path to/bitbucketyou would add:server.context-path=/bitbucketThen save the file.
- Start Bitbucket Server. See Starting and stopping Bitbucket Server.
Bitbucket Server is now available at the same host as before, but under the new context path. For example, a server that was athttp://localhost:7990will now be reachable athttp://localhost:7990/bitbucket. Once started, go to the administration area and click Server settings (under 'Settings'). Append the new context path to your base URL:
https://localhost:7990/bitbucketClick Save.
Important considerations
If you're running Bitbucket Server behind Apache,
- You need to make sure 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 updated the Bitbucket Server context path using the steps outlined above, you need to also update your Apache configuration, as described in Integrating Bitbucket Server with Apache HTTP Server.
If you had Application Links set up before changing the context path in Bitbucket Server, you have to recreate those using the new Bitbucket Server URL. See Linking Bitbucket Server with JIRA.
If you use 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://localhost:7990/bitbucket, SSH operations occur without the context path at ssh://my-bitbucket-hostname:7999.
Related content
- No related content found