Skip to main content

Kubernetes

You can deploy Immich on Kubernetes using the official Helm chart.

If you want examples of how other people run Immich on Kubernetes, using the official chart or otherwise, you can find them at https://nanne.dev/k8s-at-home-search/#/immich.

DNS in Alpine containers

Immich makes use of Alpine container images. These can encounter a DNS resolution bug on Kubernetes clusters if the host nodes have a search domain set, like:

$ cat /etc/resolv.conf
search home.lan
nameserver 192.168.1.1

When you encounter this bug, it will cause the immich-microservices to crash on startup because it cannot download the geocoder data. This can be solved in one of two ways: Either reconfigure your nodes to remove the searchdomain from resolv.conf, or set the DISABLE_REVERSE_GEOCODING environment variable for Immich to true to disable the geocoder.