Deploy Windmill
Scripts to workflows, cron jobs, webhooks and internal UIs. Self-hosted
Just deployed
Native Worker
Just deployed
Just deployed
/var/lib/postgresql/data
Just deployed
/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/windmillimage, 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.
Template Content