Docs Menu

Docs HomeNode.js Driver

Compatibility

On this page

  • MongoDB Compatibility
  • Compatibility Table Legend
  • Language Compatibility
  • Component 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.

Important

MongoDB ensures compatibility between the MongoDB Server and the drivers for three years after the server version's end of life (EOL) date. To learn more about the MongoDB release and EOL dates, see MongoDB Software Lifecycle Schedules.

Icon
Explanation
All features are supported.
The Driver version will work with the MongoDB version, but not all new MongoDB features are supported.
No mark
The Driver version is not tested with the MongoDB version.
Node.js Driver Version
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.0 to 6.3
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.

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 [2]
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
[2] Versions 6.0 and later of the Node.js driver require Node.js v16.20.1 or later.

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.

←  Issues & HelpUpgrade Driver Versions →