immich-server helm

Immich is a self-hosted photo and video backup solution.

For immich, there are multiple helm deployments:

For redis and postgres, there are multiple helm charts:

More popular helm chart found

immich-server from bjw-s/helm/ is more popular with 18 repositories.

Install

Install with:

helm repo add app-template oci://ghcr.io/bjw-s-labs/helm/app-template
helm install immich-server app-template/app-template -f values.yaml

Examples

See examples from other people.

Top Repositories (3 out of 7)

NameRepoStarsVersionTimestamp
immich-serverbudimanjojo/home-cluster1964.0.116 hours ago
immich-serverahinko/home-ops2183.7.310 days ago
immich-serverdrag0n141/home-ops373.7.319 days ago

Values

See the most popular values for this chart:

KeyTypes
persistence.library.globalMounts[].path (6)
/usr/src/app/upload
string
persistence.library.globalMounts[].subPath (1)
img/immich
string
persistence.library.type (4)
nfs
string
persistence.library.existingClaim (3)
immich-nfs
string
persistence.library.path (3)
/mnt/data/photos
string
persistence.library.server (3)
nas01.${SECRET_DOMAIN_INT}
string
persistence.library.enabled (2)
true
boolean
persistence.geocoding-dump.enabled (2)
true
boolean
persistence.geocoding-dump.globalMounts[].path (2)
/usr/src/app/.reverse-geocoding-dump
string
persistence.geocoding-dump.type (2)
emptyDir
string
persistence.transformers-cache.enabled (2)
true
boolean
persistence.transformers-cache.globalMounts[].path (2)
/usr/src/app/.transformers_cache
string
persistence.transformers-cache.type (2)
emptyDir
string
persistence.data.enabled (1)
true
boolean
persistence.data.existingClaim (1)
immich-data
string
persistence.data.globalMounts[].path (1)
/usr/src/app/upload
string
service.app.controller (5)
immich
string
service.app.ports.http.port (5)
2283
number
service.app.ports.metrics.port (3)
8081
number
service.main.controller (2)
immich-server
string
service.main.ports.http.port (2)
2283
number
route.app.hostnames[] (4)
- photos.hemma.dev
string
route.app.parentRefs[].name (4)
external
string
route.app.parentRefs[].namespace (4)
kube-system
string
route.app.parentRefs[].sectionName (4)
https
string
route.app.rules[].backendRefs[].name (4)
immich-server
string
route.app.rules[].backendRefs[].port (4)
2283
number
route.main.hostnames[] (1)
- photos.${SECRET_DOMAIN_0}
string
route.main.parentRefs[].name (1)
external
string
route.main.parentRefs[].namespace (1)
networking-system
string
route.main.parentRefs[].port (1)
443
number
route.main.rules[].backendRefs[].name (1)
immich-server
string
route.main.rules[].backendRefs[].port (1)
2283
number
controllers.immich-server.containers.app.envFrom[].configMapRef.name (3)
immich-configmap
string
controllers.immich-server.containers.app.envFrom[].secretRef.name (2)
immich-secret
string
controllers.immich-server.containers.app.image.repository (3)
ghcr.io/immich-app/immich-server
string
controllers.immich-server.containers.app.image.tag (3)
v1.132.3
string
controllers.immich-server.containers.app.image.pullPolicy (1)
IfNotPresent
string
controllers.immich-server.containers.app.resources.requests.cpu (3)
100m
string
controllers.immich-server.containers.app.resources.requests.memory (3)
256Mi
string
controllers.immich-server.containers.app.resources.limits.memory (2)
4096Mi
string
controllers.immich-server.containers.app.env.SERVER_PORT (2)
2283
number
controllers.immich-server.containers.app.env.DB_DATABASE_NAME (1)
immich
string
controllers.immich-server.containers.app.env.DB_HOSTNAME (1)
postgres16-rw.databases.svc.cluster.local
string
controllers.immich-server.containers.app.env.DB_PASSWORD.valueFrom.secretKeyRef.key (1)
DB_PASSWORD
string
controllers.immich-server.containers.app.env.DB_PASSWORD.valueFrom.secretKeyRef.name (1)
immich-secret
string
controllers.immich-server.containers.app.env.DB_PORT (1)
5432
number
controllers.immich-server.containers.app.env.DB_USERNAME.valueFrom.secretKeyRef.key (1)
DB_USERNAME
string
controllers.immich-server.containers.app.env.DB_USERNAME.valueFrom.secretKeyRef.name (1)
immich-secret
string
controllers.immich-server.containers.app.env.IMMICH_MEDIA_LOCATION (1)
/usr/src/app/upload
string
controllers.immich-server.containers.app.env.LOG_LEVEL (1)
verbose
string
controllers.immich-server.containers.app.probes.liveness.custom (2)
true
boolean
controllers.immich-server.containers.app.probes.liveness.enabled (2)
true
boolean
controllers.immich-server.containers.app.probes.liveness.spec.failureThreshold (2)
3
number
controllers.immich-server.containers.app.probes.liveness.spec.httpGet.path (2)
/api/server/ping
string
controllers.immich-server.containers.app.probes.liveness.spec.httpGet.port (2)
2283
number
controllers.immich-server.containers.app.probes.liveness.spec.initialDelaySeconds (2)
0
number
controllers.immich-server.containers.app.probes.liveness.spec.periodSeconds (2)
10
number
controllers.immich-server.containers.app.probes.liveness.spec.timeoutSeconds (2)
1
number
controllers.immich-server.containers.app.probes.readiness.custom (2)
true
boolean
controllers.immich-server.containers.app.probes.readiness.enabled (2)
true
boolean
controllers.immich-server.containers.app.probes.readiness.spec.failureThreshold (2)
3
number
controllers.immich-server.containers.app.probes.readiness.spec.httpGet.path (2)
/api/server/ping
string
controllers.immich-server.containers.app.probes.readiness.spec.httpGet.port (2)
2283
number
controllers.immich-server.containers.app.probes.readiness.spec.initialDelaySeconds (2)
0
number
controllers.immich-server.containers.app.probes.readiness.spec.periodSeconds (2)
10
number
controllers.immich-server.containers.app.probes.readiness.spec.timeoutSeconds (2)
1
number
controllers.immich-server.containers.app.probes.startup.custom (2)
true
boolean
controllers.immich-server.containers.app.probes.startup.enabled (2)
true
boolean
controllers.immich-server.containers.app.probes.startup.spec.failureThreshold (2)
30
number
controllers.immich-server.containers.app.probes.startup.spec.httpGet.path (2)
/api/server/ping
string
controllers.immich-server.containers.app.probes.startup.spec.httpGet.port (2)
2283
number
controllers.immich-server.containers.app.probes.startup.spec.periodSeconds (2)
5
number
controllers.immich-server.containers.app.probes.startup.spec.successThreshold (2)
1
number
controllers.immich-server.containers.app.probes.startup.spec.timeoutSeconds (2)
1
number
controllers.immich-server.containers.main.env.DB_URL.valueFrom.secretKeyRef.key (1)
uri
string
controllers.immich-server.containers.main.env.DB_URL.valueFrom.secretKeyRef.name (1)
immich-database-pguser-immich
string
controllers.immich-server.containers.main.envFrom[].configMapRef.name (1)
immich-config
string
controllers.immich-server.containers.main.envFrom[].secretRef.name (1)
immich-secret
string
controllers.immich-server.containers.main.image.repository (1)
ghcr.io/immich-app/immich-server
string
controllers.immich-server.containers.main.image.tag (1)
v1.132.3
string
controllers.immich-server.containers.main.probes.liveness.enabled (1)
true
boolean
controllers.immich-server.containers.main.probes.readiness.enabled (1)
true
boolean
controllers.immich-server.containers.main.probes.startup.enabled (1)
true
boolean
controllers.immich-server.containers.main.probes.startup.spec.failureThreshold (1)
30
number
controllers.immich-server.containers.main.probes.startup.spec.periodSeconds (1)
5
number
controllers.immich-server.containers.main.resources.limits.memory (1)
1000Mi
string
controllers.immich-server.containers.main.resources.requests.cpu (1)
100m
string
controllers.immich-server.containers.main.resources.requests.memory (1)
250Mi
string
controllers.immich-server.annotations."configmap.reloader.stakater.com/reload" (2)
immich-configmap
string
controllers.immich-server.annotations."reloader.stakater.com/auto" (2)
true
string
controllers.immich-server.annotations."secret.reloader.stakater.com/reload" (2)
immich-secret
string
controllers.immich-server.initContainers.01-init-db.envFrom[].configMapRef.name (1)
immich-configmap
string
controllers.immich-server.initContainers.01-init-db.envFrom[].secretRef.name (1)
immich
string
controllers.immich-server.initContainers.01-init-db.image.repository (1)
ghcr.io/home-operations/postgres-init
string
controllers.immich-server.initContainers.01-init-db.image.tag (1)
17.4.0
string
controllers.immich-server.pod.enableServiceLinks (1)
false
boolean
controllers.immich-server.pod.nodeSelector."kubernetes.io/hostname" (1)
s01
string
controllers.immich-server.pod.topologySpreadConstraints[].labelSelector.matchLabels."app.kubernetes.io/name" (1)
immich-server
string
controllers.immich-server.pod.topologySpreadConstraints[].maxSkew (1)
1
number
controllers.immich-server.pod.topologySpreadConstraints[].topologyKey (1)
kubernetes.io/hostname
string
controllers.immich-server.pod.topologySpreadConstraints[].whenUnsatisfiable (1)
DoNotSchedule
string
controllers.immich-server.strategy (1)
RollingUpdate
string
controllers.immich-server.type (1)
statefulset
string
controllers.immich.annotations."reloader.stakater.com/auto" (3)
true
string
controllers.immich.containers.app.env.IMMICH_WORKERS_INCLUDE (3)
api
string
controllers.immich.containers.app.env.TZ (3)
${TIMEZONE}
string
controllers.immich.containers.app.env.IMMICH_METRICS_INCLUDE (2)
all
string
controllers.immich.containers.app.env.DB_URL.valueFrom.secretKeyRef.key (1)
uri
string
controllers.immich.containers.app.env.DB_URL.valueFrom.secretKeyRef.name (1)
immich-pguser-immich
string
controllers.immich.containers.app.env.SERVER_PORT (1)
2283
number
controllers.immich.containers.app.envFrom[].secretRef.name (3)
immich-secret
string
controllers.immich.containers.app.envFrom[].configMapRef.name (2)
immich-configmap
string
controllers.immich.containers.app.image.repository (3)
ghcr.io/immich-app/immich-server
string
controllers.immich.containers.app.image.tag (3)
v1.132.3@sha256:6680d88486251b0264a78a1934fe82eef875555aa6d84d703a0980328a5d5c31
string
controllers.immich.containers.app.probes.liveness.custom (3)
true
boolean
controllers.immich.containers.app.probes.liveness.enabled (3)
true
boolean
controllers.immich.containers.app.probes.liveness.spec.failureThreshold (3)
3
number
controllers.immich.containers.app.probes.liveness.spec.httpGet.path (3)
/api/server/ping
string
controllers.immich.containers.app.probes.liveness.spec.httpGet.port (3)
2283
number
controllers.immich.containers.app.probes.liveness.spec.initialDelaySeconds (3)
0
number
controllers.immich.containers.app.probes.liveness.spec.periodSeconds (3)
10
number
controllers.immich.containers.app.probes.liveness.spec.timeoutSeconds (3)
1
number
controllers.immich.containers.app.probes.readiness.custom (3)
true
boolean
controllers.immich.containers.app.probes.readiness.enabled (3)
true
boolean
controllers.immich.containers.app.probes.readiness.spec.failureThreshold (3)
3
number
controllers.immich.containers.app.probes.readiness.spec.httpGet.path (3)
/api/server/ping
string
controllers.immich.containers.app.probes.readiness.spec.httpGet.port (3)
2283
number
controllers.immich.containers.app.probes.readiness.spec.initialDelaySeconds (3)
0
number
controllers.immich.containers.app.probes.readiness.spec.periodSeconds (3)
10
number
controllers.immich.containers.app.probes.readiness.spec.timeoutSeconds (3)
1
number
controllers.immich.containers.app.probes.startup.custom (3)
true
boolean
controllers.immich.containers.app.probes.startup.enabled (3)
true
boolean
controllers.immich.containers.app.probes.startup.spec.failureThreshold (3)
30
number
controllers.immich.containers.app.probes.startup.spec.httpGet.path (3)
/api/server/ping
string
controllers.immich.containers.app.probes.startup.spec.httpGet.port (3)
2283
number
controllers.immich.containers.app.probes.startup.spec.periodSeconds (3)
5
number
controllers.immich.containers.app.probes.startup.spec.successThreshold (3)
1
number
controllers.immich.containers.app.probes.startup.spec.timeoutSeconds (3)
1
number
controllers.immich.containers.app.resources.limits.memory (3)
4Gi
string
controllers.immich.containers.app.resources.requests.cpu (3)
10m
string
controllers.immich.containers.app.resources.requests.memory (3)
150Mi
string
controllers.immich.containers.app.securityContext.allowPrivilegeEscalation (3)
false
boolean
controllers.immich.containers.app.securityContext.capabilities.drop[] (3)
- ALL
string
controllers.immich.containers.app.securityContext.readOnlyRootFilesystem (3)
true
boolean
controllers.immich.strategy (3)
RollingUpdate
string
controllers.immich.pod.enableServiceLinks (2)
false
boolean
controllers.immich.pod.securityContext.fsGroup (2)
568
number
controllers.immich.pod.securityContext.fsGroupChangePolicy (2)
OnRootMismatch
string
controllers.immich.pod.securityContext.runAsGroup (2)
568
number
controllers.immich.pod.securityContext.runAsUser (2)
568
number
controllers.immich.pod.topologySpreadConstraints[].labelSelector.matchLabels."app.kubernetes.io/name" (1)
immich-server
string
controllers.immich.pod.topologySpreadConstraints[].maxSkew (1)
1
number
controllers.immich.pod.topologySpreadConstraints[].topologyKey (1)
topology.kubernetes.io/zone
string
controllers.immich.pod.topologySpreadConstraints[].whenUnsatisfiable (1)
DoNotSchedule
string
controllers.immich.labels.nfsMount (1)
true
string
controllers.immich.replicas (1)
2
number
defaultPodOptions.securityContext.fsGroup (3)
100
number
defaultPodOptions.securityContext.fsGroupChangePolicy (3)
OnRootMismatch
string
defaultPodOptions.securityContext.runAsGroup (3)
100
number
defaultPodOptions.securityContext.runAsUser (3)
1003
number
defaultPodOptions.securityContext.runAsNonRoot (1)
true
boolean
defaultPodOptions.securityContext.supplementalGroups[] (1)
- "1000"
- "568"
number
defaultPodOptions.enableServiceLinks (2)
false
boolean
defaultPodOptions.topologySpreadConstraints[].labelSelector.matchLabels."app.kubernetes.io/name" (1)
immich-server
string
defaultPodOptions.topologySpreadConstraints[].maxSkew (1)
1
number
defaultPodOptions.topologySpreadConstraints[].topologyKey (1)
kubernetes.io/hostname
string
defaultPodOptions.topologySpreadConstraints[].whenUnsatisfiable (1)
DoNotSchedule
string
serviceMonitor.app.endpoints[].interval (3)
1m
string
serviceMonitor.app.endpoints[].path (3)
/metrics
string
serviceMonitor.app.endpoints[].port (3)
metrics
string
serviceMonitor.app.endpoints[].scheme (3)
http
string
serviceMonitor.app.endpoints[].scrapeTimeout (3)
10s
string
serviceMonitor.app.serviceName (3)
immich
string
ingress.app.className (2)
external
string
ingress.app.hosts[].host (2)
photos.${SECRET_DOMAIN}
string
ingress.app.hosts[].paths[].path (2)
/
string
ingress.app.hosts[].paths[].service.identifier (2)
app
string
ingress.app.hosts[].paths[].service.port (2)
http
string
ingress.app.hosts[].paths[].pathType (1)
Prefix
string
ingress.app.annotations."external-dns.alpha.kubernetes.io/cloudflare-proxied" (1)
false
string
ingress.app.annotations."external-dns.alpha.kubernetes.io/exclude-unifi" (1)
true
string
ingress.app.annotations."external-dns.alpha.kubernetes.io/target" (1)
ipv4.${SECRET_DOMAIN}
string
ingress.app.annotations."gethomepage.dev/description" (1)
Photo management and backup
string
ingress.app.annotations."gethomepage.dev/enabled" (1)
true
string
ingress.app.annotations."gethomepage.dev/group" (1)
media
string
ingress.app.annotations."gethomepage.dev/icon" (1)
sh-immich.svg
string
ingress.app.annotations."gethomepage.dev/name" (1)
immich
string
ingress.app.annotations."nginx.ingress.kubernetes.io/configuration-snippet" (1)
chunked_transfer_encoding off;
string
ingress.app.annotations."nginx.ingress.kubernetes.io/proxy-body-size" (1)
1024m
string
ingress.app.annotations."nginx.ingress.kubernetes.io/proxy-connect-timeout" (1)
180
string
ingress.app.annotations."nginx.ingress.kubernetes.io/proxy-request-buffering" (1)
off
string
ingress.app.annotations."traefik.ingress.kubernetes.io/router.entrypoints" (1)
websecure
string
ingress.app.annotations."traefik.ingress.kubernetes.io/router.middlewares" (1)
networking-traefik-middleware-chain-no-rate-limit@kubernetescrd
string
ingress.app.tls[].hosts[] (1)
- photos.${SECRET_DOMAIN}
string
ingress.app.tls[].secretName (1)
${SECRET_DOMAIN/./-}-production-tls
string