Skip to content

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 /config and 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

KeyDefaultDescription
heimdall.puid1000User ID for file permissions
heimdall.pgid1000Group ID for file permissions
heimdall.timezone"UTC"Timezone
persistence.enabledtrueEnable persistent storage for /config
persistence.size1GiVolume size
backup.enabledfalseEnable 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.typeClusterIPService type
ingress.enabledfalseEnable ingress
ingress.ingressClassName""Ingress class (traefik, nginx, etc.)

More Information