immich/docs/docs/install/kubernetes.md

---
sidebar_position: 40
---

# Kubernetes

You can deploy Immich on Kubernetes using [the official Helm chart](https://github.com/immich-app/immich-charts/blob/main/README.md).

You can view some [examples](https://kubesearch.dev/#/immich) of how other people run Immich on Kubernetes, using the official chart or otherwise.

:::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
```

:::
docs(install): Add kubernetes deployment documentation (#1418) * docs: Make some room in sidebar ordering * docs(install): Add kubernetes deployment documentation 2023-01-25 17:07:25 +01:00			`---`
			`sidebar_position: 40`
			`---`

			`# Kubernetes`

chore(docs): Link to helm chart README (#9238) 2024-05-03 14:03:45 +02:00			`You can deploy Immich on Kubernetes using [the official Helm chart](https://github.com/immich-app/immich-charts/blob/main/README.md).`
docs(install): Add kubernetes deployment documentation (#1418) * docs: Make some room in sidebar ordering * docs(install): Add kubernetes deployment documentation 2023-01-25 17:07:25 +01:00
docs: bunch of small changes (#8854) * Update postgres-standalone.md * Update postgres-standalone.md * Update postgres-standalone.md * Update postgres-standalone.md * Update environment-variables.md * Update postgres-standalone.md * Update docker-compose.mdx * Update environment-variables.md * Update FAQ.mdx * Update kubernetes.md * Update kubernetes.md * Update system-settings.md * Update libraries.md * Update supported-formats.md 2024-04-16 18:58:19 -04:00			`You can view some [examples](https://kubesearch.dev/#/immich) of how other people run Immich on Kubernetes, using the official chart or otherwise.`
docs(install): Add kubernetes deployment documentation (#1418) * docs: Make some room in sidebar ordering * docs(install): Add kubernetes deployment documentation 2023-01-25 17:07:25 +01:00
			`:::caution DNS in Alpine containers`
docs: use correct helm chart url (#2133) 2023-03-31 11:25:53 +01:00			`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`
docs(install): Add kubernetes deployment documentation (#1418) * docs: Make some room in sidebar ordering * docs(install): Add kubernetes deployment documentation 2023-01-25 17:07:25 +01:00			`nodes have a search domain set, like:`

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

docs: use correct helm chart url (#2133) 2023-03-31 11:25:53 +01:00			`:::`