Deploy Hatchet

Deploy and Host Hatchet on Railway

Hatchet is a platform for background tasks and durable workflows built on Postgres. Workers written with the Python, TypeScript or Go SDKs pick up tasks with retries, timeouts, concurrency limits, rate limits, schedules, cron and event triggers, while a dashboard shows every run, its logs and its inputs and outputs.

About Hosting Hatchet

This template deploys Hatchet Lite v0.107.2, the single-container edition with the engine, API and dashboard, backed by a Railway Postgres database. The admin account is seeded from environment variables and public sign-up is disabled. Generated keys live on a Railway volume, so API tokens stay valid across redeploys. Workers connect over gRPC through a Railway TCP proxy from anywhere, or directly on the private network. Create an API token in the dashboard and start a worker. Hatchet Lite suits small and medium workloads on the Hobby plan. Postgres holds all queues and run history, so back it up regularly.

Common Use Cases

• Background jobs and queues for web apps with retries and visibility
• Durable multi-step workflows and AI agent pipelines
• Scheduled and event-driven tasks written in Python, TypeScript or Go

Dependencies for Hatchet Hosting

• ghcr.io/hatchet-dev/hatchet/hatchet-lite:v0.107.2 (official image)
• Railway Postgres (ghcr.io/railwayapp-templates/postgres-ssl:18) with a volume
• A Railway volume at /config
• A Railway TCP proxy for worker gRPC

Deployment Dependencies

• Hatchet documentation
• Hatchet Lite
• Hatchet v0.107.2 release
• Railway TCP proxy

Implementation Details

export HATCHET_CLIENT_TOKEN=
export HATCHET_CLIENT_TLS_STRATEGY=none
python worker.py

Notes:

• gRPC through the TCP proxy is not encrypted; workers on Railway can use HATCHET_CLIENT_HOST_PORT=${{hatchet.HATCHET_CLIENT_HOST_PORT}} to stay on the private network.
• The /config volume holds generated keys; don't delete it.

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

Why Deploy Hatchet 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 Hatchet 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.