For AI agents: a documentation index is available at https://www.mongodb.com/docs/llms.txt — markdown versions of all pages are available by appending .md to any URL path.
Docs Menu
Docs Home
/
Tools
/
Mongo CLI
Docs Home
/
Tools
/
Mongo CLI
Docs Home
/
Tools
/
Mongo CLI

Install or Update the MongoDB CLI

You can use the MongoDB Command Line Interface (mongocli) to deploy and manage MongoDB clusters in Atlas, Cloud Manager, and Ops Manager. For operating system and MongoDB service version requirements, see Compatibility.

To verify packages before installation, see Verify the Integrity of MongoDB CLI Packages.

Select an installation method:

Install the MongoDB CLI

Follow the steps for your selected installation method.

Prerequisites

To install the MongoDB CLI using Homebrew, you must:

  1. Use a MacOS or Linux operating system.

  2. Install Homebrew.

Procedure

1
Install the MongoDB CLI

Invoke the following brew commands:

brew install mongocli
2
Verify your installation.

To verify your mongocli installation, run the help command:

mongocli help

The command returns the available commands and options for the MongoDB CLI.

Procedure

1
Configure yum for MongoDB Community Edition.

Create a /etc/yum.repos.d/mongodb-org-6.0.repo file so that you can install MongoDB CLI directly using yum.

2
Install the MongoDB CLI.

Invoke the following yum command:

sudo yum install -y mongocli
3
Verify your installation.

To verify your mongocli installation, run the help command:

mongocli help

The command returns the available commands and options for the MongoDB CLI.

Procedure

1
Configure yum for MongoDB Enterprise Edition.

Create a /etc/yum.repos.d/mongodb-enterprise-6.0.repo file so that you can install MongoDB CLI directly using yum:

2
Install the MongoDB CLI.

Invoke the following yum command:

sudo yum install -y mongocli
3
Verify your installation.

To verify your mongocli installation, run the help command:

mongocli help

The command returns the available commands and options for the MongoDB CLI.

Procedure

1
Install the MongoDB CLI.

  1. Download and extract the correct binary for your operating system:

    Operating System
    Download

    Windows

    MacOS

    Ubuntu/Debian

    RHEL/CentOS/SLES/AMZ

    Linux

    Note

    Replace or remove any existing MongoDB CLI binaries to prevent conflicts between versions.

  2. Run the executable file.

    Tip

    You can run the binary from any directory. Because you don't need to install the MongoDB CLI into a global location, you can use it on shared hosts and other systems where you don't have a privileged account.

2
Add mongocli to your PATH.

To run mongocli commands from anywhere in your system, you must either:

  1. Add the location of the executable to your PATH or

  2. Move the executable to a directory in your PATH.

You can accomplish this in several ways, depending on your personal settings and environment. Consult the documentation for your shell and operating system for more examples.

Example

In the following example, the user downloads and installs the MongoDB CLI by cloning the GitHub repository. The mongocli executable file saves to the location specified by your $GOPATH environment variable. The default location is $HOME/go on Unix systems and %USERPROFILE%\go on Windows.

The user then adds this directory to their PATH:

export PATH="$HOME/go:$PATH"

Example

In the following example, the user downloads and extracts a binary for the MongoDB CLI to the /mcli_2.0.9-macOS_x86_64 directory.

The user then moves the executable file to a directory already in their PATH:

cd mcli_2.0.9-macOS_x86_64
mv mongocli /usr/local/bin
3
Verify your installation.

To verify your mongocli installation, run the help command:

mongocli help

The command returns the available commands and options for the MongoDB CLI.

Update the MongoDB CLI

Follow the steps below to update the MongoDB CLI:

Procedure

1
Update the MongoDB CLI

Invoke the following brew commands:

brew update
brew upgrade mongocli
2
Verify your update.

To verify your mongocli update, run the --version command:

mongocli --version

The command returns your MongoDB CLI version.

Procedure

1
Update the MongoDB CLI.

Invoke the following yum command:

yum update mongocli
2
Verify your update.

To verify your mongocli update, run the --version command:

mongocli --version

The command returns your MongoDB CLI version.

Procedure

1
Update the MongoDB CLI.

Invoke the following yum command:

yum update mongocli
2
Verify your update.

To verify your mongocli update, run the --version command:

mongocli --version

The command returns your MongoDB CLI version.

Procedure

1
Update the MongoDB CLI.

  1. Remove any existing MongoDB CLI binaries to prevent conflicts between versions.

  2. Download and extract the correct binary for your operating system:

    Operating System
    Download

    Windows

    .zip, .msi

    The .msi download for Windows replaces old installations of the MongoDB CLI, so you don't need to remove existing binaries first.

    MacOS

    Ubuntu/Debian

    RHEL/CentOS/SLES/AMZ

    Linux

  3. Run the executable file.

2
Verify your update.

To verify your mongocli update, run the --version command:

mongocli --version

The command returns your MongoDB CLI version.

Next Steps

Rate this page

On this page