Change HTTP/HTTPS Ports

Helmut4 uses traefik as a reverse proxy to manage all incoming and outgoing connections. This simplifies firewall configuration by requiring only ports 80 (HTTP) or 443 (HTTPS), depending on whether communication is encrypted.

If another application on the host is already using one or both of these ports, you must change the default ports for Helmut4 to alternatives, such as 8080 for HTTP or 8443 for HTTPS.

Please refer to this article first to ensure that the desired target port is unused and available: Resolving Port Conflicts

Configuration Steps

  1. Access the YAML Editor Navigate to the YAML editor in the Helmut4 stack configuration.

  2. Locate the Traefik Configuration Find the following section in the traefik configuration: 

    traefik:
  # Additional configuration lines
  ports:
    - mode: host
      protocol: tcp
      published: 80
      target: 80
    - mode: host
      protocol: tcp
      published: 443
      target: 443

  3. Modify the Published Ports Update the published ports to your desired values. For example:

    traefik:
  # Additional configuration lines
  ports:
    - mode: host
      protocol: tcp
      published: 8080
      target: 80
    - mode: host
      protocol: tcp
      published: 8443
      target: 443

  4. Verify Port Availability Before making these changes, ensure the new ports are not in use by other applications or reserved by services. For a list of well-known ports, refer to: List of TCP and UDP Port Numbers.

These steps will reconfigure traefik to use the specified ports, avoiding conflicts with other applications.

Last updated