Changing the port that Bitbucket Server listens on
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
- Run Bitbucket in AWS
- Specifying the base URL for Bitbucket Server
- Configuring the application navigator
- Managing apps
- Auditing in Bitbucket
- 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
- Data Center Migration
- Git Large File Storage
- Git Virtual File System (GVFS)
- 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
- Diagnostics for third-party apps
- Enabling JMX counters for performance monitoring
- Bitbucket Server debug logging
- Scaling Bitbucket Server
- Add shortcut links to a Bitbucket Server repository
- Administer code search
- Adding additional storage for your repository data
- Add a system-wide announcement banner
- Configuring Project links across Applications
- Improving instance stability with rate limiting
- Use a CDN with Atlassian Data Center applications
- Managing personal access tokens
- Connecting to a 3rd party application using Application Links
- Setting a system-wide default branch name
- Automatically decline inactive pull requests
- Encrypt database password
On this page
Related content
- No related content found
You can change the port that Bitbucket Data Center and Server listens on from the default '7990' to a different value if another application is already running on that port.
You can use netstat to identify free ports on your machine.
To change the port Bitbucket listens on
- Navigate to your home directory.
Open the
shared/bitbucket.propertiesfile, add thesever.portproperty (or edit it if a line for theserver.portproperty already exists), and set the value to the port number Bitbucket will run on. For example, to set to the port to8080you would add:server.port=8080Then save the file.
Restart Bitbucket so the change takes effect. See Starting and stopping Bitbucket Server.
Important considerations
If you are using a firewall, ensure that it is configured to allow HTTP or HTTPS traffic over the connector port you have chosen.
If you are running Bitbucket on a Linux server and want to bind to privileged ports (those below 1024, for example port 80), you will need to start Bitbucket as root to successfully bind to the port. Or, you can bind Bitbucket to a port over 1024 and then configure iptables to redirect traffic from port 80 to the higher port.
Related content
- No related content found