Navigation

Installing the Database Tools on Windows

Overview

The MongoDB Database Tools are a suite of command-line utilities for working with MongoDB. Use this guide to install the Database Tools on the Windows platform.

Versioning

Starting with MongoDB 4.4, the MongoDB Database Tools are now released separately from the MongoDB Server and use their own versioning, with an initial version of 100.0.0. Previously, these tools were released alongside the MongoDB Server and used matching versioning.

For documentation on the MongoDB 4.2 or earlier versions of these tools, reference the MongoDB Server Documentation for that version of the tool:

Quick links to older documentation

Compatibility

MongoDB Server Compatibility

MongoDB Database Tools version 100.2.1 supports the following versions of the MongoDB server:

  • MongoDB 4.4
  • MongoDB 4.2
  • MongoDB 4.0
  • MongoDB 3.6

While the tools may work on earlier versions of MongoDB server, any such compatibility is not guaranteed.

Platform Support

The MongoDB Database Tools version 100.2.1 are supported on:

  • Windows 8 and later
  • Windows Server 2012 and later

Installation

The MongoDB Database Tools can be installed with an MSI installer, or downloaded as a ZIP archive. Select the tab below depending on your desired installation method:

1

Download the Database Tools MSI installer.

Open the MongoDB Download Center. Using the drop-down menu on the right-hand side of the page:

  1. Select the Windows x86_64 Platform
  2. Select the msi Package
  3. Click the Download button
2

Run the MSI installer.

Double-click the downloaded MSI installer to install the Database Tools. During the install you may customize the installation directory if desired.

3

Make the DB Tools available in your PATH.

You may wish to make the Database Tools available in your system’s PATH environment variable, which allows referencing each tool directly on the command prompt by name, without needing to specify its full path, or first navigating to its parent directory.

Once you’ve installed the Database Tools, follow the instructions below to add the install directory to your system’s 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 the location where you installed the Database Tools.
  7. Click OK to confirm your changes. On each other modal, click OK to confirm your changes.

Once set, you can run any of the Database Tools directly from your command prompt. Consult the reference page for the specific tool you wish to use for its full syntax and usage.

1

Download the Database Tools Zip archive.

Open the MongoDB Download Center. Using the drop-down menu on the right-hand side of the page:

  1. Select the Windows x86_64 Platform
  2. Select the zip Package
  3. Click the Download button
2

Copy the files from the downloaded archive.

Double-click the downloaded Zip archive to unpack it and copy the Database Tools from the bin directory to your computer’s filesystem.

3

Make the DB Tools available in your PATH.

You may wish to make the Database Tools available in your system’s PATH environment variable, which allows referencing each tool directly on the command prompt by name, without needing to specify its full path, or first navigating to its parent directory.

Once you’ve copied the Database Tools to the desired location on your filesystem, follow the instructions below to add that location to your system’s 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 the location where you copied the Database Tools.
  7. Click OK to confirm your changes. On each other modal, click OK to confirm your changes.

Once set, you can run any of the Database Tools directly from your command prompt. Consult the reference page for the specific tool you wish to use for its full syntax and usage.