Changing the port that Bitbucket Server listens on

Administering Bitbucket Server

On this page

Still need help?

The Atlassian Community is here for you.

Ask the community

You can change the port that Bitbucket 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 Server listens on

  1. Navigate to your Bitbucket Server home directory.
     
  2. Open the shared/bitbucket.properties file, add the sever.port property (or edit it if a line for the server.port property already exists), and set the value to the port number Bitbucket will run on. For example, to set to the port to 8080 you would add: 

    server.port=8080

    Then save the file.
     

  3. Restart Bitbucket Server 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 Server on a Linux server and want to bind to privileged ports (those below 1024, for example port 80), you will need to start Bitbucket Server as root to successfully bind to the port. Or, you can bind Bitbucket Server to a port over 1024 and then configure iptables to redirect traffic from port 80 to the higher port. 

Last modified on Feb 2, 2021

Was this helpful?

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