Docs Menu
Docs Home
/
MongoDB Manual
/

MongoDB Versioning

On this page

  • Major Releases
  • Rapid Releases
  • Patch Releases
  • Release Candidate (RC) Releases
  • Driver Versions
  • MongoDB Shell (mongosh)
  • Database Tools
  • Historical Releases

Important

Always upgrade to the latest stable patch release of your release series.

MongoDB versioning has the form X.Y.Z where X.Y refers to the release series and Z refers to the patch number.

Starting with MongoDB 5.0, MongoDB is released as two different release series:

  • Major Releases

  • Rapid Releases

For MongoDB 4.4 and previous, MongoDB used a Production / Development versioning system. See Historical Releases.

Major Releases are made available approximately once a year, and introduce new features and improvements. Major Releases are supported for MongoDB Atlas and on-premises deployments.

Example versions:

  • 5.0

  • 6.0

Rapid Releases are made available approximately once each quarter that does not contain a Major Release, and introduce new features and improvements. Rapid Releases are only supported within MongoDB Atlas, and are not supported for on-premises deployments.

Rapid Releases are not available for use with MongoDB Ops Manager.

Example versions:

  • 5.1

  • 5.2

  • 5.3

Patch Releases are made available as needed to both Major Releases and Rapid Releases. Patch releases generally include bug fixes and minor improvements.

Example versions:

  • 5.0.1 (a Major Release patch version)

  • 5.2.1 (a Rapid Release patch version)

In advance of new Major Releases and 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

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

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

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

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 patch release 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 patch release.

Back

Changelog