Manage async job queues (pg-boss).

nself queue <subcommand> [flags] [args]

nself queue inspects and manages the async job system that runs on top of pg-boss in your project's Postgres. Use it to list queues with pending/active/failed/dead counts, drill into individual jobs, retry failed jobs, purge old jobs by age, and list scheduled cron jobs.

queue list summarizes every queue. queue jobs <queue> paginates jobs in a single queue, optionally filtered by --state (pending, active, failed, dead). queue retry <job-id> re-enqueues a job. queue purge <queue> deletes completed/dead jobs older than --older-than (default 30 days) to keep the queue table lean.

queue cron list enumerates registered cron schedules so operators can confirm that scheduled tasks (digests, backups, exports, license refreshes) are wired correctly.

# Summarize every queue
nself queue list

# Drill into the email queue, only failed jobs, top 100
nself queue jobs email --state failed --limit 100

# Retry a single failed job
nself queue retry 0e9b5d9d-3e9e-4b1f-9b0e-ea25c3f9a8e1

# Purge dead jobs older than 7 days from the export queue
nself queue purge export --older-than 168h

# List all scheduled cron jobs
nself queue cron list

• cmd-webhooks, webhook outbox
• cmd-watchdog, self-healing watchdog
• cmd-status, service health
• Commands, full command index

← Commands | Home →