For AI agents: the complete documentation index is available at /bull-board/llms.txt, the full documentation bundle is available at /bull-board/llms-full.txt, and this page is available as Markdown at /bull-board/recipes/global-concurrency.md.

Global concurrency

BullMQ supports a global cap on concurrent jobs across all workers for a queue. The dashboard can read and change it.

Set from the UI

Open the queue's actions dropdown, pick Set concurrency, enter a number. The current value is shown in the queue info panel, under Global concurrency.

Bull-board calls Queue.setGlobalConcurrency(n) on your behalf. Workers respect the new cap on their next job pickup. Setting it to 0 removes the limit.

Set in code

await queue.setGlobalConcurrency(5);

The value is stored in Redis so any worker across any process sees it.

Bull-only queues: global concurrency isn't supported. The UI hides the control.

Read-only mode

Read-only mode disables the control. If you want stakeholders to see the number but not change it, readOnlyMode: true is the switch.