Heimdall
Helm chart for deploying Heimdall application dashboard on Kubernetes using the linuxserver/heimdall Docker image.
Key Features
- LinuxServer.io image based on
linuxserver/heimdall - Persistent storage SQLite database and settings in
/config - S3-compatible backup CronJob that archives
/configand uploads to any S3 endpoint - PUID/PGID file ownership control
- Ingress support configurable ingress with TLS
Installation
HTTPS Repository
helm repo add helmforge https://repo.helmforge.dev
helm repo update
helm install heimdall helmforge/heimdall
OCI Registry
helm install heimdall oci://ghcr.io/helmforgedev/helm/heimdall
Basic Example
heimdall:
timezone: 'America/New_York'
ingress:
enabled: true
ingressClassName: traefik
hosts:
- host: dashboard.example.com
paths:
- path: /
pathType: Prefix
tls:
- secretName: heimdall-tls
hosts:
- dashboard.example.com
backup:
enabled: true
schedule: '0 3 * * *'
s3:
endpoint: https://s3.amazonaws.com
bucket: my-backups
prefix: heimdall
existingSecret: heimdall-s3-credentials
Key Values
| Key | Default | Description |
|---|---|---|
heimdall.puid | 1000 | User ID for file permissions |
heimdall.pgid | 1000 | Group ID for file permissions |
heimdall.timezone | "UTC" | Timezone |
persistence.enabled | true | Enable persistent storage for /config |
persistence.size | 1Gi | Volume size |
backup.enabled | false | Enable S3 backup CronJob |
backup.schedule | "0 3 * * *" | Cron schedule |
backup.s3.endpoint | "" | S3-compatible endpoint URL |
backup.s3.bucket | "" | S3 bucket name |
backup.s3.existingSecret | "" | Existing secret with S3 credentials |
service.type | ClusterIP | Service type |
ingress.enabled | false | Enable ingress |
ingress.ingressClassName | "" | Ingress class (traefik, nginx, etc.) |