Join us at MongoDB.local London on 7 May to unlock new possibilities for your data. Use WEB50 to save 50%.
Register now >
Docs Menu
Docs Home
/ /
Downgrade 8.3 to 8.2
Docs Home
/ /
8.3 (Upcoming)
/
Downgrade 8.3 to 8.2
Docs Home
/
Development
/
Server Release Notes
/
8.3 (Upcoming)
/
Downgrade 8.3 to 8.2

Downgrade 8.3 Standalone to 8.2

Important

MongoDB 8.3 Release Candidates

MongoDB 8.3 binaries are currently available only as release candidates. Release candidates can be used for early testing of new features, but are not suitable for production deployments.

This version of the manual is for an upcoming release and is currently a work in progress.

Before you attempt a downgrade, familiarize yourself with the content in this page.

Downgrade Path

If you need to downgrade from 8.3, downgrade to the latest patch release of 8.2.

MongoDB supports single-version downgrades along adjacent versions only. You cannot downgrade to a release that is multiple versions behind your current release.

  • For any versions, major or minor, you can upgrade or downgrade to its adjacent neighbors. For example, you can downgrade from 8.3 to 8.2 or upgrade from 7.0 to 8.0.

  • For all versions, major or minor, you can downgrade to the immediately previous major version. For example, from 8.3 to 8.0.

  • For any minor version, you can upgrade to the immediately next version. For example, from 8.2 to 8.3.

Access Control

If your deployment has access control enabled, your downgrade user privileges must include privileges to list and manage indexes across databases. A user with root role has the required privileges.

Prerequisites

Before you begin the downgrade procedure, you must complete the following prerequisite steps.

1

Create Backup

Optional but Recommended. Create a backup of your database.

To learn how to create a backup, see Backup Methods for a Self-Managed Deployment.

2

Remove Backward-Incompatible Features

To ensure a successful downgrade, remove any 8.3 features that are incompatible with 8.2. For a list of incompatible features and how to remove them, see Downgrade Considerations.

3

Downgrade Feature Compatibility Version (FCV)

To downgrade the featureCompatibilityVersion of your standalone instance:

  1. Use mongosh to connect to the mongod instance.

  2. Downgrade the featureCompatibilityVersion to "8.2".

    Important

    After you modify the featureCompatibilityVersion and enable new features, you cannot downgrade the binary version without assistance from support. Make sure to evaluate your upgrade path before proceeding.

    db.adminCommand( { setFeatureCompatibilityVersion: "8.2", confirm: true } )

    The setFeatureCompatibilityVersion command performs writes to an internal system collection and is idempotent. If the command does not complete successfully, retry the command on the mongod instance.

Downgrade Procedure

Warning

Before proceeding with the downgrade procedure, ensure that the prerequisites have been completed.

1

Download the latest 8.2 binaries

Using either a package manager or a manual download, get the latest patch release of 8.2. If using a package manager, add a new repository for the 8.2 binaries, then perform the actual downgrade process.

2

Replace the 8.3 binaries with the downloaded 8.2 binaries

Ensure that the 8.2 binaries are in your System PATH. To confirm your binary version, run the following command:

mongod --version

The command output should indicate a 8.2 release.

3

Shut down the mongod instance

To shut down the mongod process, use mongosh to connect to the deployment and run the following command:

db.adminCommand( { shutdown: 1 } )
4

Update configuration files

Disable any configurable 8.3 features by updating the mongod instance's configuration file before restarting.

To see the list of configurable 8.3 features, review the 8.3 Release Notes.

5

Restart with the latest 8.2 mongod instance

To start a mongod process, run the following command:

mongod --dbpath </path-to-data-folder>

To learn more about starting a mongod process, see Start mongod Processes.

Back

Downgrade 8.3 to 8.2

Next

Replica Set

On this page