mirror of
https://github.com/immich-app/immich.git
synced 2025-06-17 12:34:32 -04:00
3b1f27b674
* docs: Make some room in sidebar ordering * docs(install): Add kubernetes deployment documentation
24 lines
1.0 KiB
Markdown
24 lines
1.0 KiB
Markdown
---
|
|
sidebar_position: 40
|
|
---
|
|
|
|
# Kubernetes
|
|
|
|
You can deploy Immich on Kubernetes using [the official Helm chart](https://github.com/immich-app/immich-charts/tree/main/charts/apps/immich).
|
|
|
|
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.
|
|
|
|
:::caution DNS in Alpine containers
|
|
Immich makes use of Alpine container images. These can encounter [a DNS resolution bug](https://stackoverflow.com/a/65593511) 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.
|
|
::: |