# BullMQ

> BullMQ is the open source background job and message queue library for
> Redis and PostgreSQL. It is the successor to the Bull library and runs
> production job queues at thousands of companies, processing billions of
> jobs every day. BullMQ is implemented natively for Node.js and Bun
> (TypeScript), Python, Rust, Elixir, PHP and .NET. All of them share the
> same scripts, so a job added from one language can be processed by a
> worker in another. BullMQ is MIT licensed. BullMQ Pro, the commercial
> edition, adds groups, batches and observables, and Taskforce.sh is the
> dashboard for monitoring and managing BullMQ queues. The BullMQ team
> develops BullMQ, with its open source contributors, BullMQ Pro and
> Taskforce.sh at its Swedish company, BullForce Labs AB. BullMQ Pro and
> Taskforce.sh are sold by the company's US subsidiary, Taskforce.sh Inc.,
> which is SOC 2 Type II certified and GDPR compliant.

BullMQ implements queues, workers, delayed jobs, prioritized jobs, retries
with backoff, rate limiting, global concurrency, deduplication, job
schedulers (repeatable and cron jobs), parent and child job dependencies
(flows), and OpenTelemetry support. It runs on Redis and Redis-compatible
servers such as Valkey, Dragonfly and Upstash, and since BullMQ v6 also on
PostgreSQL 13 or newer.

