orlybot docsSelf-hosting
Workers and tasks
Operate the queue consumer and inspect durable background work.
Workers and tasks
The HTTP server enqueues jobs but does not consume queues. Run bun run worker for BullMQ processors and the reconciler.
Add durable work
Use enqueueBackgroundTask() for durable work. Add the job name and type, wire its processor, and keep the full status and payload in Postgres.
Observe work
Use the worker debug pages to inspect tasks and operations. Worker heartbeats are stored in Valkey so replicas can report liveness.
Recover safely
The reconciler periodically identifies stale running tasks. Configure its interval and batch size through the worker environment variables.