![\"bunqueue\"](\".github/banner.svg\")
\n \n\n \n \n \n
\n ![\"npm](\"https://img.shields.io/npm/v/bunqueue?style=flat-square\")
![\"npm](\"https://img.shields.io/npm/dm/bunqueue?style=flat-square\")
![\"CI\"](\"https://img.shields.io/github/actions/workflow/status/egeominotti/bunqueue/ci.yml?style=flat-square&label=CI\")
![\"GitHub](\"https://img.shields.io/github/stars/egeominotti/bunqueue?style=flat-square\")
![\"License\"](\"https://img.shields.io/github/license/egeominotti/bunqueue?style=flat-square\")
\n High-performance job queue for Bun. Memory or one-file SQLite; PostgreSQL 15–18 multi-broker when you scale.
\n DLQ, cron, SQLite S3 backups, and native MCP. Built for AI agents and automation. No Redis.\n
\n Documentation ·\n Quick Start ·\n Benchmarks ·\n npm\n
\n\n---\n\n## Quickstart\n\n```bash\nbun add bunqueue\n```\n\n```typescript\nimport { Bunqueue } from 'bunqueue/client';\n\nconst app = new Bunqueue('emails', {\n embedded: true,\n dataPath: './data/emails.db', // omit to run in-memory (lost on restart)\n processor: async (job) => {\n console.log(`Sending to ${job.data.to}`);\n return { sent: true };\n },\n});\n\nawait app.add('send', { to: 'alice@example.com' });\n```\n\nThat's it. Queue + Worker in one object, persisted to a single SQLite file.\nNo Redis, no config, no setup. `msgpackr` is the only runtime dependency;\ncron, SQLite, S3, HTTP and WebSocket use Bun's built-ins.\n\n### Not on Bun? Run the server, connect from anywhere\n\nThe queue also runs as a standalone server. Memory is the zero-configuration\ndefault; SQLite is the zero-infrastructure persistent option:\n\n```bash\n# in-memory without --data-path; pass it to persist jobs to SQLite\nbunx bunqueue start --data-path ./data/bunq.db # TCP :6789, HTTP :6790\n\n# or, with no runtime at all (the volume persists /app/data):\ndocker run -d -p 6789:6789 -p 6790:6790 \\\n -v bunqueue-data:/app/data \\\n egeominotti/bunqueue:latest\n```\n\nFor multiple active brokers, the repository includes a topology pinned to\nPostgreSQL 18.6:\n\n```bash\nPOSTGRES_PASSWORD='replace-me' \\\n BUNQUEUE_POSTGRES_URL='postgres://bunqueue:replace-me@postgres:5432/bunqueue' \\\n docker compose -f docker-compose.postgres.yml up --build -d\n```\n\nIt starts two brokers against one database/namespace. PostgreSQL is server-only;\nembedded mode keeps using memory/SQLite. Supply both Compose values when the\npassword changes, percent-encoding reserved characters in the URL only. MySQL\nis not supported. CI validates PostgreSQL 15, 16, 17, and the pinned/recommended\n18.6 release. See the\n[storage guide](https://bunqueue.dev/guide/databases/).\n\nStarting with 2.9.5, completed releases publish to both Docker Hub\n(`egeominotti/bunqueue`) and GHCR (`ghcr.io/egeominotti/bunqueue`), with matching\nversion, `latest`, commit SHA, and timestamp tags. Each image supports\n`linux/amd64` and `linux/arm64`; Docker selects the matching architecture.\nPin a version or digest for reproducible deployments. Confirm a tag exists with\n`docker buildx imagetools inspect egeominotti/bunqueue: