Compatibility
MongoDB Compatibility
The following compatibility table specifies the recommended versions of the MongoDB Node.js driver for use with MongoDB.
The first column lists the driver version.
Node.js Driver Version | MongoDB 8.0 | MongoDB 7.0 | MongoDB 6.0 | MongoDB 5.0 | MongoDB 4.4 | MongoDB 4.2 | MongoDB 4.0 | MongoDB 3.6 | MongoDB 3.4 | MongoDB 3.2 | MongoDB 3.0 | MongoDB 2.6 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
6.9 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ [2] | ||||
6.0 to 6.8 | ⊛ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||
5.7 to 5.9 | ⊛ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||
5.0 to 5.6 | ⊛ | ⊛ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||
4.8 to 4.17 | ⊛ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | |||||
4.2 to 4.7 | ⊛ | ⊛ | ✓ | ✓ | ✓ | ✓ | ✓ | |||||
4.0 to 4.1 | ⊛ | ⊛ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | |
3.7 [1] | ⊛ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||
3.6 | ⊛ | ⊛ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||
3.3 to 3.5 | ⊛ | ⊛ | ⊛ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||
3.1 to 3.2 | ⊛ | ⊛ | ⊛ | ⊛ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||
3.0 | ✓ | ✓ | ✓ | ✓ | ✓ | |||||||
2.2.12 | ✓ | ✓ | ✓ | ✓ | ||||||||
2.0.14 | ✓ | ✓ | ||||||||||
1.4.29 | ✓ | ✓ |
| [1] | When using Node.js Driver version 3.7, you must set the useUnifiedTopology flag to true for certain features. |
| [2] | Support for MongoDB 3.6 is deprecated in Node.js driver v6.9. |
Language Compatibility
The following compatibility table specifies the recommended versions of the MongoDB Node.js driver for use with a specific version of Node.js.
The first column lists the driver version.
Node.js Driver Version | Node.js v20.x.x | Node.js v18.x.x | Node.js v16.x.x | Node.js v14.x.x | Node.js v12.x.x | Node.js v10.x.x | Node.js v8.X.X | Node.js v6.X.X | Node.js v4.X.X | Node.js v0.12.X | Node.js v0.10.X | Node.js v0.8.X |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
6.X [3] | ✓ | ✓ | ✓ | |||||||||
5.6.X to 5.9.X | ✓ | ✓ | ✓ | ✓ | ||||||||
5.0.0 to 5.5.X | ✓ | ✓ | ✓ | |||||||||
4.X | ✓ | ✓ | ✓ | ✓ | ||||||||
3.X | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||||
2.X | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||||
>= 1.4.18 | ✓ | ✓ | ✓ | |||||||||
1.4.X | ✓ | ✓ |
| [3] | Versions 6.0 and later of the Node.js driver require Node.js v16.20.1 or later. |
Component Compatibility
The following table describes add-on component version compatibility for versions of the MongoDB Node.js driver. Any other combination of packages might be unstable.
Component | Node.js Driver v6.x | Node.js Driver v5.x | Node.js Driver v4.x | Node.js Driver v3.x |
|---|---|---|---|---|
bson | ^6.0.0 | ^5.0.0 | ^4.0.0 | ^1.0.0 |
bson-ext | ^4.0.0 | ^1.0.0 or ^2.0.0 | ||
kerberos | ^2.0.1 | ^1.0.0 or ^2.0.0 | ^1.0.0 or ^2.0.0 | ^1.0.0 |
mongodb-client-encryption | ^6.0.0 | ^2.3.0 | ^1.0.0 or ^2.0.0 | ^1.0.0 |
mongodb-legacy | ^6.0.0 | ^5.0.0 | ^4.0.0 | |
@mongodb-js/zstd | ^1.1.0 | ^1.0.0 | ^1.0.0 |
For more information on how to read the compatibility tables, see our guide about MongoDB Compatibility Tables.