Deploy Windmill

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

Deploy Windmill

Just deployed

/var/lib/postgresql/data

/tmp/windmill/cache

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

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.


Template Content

More templates in this category

View Template
N8N Main + Worker
Deploy and Host N8N with Inactive worker.

jakemerson
121
View Template
Evolution API with n8n
Automate WhatsApp workflows with Evolution API, n8n, and Postgres.

codestorm
113
View Template
Postgres Backup
Cron-based PostgreSQL backup to bucket storage

Railway Templates
867