Connections

Search…
Connections
In order to start working with a Queue, a connection to a Redis instance is necessary. BullMQ uses the node module ioredis, and the options you pass to BullMQ are just passed to the constructor of ioredis. If you do not provide any options, it will default to port 6379 and localhost.
Every class will consume at least one Redis connection, but it is also possible to reuse connections in some situations. For example, the Queue and Worker classes can accept an existing ioredis instance, and by that reusing that connection, however QueueScheduler and QueueEvents cannot do that because they require blocking connections to Redis, which makes it impossible to reuse them.
Some examples:
1
import { Queue, Worker } from 'bullmq'
2
​
3
// Create a new connection in every instance
4
const myQueue = new Queue('myqueue', { connection: {
5
  host: "myredis.taskforce.run",
6
  port: 32856
7
}});
8
​
9
const myWorker = new Worker('myworker', async (job)=>{}, { connection: {
10
  host: "myredis.taskforce.run",
11
  port: 32856
12
}});
Copied!
1
import { Queue, Worker } from 'bullmq';
2
import IORedis from 'ioredis';
3
​
4
const connection = new IORedis();
5
​
6
// Reuse the ioredis instance
7
const myQueue = new Queue('myqueue', { connection });
8
const myWorker = new Worker('myworker', async (job)=>{}, { connection });
Copied!
Note that in the second example, even though the ioredis instance is being reused, the worker will create a duplicated connection that it needs internally to make blocking connections. Please read on the ioredis documentation on how to properly create an instance of IORedis.
If you can afford many connections, by all means just use them. Redis connections have quite low overhead, so you should not need to care about reusing connections unless your service provider is imposing you hard limitations.
Make sure that your redis instance has the setting 
maxmemory-policy=noeviction
in order to avoid automatic removal of keys which would cause unexpected errors in BullMQ
​
Guide - Previous
Introduction
Next - Guide
Queues
Last modified 10mo ago
Copy link