Skip to main content

    Changing the Port Used by the PoolParty Server

    30/04/2025

    Prerequisites for Changing the Port of PoolParty Server

    • A default installation of PoolParty following the respective Installation Guide .

    • No other service running on port 80.

    To change the PoolParty default port to another than port 80, follow these steps:

    Step 1: Stop the PoolParty Server

    On Linux, open a shell and change to root:

    sudo -i

    Stop PoolParty:

    <PPAppDir>/bin/poolparty stop

    Note

    On Windows, use the Apache Tomcat service application to stop PoolParty. For more, see: Control PoolParty Using Tomcat Service Application (Windows)

    Step 2: Change the port-property of the Connector-tag in the Apache Tomcat's server.xml

    Change the port-property in the Connector element of server.xml to reflect your desired port:

    Example Port Configuration 8081 of server.xml

    ...
 <Connector port="8081" protocol="HTTP/1.1"
            connectionTimeout="20000"
            redirectPort="8443" />
...

    You will find the file in these paths respectively:

    • Linux: <PPAppDir>/tomcat/conf/

    • Windows: <drive>:\<TomcatDir>\conf

    Note

    You need to configure your packet filter/firewall (if any) in a way that allows the host to accept incoming connections on the port of your choice.

    Otherwise, PoolParty may not be reachable over the network.

    Step 3: Change the Connector URL

    Adapt the URL for Solr connection in poolparty.properties with new port:

    Example Port Configuration 8081 of poolparty.properties

    ...
ppt.url=http://localhost:8081/PoolParty/
...

    You will find the file in these paths respectively:

    • Linux: <PPAppDir>/config/

    • Windows: <drive>:\<PPAppDir> config\

    Step 4: Start the PoolParty Server

    On Linux open a console and change to root:

    sudo -i

    Start PoolParty:

    <PPAppDir>/bin/poolparty start

    Note

    On Windows, use the Apache Tomcat service application to start PoolParty.