---
title: "Deploy dagu"
description: "Dagu 2.17: workflow engine with a web UI for YAML DAGs and cron jobs."
category: "Automation"
url: https://railway.com/deploy/dagu-1
---

# Deploy dagu

Dagu 2.17: workflow engine with a web UI for YAML DAGs and cron jobs.

**[Deploy dagu on Railway](https://railway.com/template/dagu-1)**

Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/dagu-1/manifest.json

- **Creator:** Agaz Self-Host
- **Category:** Automation

## Template content

### dagu https://avatars.githubusercontent.com/u/131097250

- **Image:** ghcr.io/dagucloud/dagu:2.17.0
- **Start command:** `sh -c 'chown -R ${PUID:-1000}:${PGID:-1000} /var/lib/dagu; exec /usr/local/bin/tini -s -g -- /entrypoint.sh dagu start-all'`
- **Health check:** /api/v1/health
- **Public domain:** Yes

## Documentation

# Deploy and Host Dagu on Railway

Dagu is a workflow engine with a web UI. You describe jobs as simple YAML files, with steps, dependencies, schedules, retries and parameters, and Dagu runs them, shows live logs and keeps the run history. It is a lighter alternative to Airflow or plain cron for scripts, data jobs and operations tasks.

## About Hosting Dagu

This template runs the official `ghcr.io/dagucloud/dagu:2.17.0` image as one service. Built-in authentication is on: an admin user is created on first boot from the variables, and the API and UI reject requests without a valid login. DAG files, run history, logs and users live on a Railway volume, so everything survives redeploys. The start command hands the volume to the `dagu` user, so the server runs as UID 1000. Steps run inside this container, so install any tools your scripts need, or call other services over Railway's private network. The service needs about 100 MB of memory plus whatever your jobs use.

## Common Use Cases

- Scheduling scripts and cron jobs with logs and retries in one place
- Small data pipelines built from shell, Python or HTTP steps
- Operations runbooks that teammates can trigger from a web UI

## Dependencies for Dagu Hosting

- `ghcr.io/dagucloud/dagu:2.17.0` (official image)
- A Railway volume at `/var/lib/dagu`

### Deployment Dependencies

- [Dagu on GitHub](https://github.com/dagu-org/dagu)
- [Dagu documentation](https://docs.dagu.cloud)
- [Dagu 2.17.0 release](https://github.com/dagu-org/dagu/releases/tag/v2.17.0)

### Implementation Details

| Service | Source | Networking | Storage |
| --- | --- | --- | --- |
| dagu | `ghcr.io/dagucloud/dagu:2.17.0` | public domain on 8080 | volume at `/var/lib/dagu` |

| Variable | Default | Purpose |
| --- | --- | --- |
| `DAGU_AUTH_MODE` | `builtin` | Login with users stored by Dagu |
| `DAGU_AUTH_BUILTIN_INITIAL_ADMIN_USERNAME` | `admin` | Admin created on first boot |
| `DAGU_AUTH_BUILTIN_INITIAL_ADMIN_PASSWORD` | generated | Its password |
| `DAGU_AUTH_BUILTIN_TOKEN_SECRET` | generated | Signs login tokens |
| `DAGU_TZ` | `UTC` | Time zone for schedules |

Notes:

- The REST API lives under `/api/v1`; get a token from `POST /api/v1/auth/login`.
- The image does not include Docker, so `docker` executor steps will not work on Railway.

This is a community-maintained deployment package and does not imply affiliation with or endorsement by the Dagu project.

## Why Deploy Dagu on Railway?

Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying Dagu on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.


## Similar templates

- [N8N Main + Worker](https://railway.com/deploy/n8n-main-worker) — Deploy and Host N8N with Inactive worker.
- [Evolution API with n8n](https://railway.com/deploy/evolution-api-with-n8n) — Automate WhatsApp workflows with Evolution API, n8n, and Postgres.
- [Postgres Backup](https://railway.com/deploy/postgres-s3-backups) — Cron-based PostgreSQL backup to bucket storage

Open this page in a browser: https://railway.com/deploy/dagu-1