Files
immich-magic-proxy/docs/kubernetes.md
T
Thies ef1b05e88e Update kubernetes.md to provide updated documentation
Instead of using an Umbrella Chart, we can simply hook into the common chart immich already uses, and just extend the server part of it.

The old guide was based on immich chart version 0.9, we are at 0.13.1 now. It also references bjw-s common version 1.4, where immich now uses version 5.0.1
2026-08-06 17:12:50 +02:00

91 lines
2.5 KiB
Markdown

# Install with Kubernetes
See the [official Immich docs](https://immich.app/docs/install/kubernetes/) for additional information. This deployment uses the common chart Immich depends on ([bjw-s common library chart](https://github.com/bjw-s-labs/helm-charts/tree/common-5.0.1/charts/library/common)) to extend the deployment as described in the [Immich docs](https://github.com/immich-app/immich-charts/blob/main/README.md)
1. Simply modify the values of your immich deployment in the server section. The next example shows using the new Gateway API HTTPRoute, below you can also find the old Ingress version. This uses
```
server:
enabled: true
route:
main:
enabled: true
kind: HTTPRoute
parentRefs:
- name: gateway
namespace: kube-system
hostnames:
- your-immich-url.com
rules:
- backendRefs:
- name: immich-server-main
port: 2283
immich-public-proxy:
enabled: true
kind: HTTPRoute
parentRefs:
- name: gateway
namespace: kube-system
hostnames:
- your-proxy-url.com
rules:
- backendRefs:
- name: immich-server-immich-public-proxy
port: 3000
controllers:
immich-public-proxy:
containers:
main:
image:
repository: alangrainger/immich-public-proxy
tag: 3.2.0
pullPolicy: IfNotPresent
env:
IMMICH_URL: https://your-immich-url.com // You could also reference the service here
PUBLIC_BASE_URL: https://your-proxy-url.com
service:
immich-public-proxy:
controller: immich-public-proxy
type: ClusterIP
ports:
http:
port: 3000
serviceMonitor: // We modify the ServiceMonitor here, as the bjw-s common chart can get confused with more than 1 service (main and immich-public-proxy)
main:
enabled: false // Set to true if you need metrics
service:
identifier: main
```
Or with Ingress
```
server:
enabled: true
ingress:
main:
enabled: true
hosts:
- host: your-immich-url.com
paths:
- path: /
pathType: Prefix
service:
identifier: main
immich-public-proxy:
enabled: true
hosts:
- host: your-proxy-url.com
paths:
- path: /
pathType: Prefix
service:
identifier: immich-public-proxy
...
```