Quick Start

Setup Progress

Step 1 of 5
•
1

Install dagu

Download and install the single binary

30 seconds

Install the latest version

npm i -g dagu
2

Start the Server

Launch the web UI and scheduler

10 seconds

Start server and scheduler on http://localhost:8080

dagu start-all
3

Create Your First DAG

Write a simple workflow in YAML

1 minute

Create a simple workflow file

cat > hello.yaml << 'EOF'
name: hello-world
params:
  - NAME: "dagu"
steps:
  - name: greet
    command: echo "Hello from ${NAME}!"
  - name: done
    command: echo "Workflow completed! 🎉"
    depends: greet
EOF
4

Run the Workflow

Execute your first DAG

30 seconds

Run the workflow

dagu start hello.yaml

Check the status

dagu status hello.yaml
5

Explore the UI

View your workflow in the browser

2 minutes

Open the web UI in your browser

open http://localhost:8080

Alternative Installation Methods

Homebrew

macOS

brew install dagu-org/brew/dagu

Docker

All platforms

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

Specific Version

All platforms

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