---
title: "Deploy Windmill"
description: "Scripts to workflows, cron jobs, webhooks and internal UIs. Self-hosted"
category: "Automation"
url: https://railway.com/deploy/windmill-3
---

# Deploy Windmill

Scripts to workflows, cron jobs, webhooks and internal UIs. Self-hosted

**[Deploy Windmill on Railway](https://railway.com/template/windmill-3)**

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

- **Creator:** Agaz Self-Host
- **Category:** Automation
- **Total deploys:** 1

## Template content

### Windmill https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/png/windmill.png

- **Source:** https://github.com/aalfath/windmill-railway-template
- **Health check:** /api/version
- **Public domain:** Yes

### Native Worker https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/png/windmill.png

- **Source:** https://github.com/aalfath/windmill-railway-template

### Postgres https://devicons.railway.app/i/postgresql.svg

- **Image:** ghcr.io/railwayapp-templates/postgres-ssl:18

### Worker https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/png/windmill.png

- **Source:** https://github.com/aalfath/windmill-railway-template

## Documentation

# Deploy and Host Windmill on Railway

Windmill is an open-source developer platform that turns scripts into workflows, scheduled jobs, webhooks and internal UIs. You write Python, TypeScript, Go, Bash or SQL in its web editor, and it generates input forms, runs the code on workers and keeps logs and job history. Teams use it as a self-hosted alternative to Retool, Airflow or Zapier.

## About Hosting Windmill

Windmill has an API server that also serves the web UI, workers that pull jobs from a queue, and a PostgreSQL database that stores everything: users, workspaces, scripts, flows, schedules and job results. This template deploys Windmill v1.875.0 as four services. `Windmill` is the server on a public domain. `Worker` runs Python, Bun, Deno, Go and Bash jobs, flows and dependency installs, with a volume that caches installed packages. `Native Worker` runs lightweight native TypeScript and SQL jobs. `Postgres` is on a persistent volume. The services talk over Railway's private network, and the server bootstrap replaces Windmill's default `changeme` admin password before the site opens.

## Common Use Cases

* Turn Python or TypeScript scripts into internal tools with auto-generated forms, shared with your team
* Schedule cron jobs, ETL pipelines and multi-step flows with retries, approvals and error handlers
* Expose scripts as webhooks and HTTP endpoints, or build admin panels and dashboards on top of your databases and APIs

## Dependencies for Windmill Hosting

* PostgreSQL (included, Railway's PostgreSQL on a volume)
* The official `ghcr.io/windmill-labs/windmill` image, pinned to v1.875.0 by digest in the template repository

### Deployment Dependencies

* Windmill self-hosting docs: https://www.windmill.dev/docs/advanced/self_host
* Windmill v1.875.0 release: https://github.com/windmill-labs/windmill/releases/tag/v1.875.0
* Template repository (Dockerfiles, start script, changelog): https://github.com/aalfath/windmill-railway-template

### Implementation Details

**First login.** Open the `Windmill` service's public URL and log in as `admin@windmill.dev` with the value of `WINDMILL_ADMIN_PASSWORD` from the service's Variables tab. If you set `WINDMILL_ADMIN_EMAIL` before the first deploy, use that email instead. Then create your first workspace. You can change the admin's email and password in the UI later.

**Scaling.** Each `Worker` replica runs one job at a time, so add replicas for more parallel jobs. `Native Worker` runs 8 native jobs at once.

**Not included.** The optional LSP sidecar (Python/Go autocompletion in the editor) and Enterprise Edition features are not included. Configure SMTP, SSO and OAuth in Instance settings in the Windmill UI.

**Updates.** All services build from the GitHub repository, which pins the Windmill image by digest. When a new version is tested there, Railway shows you an "update available" notice, and you choose when to apply it. Windmill migrates its database on start, so read the repository's CHANGELOG.md first.

## Why Deploy Windmill 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 Windmill 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/windmill-3
