Install on Kubernetes

The official Helm chart deploys Dagu to any Kubernetes 1.19+ cluster.

Prerequisites

• Kubernetes 1.19+
• Helm 3.0+
• A StorageClass that supports ReadWriteMany — Dagu persists state on a shared filesystem that must be readable/writable by multiple pods (scheduler, server). Examples: NFS (nfs-client-provisioner), AWS EFS, CephFS, Azure Files Premium, GlusterFS.

Install

helm repo add dagu https://dagucloud.github.io/dagu
helm repo update
helm install dagu dagu/dagu --set persistence.storageClass=<your-rwx-storage-class>

If your cluster's default StorageClass already supports ReadWriteMany, you can drop the --set persistence.storageClass=... flag.

Render manifests without installing

helm template dagu dagu/dagu --set persistence.storageClass=<your-rwx-storage-class>

Upgrade

helm repo update
helm upgrade dagu dagu/dagu --set persistence.storageClass=<your-rwx-storage-class>

From a source checkout

git clone https://github.com/dagucloud/dagu.git
cd dagu
helm install dagu ./charts/dagu --set persistence.storageClass=<your-rwx-storage-class>

Image and version

• Chart version comes from charts/dagu/Chart.yaml.

• Container image comes from values.yaml — defaults to ghcr.io/dagucloud/dagu:latest. Pin a specific tag in production:

  helm install dagu dagu/dagu \
    --set persistence.storageClass=<rwx-class> \
    --set image.tag=vX.Y.Z

Full configuration

All values are documented in charts/dagu/README.md and validated against values.schema.json.

Verify

kubectl get pods -l app.kubernetes.io/name=dagu
kubectl port-forward svc/dagu 8080:8080
# visit http://localhost:8080

Next: Quickstart.