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.