This documentation relates to Confluence 3.1.x
If you are using an earlier version, please view the previous versions of the Confluence documentation and select the relevant version.

Change listen port for Confluence Standalone

Problem

This page tells you what to do if you get errors like the following when starting Confluence Standalone, and can't access Confluence on port 8080.

java.net.BindException: Address already in use: JVM_Bind:8080

This means you are running other software on Tomcat's default port 8080. This may either be another Tomcat or some other process. It may also be a previous instance of Confluence that hasn't been shut down cleanly.

To find out what process is listening on that port, load a command prompt and type: netstat -an

 -a : Displays all active TCP connections and the TCP and UDP ports on which the computer is listening.
 -n : Displays active TCP connections, however, addresses and port numbers are expressed numerically and no attempt is made to determine names.

There is also Process Explorer tool available to determine what is binding port 8080.

Solution: Change the Ports which Confluence Listens On

To change the ports for Confluence Standalone, open the file conf/server.xml under your Confluence Installation directory. The first four lines of the file look like this:

Default conf/server.xml
<Server port="8000" shutdown="SHUTDOWN" debug="0">
    <Service name="Tomcat-Standalone">
        <Connector className="org.apache.coyote.tomcat4.CoyoteConnector" port="8080" minProcessors="5" maxProcessors="75"
            enableLookups="true" redirectPort="8443" acceptCount="10" debug="0" connectionTimeout="20000" useURIValidationHack="false"/>
        ...

You need to modify both the server port (default is 8000) and the connector port (default is 8080) to ports that are free on your machine.
Hint: You can use netstat to identify free ports on your machine. See more information on using netstat on Windows or on Linux.

For example, here are the first four lines of a modified server.xml file, using ports '8015' and '8090':

Modified conf/server.xml using ports 8015 and 8090
<Server port="8015" shutdown="SHUTDOWN" debug="0">
    <Service name="Tomcat-Standalone">
        <Connector className="org.apache.coyote.tomcat4.CoyoteConnector" port="8090" minProcessors="5" maxProcessors="75"
            enableLookups="true" redirectPort="8443" acceptCount="10" debug="0" connectionTimeout="20000" useURIValidationHack="false"/>
        ...

To access Confluence in this configuration, point your web browser to http://localhost:8090/.

NOTES

[1] For more information on netstat, see using netstat on Windows, or netstat man page (Linux).

[2] JIRA Standalone also runs on port 8080 by default. If you're looking to change the port of JIRA Standalone, see Changing JIRA Standalone's port.

RELATED PAGES

Installing Confluence Standalone Using the Windows Evaluation Installer
Running Tomcat on a Different Port
Documentation Home

Labels

howdoi-faq howdoi-faq Delete
standalone standalone Delete
confluence confluence Delete
installation installation Delete
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.
  1. Feb 13, 2009

    Christian Kuehn says:

    I try to change the Connector Port from 8080 to 80. ( only the Connector not the...

    I try to change the Connector Port from 8080 to 80. ( only the Connector not the 8000 Port)

    What I do:

    Change the server.xml Connector Port 8080 to 80

    Restart the the confluence server

    What am I doing wrong

    1. Feb 16, 2009

      Komathi Krishnan [Atlassian] says:

      Hi Christian, As far as I am concerned, your port 80 may be occupied by another...

      Hi Christian,

      As far as I am concerned, your port 80 may be occupied by another application. Please use the netstat -an in command prompt to check whether the port is occupied or not. Another way to check is to run your browser and try accessing http://<host-name>:80. If any other application is running on it, try shutting down that application and restart your confluence again or you can change the port number.

      You can also telnet to the port number to see if the port is being used:

      telnet <host-name> <port>

      If the port is occupied, it will return a blank screen.

      Hope that helps.

      Cheers,
      Komathi

      1. Jun 26, 2009

        Anonymous says:

        Christian, I ran into this problem too and the key for me was to uninstall Inte...

        Christian,

        I ran into this problem too and the key for me was to uninstall Internet Information Services (IIS) off my server, because it too lists port "80" as one of its primary ports.

        Good Luck

  2. Jan 15

    Anonymous says:

    Also remember that on linux, you usually have to start the program as root for i...

    Also remember that on linux, you usually have to start the program as root for it to be able to bind port 80...

Add Comment