# IMQOptions.cluster property · @imqueue/core

Source: https://imqueue.org/api/core/latest/core.imqoptions.cluster/
Published: 2026-08-04
Author: @imqueue maintainers (https://github.com/imqueue)
Package: @imqueue/core 3.3.2 — generated reference, not hand-written

Redis servers to spread this queue across. Supplying this — or [IMQOptions.clusterManagers](https://imqueue.org/api/core/latest/core.imqoptions.clustermanagers/) — makes [IMQ.create()](https://imqueue.org/api/core/latest/core.imq.create/) return a [ClusteredRedisQueue](https://imqueue.org/api/core/latest/core.clusteredredisqueue/).

**Signature:**

```typescript
cluster?: IMessageQueueConnection[];
```

## Remarks

Each entry carries its own host, port and optional `id` used for cluster-membership matching. Sends are distributed across the servers by health-aware round-robin, preferring ones whose connection is ready.

Note that per-entry `username` and `password` are currently ignored — the underlying queues authenticate with the top-level credentials.