Installation

Prerequisites

Before installing Monque, ensure you have:

• Node.js 22+ or Bun 1.3+
• MongoDB 4.0+
  • Monque works with regular polling on standalone MongoDB
  • Change Streams require a replica set or sharded cluster (MongoDB Atlas provides this by default)

Tip

For local development, you can use Docker to quickly spin up a MongoDB replica set:

docker run -d --name mongodb -p 27017:27017 mongo --replSet rs0
docker exec -it mongodb mongosh --eval "rs.initiate()"

Alternatively, MongoDB publishes an Atlas Local Docker image (mongodb/mongodb-atlas-local) if you want an Atlas-like local deployment.

Install the Package

bun

bun add @monque/core mongodb

npm

npm install @monque/core mongodb

pnpm

pnpm add @monque/core mongodb

yarn

yarn add @monque/core mongodb

Peer Dependencies

Monque requires the MongoDB Node.js driver (mongodb ^7.0.0) as a peer dependency. This allows you to:

• Use your existing MongoDB client instance
• Control driver version independently
• Share connections with your application

Next Steps

Now that you have Monque installed, head to the Quick Start guide to build your first job queue!