---
title: "Deploy Hatchet"
description: "Hatchet Lite 0.107 durable task queue and workflow engine on Postgres."
category: "Queues"
url: https://railway.com/deploy/hatchet-1
---

# Deploy Hatchet

Hatchet Lite 0.107 durable task queue and workflow engine on Postgres.

**[Deploy Hatchet on Railway](https://railway.com/template/hatchet-1)**

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

- **Creator:** Agaz Self-Host
- **Category:** Queues

## Template content

### hatchet https://github.com/hatchet-dev.png

- **Image:** ghcr.io/hatchet-dev/hatchet/hatchet-lite:v0.107.2
- **Health check:** /api/ready
- **Public domain:** Yes

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

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

## Documentation

# 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](https://docs.hatchet.run/)
- [Hatchet Lite](https://docs.hatchet.run/self-hosting/hatchet-lite)
- [Hatchet v0.107.2 release](https://github.com/hatchet-dev/hatchet/releases/tag/v0.107.2)
- [Railway TCP proxy](https://docs.railway.com/reference/tcp-proxy)

### Implementation Details

| Service | Image | Networking | Storage |
| --- | --- | --- | --- |
| hatchet | `ghcr.io/hatchet-dev/hatchet/hatchet-lite:v0.107.2` | public dashboard on 8888; TCP proxy to gRPC 7077 | volume at `/config` |
| Postgres | Railway Postgres 18 | private only | volume |

```bash
export HATCHET_CLIENT_TOKEN=
export HATCHET_CLIENT_TLS_STRATEGY=none
python worker.py
```

| Variable | Default | Purpose |
| --- | --- | --- |
| `ADMIN_EMAIL` / `ADMIN_PASSWORD` | `admin@example.com` / generated | Seeded admin |
| `SERVER_ALLOW_SIGNUP` | `false` | Public sign-up |
| `SERVER_GRPC_BROADCAST_ADDRESS` | TCP proxy address | gRPC address embedded in API tokens |

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.


## Similar templates

- [smoothmq](https://railway.com/deploy/AJv-64) — A drop-in replacement for AWS SQS
- [Kafka UI](https://railway.com/deploy/kafka-ui) — Kafbat UI — Open-source web UI to monitor and manage Apache Kafka clusters
- [NATS + JetStream](https://railway.com/deploy/nats-jetstream) — An open source messaging system that promises at-most-once delivery.

Open this page in a browser: https://railway.com/deploy/hatchet-1