Install mongosh











Prerequisites

To use the MongoDB Shell, you must have a MongoDB deployment to connect to.

• For a free cloud-hosted deployment, you can use MongoDB Atlas.

• To learn how to run a local MongoDB deployment, see Install MongoDB.

Supported MongoDB Versions

You can use the MongoDB Shell to connect to MongoDB version 4.0 or greater.

Procedure

Select the appropriate tab for your operating system:

NOTE

On Windows, mongosh preferences and configuration options are stored in the %APPDATA%/mongodb/mongosh directory.

Install from MSI

1

Open the MongoDB Shell download page.

Open the MongoDB Download Center.

2

In the Platform dropdown, select Windows 64-bit (8.1+) (MSI)

3

Click Download.

4

Double-click the installer file.

5

Follow the prompts to install mongosh.

Install from .zip File

1

Open the MongoDB Shell download page.

Open the MongoDB Download Center.

2

Download the mongosh installation archive for your operating system.

Download the appropriate version of mongosh for your operating system. MongoDB also provides versions of mongosh that use the system's OpenSSL installation. For details, see the MongoDB Download Center.

3

Extract the files from the downloaded archive.

4

Add the mongosh binary to your PATH environment variable.

Ensure that the extracted MongoDB Shell binary is in the desired location in your filesystem, then add that location to your PATH environment variable.

To add the MongoDB Shell binary's location to your PATH environment variable:

1. Open the Control Panel.

2. In the System and Security category, click System.

3. Click Advanced system settings. The System Properties modal displays.

4. Click Environment Variables.

5. In the System variables section, select Path and click Edit. The Edit environment variable modal displays.

6. Click New and add the filepath to your mongosh binary.

7. Click OK to confirm your changes. On each other modal, click OK to confirm your changes.

To confirm that your PATH environment variable is correctly configured to find mongosh, open a command prompt and enter the mongosh --help command. If your PATH is configured correctly, a list of valid commands displays.