alangrainger/immich-public-proxy v1.5.0

1.5.0

on GitHub

Significant changes

All paths now begin with /share/

This gives you the option of serving both IPP and Immich from the same domain, by directing all /share/* paths to IPP on your reverse proxy. This is not a breaking change as all previous paths still work, but you'll want to move your healthcheck to point to /share/healthcheck rather than /healthcheck.

Here is an example configuration for Caddy to serve both IPP and Immich from the same domain (again, this is only optional):

https://your-domain.com {
    # Immich Public Proxy paths
    @public path /share /share/*
    handle @public {
        # Your IPP server and port
        reverse_proxy your_server:3000
    }
    
    # All other paths, require basic auth and send to Immich
    handle {
        basicauth {
            user password_hash
        }
        # Your Immich server and port
        reverse_proxy your_server:2283
    }
}

Installing Immich Public Proxy

1. Download the docker-compose.yml file.

2. Update the value for IMMICH_URL in your docker-compose file to point to your local URL for Immich. This should not be a public URL.

3. Start the docker container. You can test that it is working by visiting https://YOUR_PROXY_URL.com/share/healthcheck.
   Check the container console output for any error messages.

docker-compose up -d

1. Set the "External domain" in your Immich Server Settings to be whatever domain you use to publicly serve Immich Public Proxy:

Now whenever you share an image or gallery through Immich, it will automatically create the correct public path for you.