Skip to content

Default Ports of WSO2 Products

This page describes the default ports that are used for each WSO2 product when the port offset is 0. If you are running multiple WSO2 products on the same server, you must set the offset value in the <IS_HOME>/repository/conf/deployment.toml file to a different value for each product so that there are no port conflicts.

[server]
offset = <PORT_OFFSET_VALUE>

For example, if you are running two WSO2 products on the same server, and you set the port offset to 1 in one product and 2 in the second product, the management console port will be changed from the default of 9443 to 9444 in the first product and to 9445 in the second product. See here for more information on changing the offset.

Common ports

The following ports are common to all WSO2 products that provide the given feature. Some features are bundled in the WSO2 Carbon platform itself and therefore are available in all WSO2 products by default.

Console ports

WSO2 products that provide a WSO2 IS console use the following servlet transport ports:

  • 9443 - HTTPS servlet transport (the default URL of the WSO2 IS console is https://localhost:9443/console)
  • 9763 - HTTP servlet transport

Clustering ports

To cluster any running Carbon instance, either one of the following ports must be opened.

  • 45564 - Opened if the membership scheme is multicast
  • 4000 - Opened if the membership scheme is wka

Random ports

Certain ports are randomly opened during server startup. This is due to specific properties and configurations that become effective when the product is started. Note that the IDs of these random ports will change every time the server is started.

  • A random TCP port will open at server startup because of the -Dcom.sun.management.jmxremote property set in the server startup script. This property is used for the JMX monitoring facility in JVM.
  • A random UDP port is opened at server startup due to the log4j appender Syslog Appender, which is configured in the <IS_HOME>/repository/conf/log4j2.properties file.

    # Uncomment the below lines to use the Syslog Appender
    #appender.syslog.type = Syslog
    #appender.syslog.name = Syslog
    #appender.syslog.host = localhost
    #appender.syslog.port = 514
    #appender.syslog.layout.type = PatternLayout
    #appender.syslog.layout.pattern = [%d] [%tenantId] %5p {%c} - %mm%ex%n
    #appender.syslog.filter.threshold.type = ThresholdFilter
    #appender.syslog.filter.threshold.level = DEBUG
    

WSO2 Identity Server ports

WSO2 IS also opens the following additional ports.

  • 8000 - KDCServerPort : the port on which KDC (Kerberos Key Distribution Center) server runs
  • 10500 - ThriftEntitlementReceivePort

Change the offset for default ports

When you run multiple WSO2 Identity Server instances, you need to change their default ports with a port offset. Port offset defines the number by which all ports defined in the runtime (such as for HTTP/HTTPS) will be changed.

Note

The default HTTP and HTTPS ports for WSO2 Identity Server are 9763 and 9443 respectively.

For example, if the port offset is 1, the HTTP and HTTPS ports will change to 9764 and 9444 respectively. For each additional instance, you need to set the port offset with a unique value. The default port offset is 0.

There are two ways to set an offset to a port:

  • Pass the port offset to the server during startup. The following command starts the server with the default port incremented by 3.

    ./wso2server.sh -DportOffset=3
    
  • Set the offset value in the <IS_HOME>/repository/conf/deployment.toml file as follows:

    [server]
    offset = <PORT_OFFSET_VALUE>
    

Usually, when you offset the port, all the ports are shifted by that offset automatically. The following table indicates the changes that occur when the offset value is modified.

WSO2 Server instance

PortOffset

Sample Default Port Value

WSO2 Product 1

0

9443

WSO2 Product 2

1

9444

WSO2 Product 3

2

9445

WSO2 Product 4

3

9446

WSO2 Product 5

4

9447