orlybot
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.

On this page