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

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.