Installation

Install Dagu on your system.

Quick Install

npm

npm install -g dagu

This installs Dagu globally with automatic platform detection.

Script Install

curl -L https://raw.githubusercontent.com/dagu-org/dagu/main/scripts/installer.sh | bash

This detects your OS/architecture and installs to /usr/local/bin.

Docker

docker run -d \
  --name dagu \
  -p 8080:8080 \
  -v ~/.dagu:/var/lib/dagu \
  ghcr.io/dagu-org/dagu:latest \
  dagu start-all

Visit http://localhost:8080

Package Managers

npm

npm install -g dagu

Homebrew

brew install dagu-org/brew/dagu

Manual Download

Download from GitHub Releases.

Installation Options

Custom Directory

# Install to custom location
curl -L https://raw.githubusercontent.com/dagu-org/dagu/main/scripts/installer.sh | \
  bash -s -- --prefix ~/bin

# Specific version
curl -L https://raw.githubusercontent.com/dagu-org/dagu/main/scripts/installer.sh | \
  bash -s -- --version v1.17.0

Docker Compose

services:
  dagu:
    image: ghcr.io/dagu-org/dagu:latest
    ports:
      - "8080:8080"
    environment:
      - DAGU_TZ=America/New_York
      - DAGU_PORT=8080 # optional. default is 8080
      - DAGU_HOME=/dagu # optional.
      - PUID=1000 # optional. default is 1000
      - PGID=1000 # optional. default is 1000
    volumes:
      - dagu:/var/lib/dagu
volumes:
  dagu: {}

Run with docker compose up -d.

Docker with Host Docker Access

For Docker executor support:

services:
  dagu:
    image: ghcr.io/dagu-org/dagu:latest
    ports:
      - "8080:8080"
    volumes:
      - dagu:/var/lib/dagu
      - /var/run/docker.sock:/var/run/docker.sock
    user: "0:0"
volumes:
  dagu: {}

⚠️ Security: Mounting Docker socket grants full Docker access.

Build from Source

Requirements:

• Go 1.24+
• Node.js & pnpm
• Make

git clone https://github.com/dagu-org/dagu.git
cd dagu

# Build everything
make build

# Install
sudo cp .local/bin/dagu /usr/local/bin/

Development:

make ui          # Build frontend
make test        # Run tests
make run         # Start with hot reload

Directory Structure

Dagu uses standard locations:

~/.config/dagu/
├── dags/         # Workflows
├── config.yaml   # Configuration
└── base.yaml     # Shared config

~/.local/share/dagu/
├── logs/         # Execution logs
├── data/         # History
└── suspend/      # Pause flags

Override with environment variables:

export DAGU_HOME=/opt/dagu           # All-in-one directory
export DAGU_DAGS_DIR=/workflows      # Custom workflow location
export DAGU_LOG_DIR=/var/log/dagu    # Custom log location
export DAGU_DATA_DIR=/var/lib/dagu    # Custom data location

Verify Installation

dagu version

Next Steps

• Quick Start - Create your first workflow
• Configuration - Customize Dagu
• Web UI - Explore the interface