[Feature]: Reverse proxy documentation and examples (NPM etc.)

[ollioddi]

Feature detail

Hey.

I would like to put Immich behind a reverse proxy (In my case Nginx Proxy Manager), but find it a little bit hard to figure out how to.

Does anyone have examples for configuration with docker compose?

I found this thread on reddit with various tips.

It seems like you shouldn't disable the immich docker network, since it uses it internally but i would like to know the following:

• How can i set a static IP on a custom VLAN
• How should NPM handle the different /api endpoint

I am using Unraid with docker-compose and have Immich running and several Docker networks with different VLANS.

A suggestion would be to add examples to the docs with various reverse proxies.

Let me know if this doesn't fit as a feature request.

Thanks in advance!

Platform

Server

[jrasm91]

Correct, we even have a section (placeholder) for it already: "Guides".

For npm, which is what I use, I just update the immich-proxy container to also use the docker network that the npm container uses. Then the IP/hostname you use for the upstream server is immich-proxy:8080

If all the immich containers are on the same network, then the only "externally available" ip/port you'd need would be proxy container + port 2283. If you hook up the proxy container to the npm network you don't even need that, as you can use the internal service name + port instead.

[nep2ner]

How should one go about implementing this part of the docs with NPM?

All reverse proxies between Immich and the user must forward all headers and set the Host, X-Forwarded-Host, X-Forwarded-Proto and X-Forwarded-For headers to their appropriate values. Additionally, your reverse proxy should allow for big enough uploads. By following these practices, you ensure that all custom reverse proxies are fully compatible with Immich.

[RyGuy994]

anyone got this working?

[notflip]

I do! I got it working with nginx proxy manager. @RyGuy994

[RyGuy994]

@notflip do you have a guide or something I can follow?

[notflip]

@RyGuy994 I sent you an e-mail with 2 loom videos, I'm not sharing it here, I quickly recorded these while working, I didn't have time to blur out my url's etc.

[cryptedx]

@notflip

Hey, would you be so kind to share it also with me. I am having a hard time to get it working.

Many thanks.

[bo0tzz]

https://immich.app/docs/administration/reverse-proxy
https://immich.app/docs/guides/remote-access/