Hub 2023.3 Help

Configure the Network Interface Binding

By default, the Jetty servlet engine and HTTP server used in Hub bind on the 0.0.0.0 network interface. For security reasons, this action may be restricted in some environments.

You can use the configure command to change the listen-address property for your Hub server. Execute this command on behalf of the same OS user that runs the Hub service. This command creates configuration files and folders. The Hub service user must have permission to access the files and folders that are created by this command.

To change the network interface binding for Hub, follow the specific instructions for your installation type:

To customize the network interface binding for a Docker image:

  1. Stop the Hub docker container:

    docker exec <containerId> stop
  2. Run the configure command:

    docker run --rm -it -v <path to conf directory>:/opt/hub/conf \ -v <path to logs directory>:/opt/hub/logs \ jetbrains/hub:<version> \ configure --listen-address=<new network interface address>
  3. Start the Hub docker container:

    docker start <containerId>

To customize the network interface binding for a ZIP distribution:

  1. Stop the Hub service.

  2. Open the command-line interface that is supported by your operating system.

  3. In the command line, change the directory to <Hub installation directory>/bin.

  4. Run the following command:

    hub.sh configure --listen-address=<new network interface address>

  5. Start the Hub service.

Last modified: 20 February 2024