MongoDB Versioning

Major Releases

Major Releases are made available approximately once a year, and generally mark the introduction of new features and improvements. Major Releases are appropriate for all MongoDB deployments.

Example versions:

• 5.0

• 6.0

Rapid Releases

Rapid Releases are made available approximately once each quarter that does not contain a Major Release, and generally mark the introduction of new features and improvements. Rapid Releases are designed for use with MongoDB Atlas, and are not generally supported for use in an on-premise capacity. Rapid Releases are not available for use with MongoDB Ops Manager, and are not supported for arbiters. If arbiters are part of your MongoDB deployment, use the most recent Major Release instead.

Example versions:

• 5.1

• 5.2

• 5.3

Patch Releases

Patch Releases are made available as needed to both Major Releases and Rapid Releases, and generally include bug fixes and backwards-compatible changes.

Example versions:

• 5.0.1 (a Major Release patch version)

• 5.2.1 (a Rapid Release patch version)

Release Candidate (RC) Releases

In advance of new Major Releases or Rapid Releases, Release Candidates are made available for early testing. A Release Candidate represents a version of the upcoming release that is stable enough to begin testing, but is not suitable for production deployment.

Example versions:

• 5.0.0-rc0

• 5.0.0-rc1

• 5.1.2-rc5

Driver Versions

The version numbering system for MongoDB differs from the system used for the MongoDB drivers.

MongoDB Shell (mongosh)

Starting with MongoDB 5.0, the MongoDB Shell (mongosh) is released separately from the MongoDB Server, and uses its own version numbering system.

Database Tools

Starting with MongoDB 4.4, the MongoDB Database Tools are released separately from the MongoDB Server, and use their own version numbering system.

Historical Releases

For MongoDB 4.4 and previous, MongoDB versioning used a Production / Development versioning scheme, and had the form X.Y.Z where X.Y refers to either a release series or development series and Z refers to the revision/patch number.

• If Y is even, X.Y refers to a release series; for example, 4.2 release series and 4.4 release series. Release series are stable and suitable for production.

• If Y is odd, X.Y refers to a development series; for example, 4.3 development series and 4.5 development series. Development series are for testing only and not for production.

For example, in MongoDB version 4.4.7, 4.4 refers to the release series and .7 refers to the revision.