HAProxy

You can inspect the HAProxy statistics and status page by navigating to /haproxy on your Immich instance (e.g., http://your.domain.name/haproxy). This page can be useful for troubleshooting or getting an overview of the installation's operational status. The HAProxy configuration file used by Immich Distribution can be inspected here.

Enable https frontend

sudo snap set immich-distribution https-enabled="true"

The command above enables the TLS frontend in HAProxy. This is automatically enabled if you configure HTTPS with Let's Encrypt.

Change port numbers

By default, HAProxy listens on *:80 (all network interfaces, TCP port 80) for HTTP traffic, and *:443 for HTTPS traffic if enabled. If you need to change these default ports (e.g., if they are already in use by another service), you can update the following configuration keys:

Use port 8880 for HTTP traffic

sudo snap set immich-distribution haproxy-http-bind="*:8880"

Use port 4443 for HTTPS traffic

sudo snap set immich-distribution haproxy-https-bind="*:4443"

Loading screen

The loading screen shown when Immich services are starting or down uses HAProxy statistics to display its information.