Installation

Pick the guide for your platform.

• macOS — Homebrew or the guided script installer (LaunchAgent service)
• Linux — Guided script installer with systemd service, or a manual binary
• Windows — PowerShell script installer with optional Windows service
• Docker — docker run, Compose, and mounting the host Docker socket
• Kubernetes — Official Helm chart
• npm — Global install via npm install -g
• Build from source — Go + Node toolchain

Which one should I use?

Situation	Install method
Trying Dagu locally on a laptop	Homebrew (macOS) or script installer (Linux/Windows)
Running a shared server	Script installer with --service yes
Running in a container	Docker
Running on a cluster	Kubernetes (Helm)
CI / reproducible setups	Manual binary download or npm
Developing on Dagu itself	Build from source

What the script installers do

The installer.sh / installer.ps1 / installer.cmd scripts open a guided wizard that can:

• Install the dagu binary
• Add it to your PATH
• Set it up as a background service (systemd on Linux, LaunchAgent on macOS, Windows service on Windows)
• Create and verify the first admin account

Homebrew, npm, Docker, Helm, and manual downloads install the binary only — no wizard, no service, no admin bootstrap.

Where Dagu Keeps Things

After installation, Dagu uses these paths by default. These are the main locations to know when you want to back up workflows, move storage, or inspect logs:

~/.config/dagu/
├── dags/          # Your workflow YAML files
├── config.yaml    # Server configuration
└── base.yaml      # Shared DAG defaults

~/.local/share/dagu/
├── logs/          # Per-run execution logs
├── data/          # Run history and state
└── suspend/       # Suspend flags

Override any path with environment variables:

export DAGU_HOME=/opt/dagu              # all-in-one override
export DAGU_DAGS_DIR=/workflows
export DAGU_LOG_DIR=/var/log/dagu
export DAGU_DATA_DIR=/var/lib/dagu

Verifying the install

dagu version

Then run the Quickstart to create your first workflow.

Uninstalling

The script installers also uninstall. See Uninstall.