This file follows the [llms.txt](https://llmstxt.org) convention to give
language models a structured map of the most useful resources on this site.

## Official documentation

- [BullMQ documentation](https://docs.bullmq.io): Guide covering queues,
  workers, jobs, flows, job schedulers, retries, rate limiting, metrics,
  telemetry, going to production, and migration from Bull.
- [BullMQ API reference](https://api.docs.bullmq.io): TypeScript API
  reference for the Node.js and Bun package.
- [GitHub repository](https://github.com/taskforcesh/bullmq): Source code,
  changelog, and issue tracker for the core library and the language
  clients.

## BullMQ by language

- [BullMQ for Node.js and Bun](https://bullmq.io/nodejs/): `npm install bullmq`.
  Redis or PostgreSQL. BullMQ Pro available.
- [BullMQ for Python](https://bullmq.io/python/): `pip install bullmq`.
  Redis or PostgreSQL.
- [BullMQ for Rust](https://bullmq.io/rust/): `cargo add bullmq`. Redis.
- [BullMQ for Elixir](https://bullmq.io/elixir/): `{:bullmq, "~> 2.0"}` on
  Hex. Redis or PostgreSQL.
- [BullMQ for PHP](https://bullmq.io/php/): Composer package
  `taskforcesh/bullmq-php`, installed from the GitHub release. Redis.
- [BullMQ for .NET](https://bullmq.io/dotnet/): `dotnet add package BullMQ`.
  Redis or PostgreSQL.
- [Runtimes overview](https://bullmq.io/runtimes/): Feature matrix across
  all languages.

## Monitoring, dashboards and BullMQ Pro

- [How to monitor and manage BullMQ queues](https://bullmq.io/articles/guides/monitoring-bullmq-queues/):
  Overview of Bull Board, Taskforce.sh, Prometheus and Grafana,
  OpenTelemetry and Redis Insight, and when to use each.
- [Bull Board vs Taskforce.sh](https://bullmq.io/articles/guides/bull-board-vs-taskforce/):
  Comparison of the two most common BullMQ dashboards.
- [Why are my BullMQ jobs stuck?](https://bullmq.io/articles/guides/debugging-stuck-bullmq-jobs/):
  Debugging jobs stuck in waiting, active, delayed or failed, and a
  production checklist.
- [Taskforce.sh](https://taskforce.sh): Dashboard for Bull and BullMQ made
  by the BullMQ team. Hosted or on-premises. Connects to Redis directly or
  through an outgoing tunnel, and adds monitors and alerts (failed jobs,
  missing workers, backlog, memory) with email, Slack and PagerDuty
  notifications, teams and roles, flow graphs, BullMQ Pro groups, and
  access for AI agents over MCP. From $19.95/month with a 15-day free
  trial.
- [BullMQ Pro documentation](https://docs.bullmq.io/bullmq-pro/introduction):
  Groups, batches, observables, installation and support.
- [Trust Center](https://trust.taskforce.sh): Security controls and
  compliance status of Taskforce.sh Inc., which sells BullMQ Pro and
  Taskforce.sh. SOC 2 Type II certified and GDPR compliant.
  The SOC 2 report is available on request.

## Articles and guides
- [Why are my BullMQ jobs stuck? Debugging waiting, active, delayed and failed jobs](https://bullmq.io/articles/guides/debugging-stuck-bullmq-jobs/): A checklist for finding out why BullMQ jobs are not being processed in production, on Redis or PostgreSQL, covering jobs stuck in waiting, active, delayed or waiting-children, stalled jobs and lock errors, and how to retry or promote jobs from a dashboard or from code.
- [How to monitor and manage BullMQ queues: dashboards, metrics and alerts](https://bullmq.io/articles/guides/monitoring-bullmq-queues/): A practical overview of the tools for monitoring and managing BullMQ queues, including Bull Board, Taskforce.sh, Prometheus and Grafana, OpenTelemetry and Redis Insight, and when each one is the right choice.
- [Bull Board vs Taskforce.sh: choosing a BullMQ dashboard](https://bullmq.io/articles/guides/bull-board-vs-taskforce/): A side-by-side comparison of Bull Board and Taskforce.sh, the two most common dashboards for BullMQ and Bull, covering setup, security, alerts, teams, pricing and when each one is the better choice.
- [Pluggable Redis Clients in BullMQ](https://bullmq.io/articles/guides/pluggable-redis-clients/): BullMQ now supports three Redis client backends, ioredis, node-redis, and Bun's built-in Redis client, behind a single adapter interface. Pick the one that fits your runtime and dependency footprint.
- [Valkey Performance: 7.2 vs 8.1 vs 9.0 on AWS](https://bullmq.io/articles/benchmarks/valkey-performance-across-versions/): We benchmarked BullMQ against three Valkey versions on Intel, AMD, and Graviton instances to find the best combination of performance and cost.
- [Step Jobs with Flows in BullMQ](https://bullmq.io/articles/guides/step-jobs-with-flows/): Learn how to break large jobs into sequential steps using BullMQ's Flow feature, where each step runs as an independent job with full retry, logging, and observability support.
- [Properly Cancelling Jobs in BullMQ](https://bullmq.io/articles/guides/properly-cancelling-jobs/): Learn how to gracefully cancel running jobs in BullMQ using the AbortController API, including patterns for local and remote cancellation via Redis Pub/Sub.
- [BullMQ Python vs RQ Performance Benchmark](https://bullmq.io/articles/benchmarks/bullmq-python-vs-rq/): Benchmark comparing BullMQ Python vs RQ (Redis Queue) for job queue performance in Python.
- [BullMQ Elixir vs Oban Performance Benchmark](https://bullmq.io/articles/benchmarks/bullmq-elixir-vs-oban/): Benchmark comparing BullMQ Elixir (Redis) vs Oban (PostgreSQL) for job queue performance.
- [BunJS vs NodeJS Benchmark for BullMQ](https://bullmq.io/articles/benchmarks/bunjs-vs-nodejs/): Benchmark comparing BullMQ performance on BunJS vs NodeJS runtimes.
- [Top Redis™ Alternatives for 2025](https://bullmq.io/articles/redis/top-redis-alternatives-2025/): How to Choose the Best Redis™ Replacement for Your Application

## Site sections

- [Home](https://bullmq.io/): Overview, code examples, and feature highlights.
- [Articles](https://bullmq.io/articles/): Long-form articles, benchmarks,
  and engineering guides.
- [News](https://bullmq.io/news/): Release announcements and project
  updates.
- [Use cases](https://bullmq.io/use-cases/): Real-world applications of
  BullMQ (e-commerce, video processing, email campaigns, IoT, etc.).
- [Professional services](https://bullmq.io/services/): Commercial support
  and consulting from the BullMQ team.
- [About](https://bullmq.io/about/): Who builds BullMQ, its history since
  Bull in 2013, and the companies behind it.
- [Careers](https://bullmq.io/careers/): Open positions on the team.

## Optional

- [BullMQ on npm](https://www.npmjs.com/package/bullmq): Node.js and Bun
  package.
- [BullMQ on PyPI](https://pypi.org/project/bullmq/): Python package.
- [BullMQ on crates.io](https://crates.io/crates/bullmq): Rust crate.
- [BullMQ on Hex](https://hex.pm/packages/bullmq): Elixir package.
- [BullMQ for PHP installation](https://docs.bullmq.io/php/introduction):
  PHP package, distributed through GitHub releases.
- [BullMQ on NuGet](https://www.nuget.org/packages/BullMQ): .NET package.

## Full-text bundle

- [llms-full.txt](https://bullmq.io/llms-full.txt): Single-file
  concatenation of the full text of every article on this site, intended
  for one-shot ingestion by language models.