Changing the port that Stash listens on

Redirection notice

This page will redirect to /display/BitbucketServer/Changing+the+port+that+Bitbucket+Server+listens+on .

You may wish to change the port that Stash listens on from the default '7990' to a different value if another application is already running on that port.

To change the port, edit the shared/server.xml file in the <Stash home directory>.

Find the following lines in server.xml:

<Server port="8006" shutdown="SHUTDOWN">
...
<Connector port="7990" protocol="HTTP/1.1"
                 connectionTimeout="20000"
                 useBodyEncodingForURI="true"
                 redirectPort="8443"
                 compression="on"
                 compressableMimeType="text/html,text/xml,text/plain,text/css,application/json"/>

You need to modify both the server port (the default is 8006) and the connector port (the default is 7990) to ports that are free on your machine. The server port is required by Tomcat but is not user-facing in any way. The connector port is the port you use to access Stash. For example, in the snippet above, the URL would be http://example.com:7990.

(tick)  Hint: You can use netstat to identify free ports on your machine. See more information on using netstat on Windows or on Linux.

(warning) If you are using a firewall, you should ensure that it is configured to allow HTTP or HTTPS traffic over the connector port you have chosen. 

(warning) If you are running Stash on a Linux server and want to bind to privileged ports (those below 1024, for example port 80), you will need to start Stash as root in order to successfully bind to the port. Alternatively, you can bind Stash to a port over 1024 and then configure iptables to redirect traffic from port 80 to the higher port. 

Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

Have a question about this article?

See questions about this article

Powered by Confluence and Scroll Viewport