Skip to main content

Changing the Keycloak Port

06/10/2025

PoolParty comes with Keycloak as an authentication and authorization service. You can change the port on which Keycloak is running by modifying the relevant configuration files.

  1. Stop all PoolParty services:

    • /opt/poolparty/bin/poolparty stop

  2. Open the Keycloak configuration file:

    • /opt/poolparty/auth_service/keycloak/conf/keycloak.conf

  3. Change the port number in the http-port property.

    Caution

    The port to which you are changing to must be free.

    For example, if you want to change the port from 8181 to 8000, change it to http-port=8000.

  4. If you run Keycloak in production:

    1. rebuild Keycloak:

      • /opt/poolparty/auth_service/keycloak/bin/kc.sh build

    2. start Keycloak to verify that is starts without any problems:

      • /opt/poolparty/auth_service/keycloak/bin/kc.sh start

  5. Open the Keycloak configuration files for the individual PoolParty components (admin-keycloak.json, ppgs-keycloak.json, ppt-keycloak.json, ppx-keycloak.json):

    • /opt/poolparty/config/keycloak

  6. Change the port to match the port number you specified in step 3.

  7. If you configure PoolParty using environment variables:

    1. Open the .env file

    2. Change the port number in the PP_auth_server_url property to match the port number you specified in step 3.

  8. Start all PoolParty services:

    • /opt/poolparty/bin/poolparty start

In this section: