Dagu Tutorial

Learn the basics of Dagu in about 40 minutes. Each lesson is one small workflow. Watch a recorded run of it on the page, then run it yourself and change it.

You need a terminal and basic shell skills. No Dagu knowledge is assumed.

01Your first workflow · 4 min02Watch runs in the Web UI · 5 min03Parameters and outputs · 4 min04Built-in actions · 5 min05Branch, skip, and poll · 4 min06Failures and retries · 4 min07Sub-DAGs and fan-out · 4 min08Schedules · 3 min09Approvals and human input · 3 min10Alerts from Dagu Console · 4 min

Set up (2 minutes)

1. Install Dagu

macOS/Linux

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

Windows

irm https://raw.githubusercontent.com/dagucloud/dagu/main/scripts/installer.ps1 | iex

Homebrew

brew install dagu

npm

npm install -g --ignore-scripts=false @dagucloud/dagu

Other methods, including Docker: Installation.

2. Start Dagu in a tutorial folder

mkdir dagu-tutorial && cd dagu-tutorial
dagu start-all --dags .

start-all runs the Web UI and the scheduler together. --dags . tells Dagu to load every workflow file in this folder. Leave it running, and open a second terminal in the same folder for the lessons.

Open http://localhost:8080. On first launch, create the admin account.

In an empty folder, Dagu also adds six example workflows, example-01 to example-06, and a wiki folder. They are not part of the tutorial. Keep or delete them.

Dagu already runs as a service?

If the installer set up a background service, Dagu is already at http://localhost:8080. Skip start-all and run the lesson commands from its DAGs folder instead, ~/.config/dagu/dags by default.

3. Get each lesson's workflow

Every lesson starts with one command that downloads its workflow into the current folder, for example:

curl -fsSLO https://docs.dagu.sh/tutorial/dags/tutorial-01-first-workflow.yaml

The workflow appears in the Web UI under Workflows right away. You can also create a workflow in the Web UI and paste the YAML from the lesson page.

Start with lesson 1: Your first workflow →