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
/
Atlas CLI
Docs Home
/
Tools
/
Atlas CLI
Docs Home
/
Tools
/
Atlas CLI

Install or Update the Atlas CLI

Install the Atlas CLI to quickly provision and manage Atlas database deployments from the terminal.

To check whether your operating system is compatible with the Atlas CLI, see Check Compatibility.

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

Quick Start

Choose one of the following methods to quickly install the Atlas CLI:

brew install mongodb-atlas

Installation Methods

Select your installation method to view detailed steps to install or update the Atlas CLI.

Install the Atlas CLI

To install the Atlas CLI on Ubuntu-based systems using Apt, follow the steps below.

Complete the Prerequisites

To install the Atlas CLI using Apt, you must install gnupg and curl:

sudo apt-get install gnupg curl

Procedure

1

Import the public key used by apt.

From a terminal, issue the following command to import the MongoDB public GPG Key from https://pgp.mongodb.com/server-7.0.asc. Replace 7.0 with your edition of MongoDB.

curl -fsSL https://pgp.mongodb.com/server-7.0.asc | \
sudo gpg -o /usr/share/keyrings/mongodb-server-7.0.gpg \
--dearmor

A successful command returns an OK.

2

Create a list file for your version of Ubuntu.

Create a /etc/apt/sources.list.d/mongodb-enterprise.list file for your version of Ubuntu. Replace 7.0 with your edition of MongoDB.

echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-8.0.gpg ] https://repo.mongodb.com/apt/ubuntu noble/mongodb-enterprise/8.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-enterprise.list
3

Refresh the package database.

Invoke the following apt command:

sudo apt-get update
4

Install the Atlas CLI and mongosh.

Invoke the following apt command to install both the Atlas CLI and mongosh:

sudo apt-get install -y mongodb-atlas

If you don't want to install mongosh, invoke the following apt command instead to install the Atlas CLI only:

sudo apt-get install -y mongodb-atlas-cli
5

Verify successful Atlas CLI installation.

Run the atlas command from any directory:

atlas

The response includes available commands and options for the Atlas CLI.

6

Authenticate with Atlas.

After you install the Atlas CLI, authenticate:

atlas auth login

The command opens a browser window and returns a one-time activation code. This code expires after 10 minutes.

For more authentication options, see Connect from the Atlas CLI.

Update the Atlas CLI

To update the Atlas CLI with Apt, follow the steps below.

1

Update the Atlas CLI.

If you installed the Atlas CLI and mongosh together using the mongodb-atlas package, invoke the following apt command:

sudo apt-get install --only-upgrade mongodb-atlas

If you installed the Atlas CLI only using the mongodb-atlas-cli package, invoke the following apt command:

sudo apt-get install --only-upgrade mongodb-atlas-cli
2

Verify successful update of the Atlas CLI.

Run the --version command:

atlas --version

The response returns your Atlas CLI version.

Install the Atlas CLI

To install the Atlas CLI on Ubuntu-based systems using Apt, follow the steps below.

Complete the Prerequisites

To install the Atlas CLI using Apt, you must install gnupg and curl:

sudo apt-get install gnupg curl

Procedure

1

Import the public key used by apt.

From a terminal, issue the following command to import the MongoDB public GPG Key from https://pgp.mongodb.com/server-7.0.asc. Replace 7.0 with your edition of MongoDB.

curl -fsSL https://pgp.mongodb.com/server-7.0.asc | \
sudo gpg -o /usr/share/keyrings/mongodb-server-7.0.gpg \
--dearmor

A successful command returns an OK.

2

Create a list file for your version of Ubuntu.

Create the list file /etc/apt/sources.list.d/mongodb-org-7.0.list for your version of Ubuntu. Replace 7.0 with your edition of MongoDB.

echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-8.0.gpg ] https://repo.mongodb.org/apt/ubuntu noble/mongodb-org/8.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-8.0.list
3

Refresh the package database.

Invoke the following apt command:

sudo apt-get update
4

Install the Atlas CLI and mongosh.

Invoke the following apt command to install both the Atlas CLI and mongosh:

sudo apt-get install -y mongodb-atlas

If you don't want to install mongosh, invoke the following apt command instead to install the Atlas CLI only:

sudo apt-get install -y mongodb-atlas-cli
5

Verify successful Atlas CLI installation.

Run the atlas command from any directory:

atlas

The response includes available commands and options for the Atlas CLI.

6

Authenticate with Atlas.

After you install the Atlas CLI, authenticate:

atlas auth login

The command opens a browser window and returns a one-time activation code. This code expires after 10 minutes.

For more authentication options, see Connect from the Atlas CLI.

Update the Atlas CLI

To update the Atlas CLI with Apt, follow the steps below.

1

Update the Atlas CLI.

If you installed the Atlas CLI and mongosh together using the mongodb-atlas package, invoke the following apt command:

sudo apt-get install --only-upgrade mongodb-atlas

If you installed the Atlas CLI only using the mongodb-atlas-cli package, invoke the following apt command:

sudo apt-get install --only-upgrade mongodb-atlas-cli
2

Verify successful update of the Atlas CLI.

Run the --version command:

atlas --version

The response returns your Atlas CLI version.

Install the Atlas CLI

To install the Atlas CLI on Debian-based systems using Apt, follow the steps below.

Complete the Prerequisites

To install the Atlas CLI using Apt, you must install gnupg and curl:

sudo apt-get install gnupg curl

Procedure

1

Import the public key used by apt.

From a terminal, issue the following command to import the MongoDB public GPG Key from https://pgp.mongodb.com/server-7.0.asc. Replace 7.0 with your edition of MongoDB.

curl -fsSL https://pgp.mongodb.com/server-7.0.asc | \
sudo gpg -o /usr/share/keyrings/mongodb-server-7.0.gpg \
--dearmor

A successful command returns an OK.

2

Create a list file for your version of Debian.

Create a /etc/apt/sources.list.d/mongodb-enterprise.list file for your version of Debian. Replace 7.0 with your edition of MongoDB.

echo "deb http://repo.mongodb.com/apt/debian trixie/mongodb-enterprise/7.0 main" | sudo tee /etc/apt/sources.list.d/mongodb-enterprise.list
3

Refresh the package database.

Invoke the following apt command:

sudo apt-get update
4

Install the Atlas CLI and mongosh.

Invoke the following apt command to install both the Atlas CLI and mongosh:

sudo apt-get install -y mongodb-atlas

If you don't want to install mongosh, invoke the following apt command instead to install the Atlas CLI only:

sudo apt-get install -y mongodb-atlas-cli
5

Verify successful Atlas CLI installation.

Run the atlas command from any directory:

atlas

The response includes available commands and options for the Atlas CLI.

6

Authenticate with Atlas.

After you install the Atlas CLI, authenticate:

atlas auth login

The command opens a browser window and returns a one-time activation code. This code expires after 10 minutes.

For more authentication options, see Connect from the Atlas CLI.

Update the Atlas CLI

To update the Atlas CLI with Apt, follow the steps below.

1

Update the Atlas CLI.

If you installed the Atlas CLI and mongosh together using the mongodb-atlas package, invoke the following apt command:

sudo apt-get install --only-upgrade mongodb-atlas

If you installed the Atlas CLI only using the mongodb-atlas-cli package, invoke the following apt command:

sudo apt-get install --only-upgrade mongodb-atlas-cli
2

Verify successful update of the Atlas CLI.

Run the --version command:

atlas --version

The response returns your Atlas CLI version.

Install the Atlas CLI

To install the Atlas CLI on Debian-based systems using Apt, follow the steps below.

Complete the Prerequisites

To install the Atlas CLI using Apt, you must install gnupg and curl:

sudo apt-get install gnupg curl

Procedure

1

Import the public key used by apt.

From a terminal, issue the following command to import the MongoDB public GPG Key from https://pgp.mongodb.com/server-7.0.asc. Replace 7.0 with your edition of MongoDB.

curl -fsSL https://pgp.mongodb.com/server-7.0.asc | \
sudo gpg -o /usr/share/keyrings/mongodb-server-7.0.gpg \
--dearmor

A successful command returns an OK.

2

Create a list file for your version of Debian.

Create the list file /etc/apt/sources.list.d/mongodb-org-7.0.list for your version of Debian. Replace 7.0 with your edition of MongoDB.

echo "deb http://repo.mongodb.org/apt/debian trixie/mongodb-org/7.0 main" | sudo tee /etc/apt/sources.list.d/mongodb-org-7.0.list
3

Refresh the package database.

Invoke the following apt command:

sudo apt-get update
4

Install the Atlas CLI and mongosh.

Invoke the following apt command to install both the Atlas CLI and mongosh:

sudo apt-get install -y mongodb-atlas

If you don't want to install mongosh, invoke the following apt command instead to install the Atlas CLI only:

sudo apt-get install -y mongodb-atlas-cli
5

Verify successful Atlas CLI installation.

Run the atlas command from any directory:

atlas

The response includes available commands and options for the Atlas CLI.

6

Authenticate with Atlas.

After you install the Atlas CLI, authenticate:

atlas auth login

The command opens a browser window and returns a one-time activation code. This code expires after 10 minutes.

For more authentication options, see Connect from the Atlas CLI.

Update the Atlas CLI

To update the Atlas CLI with Apt, follow the steps below.

1

Update the Atlas CLI.

If you installed the Atlas CLI and mongosh together using the mongodb-atlas package, invoke the following apt command:

sudo apt-get install --only-upgrade mongodb-atlas

If you installed the Atlas CLI only using the mongodb-atlas-cli package, invoke the following apt command:

sudo apt-get install --only-upgrade mongodb-atlas-cli
2

Verify successful update of the Atlas CLI.

Run the --version command:

atlas --version

The response returns your Atlas CLI version.

Install the Atlas CLI

To install the Atlas CLI using Homebrew, follow the steps below.

Complete the Prerequisites

To install the Atlas CLI using Homebrew, you must:

  1. Use a MacOS or Linux operating system.

  2. Install Homebrew.

Procedure

1

Install the Atlas CLI and mongosh.

Invoke the following brew command to install both the Atlas CLI and mongosh:

brew install mongodb-atlas

Note

You can also use the brew install mongodb-atlas-cli command, which installs the same Homebrew formula. You can't install the Atlas CLI alone on Homebrew.

2

Verify successful Atlas CLI installation.

Run the atlas command from any directory:

atlas

The response includes available commands and options for the Atlas CLI.

3

Authenticate with Atlas.

After you install the Atlas CLI, authenticate:

atlas auth login

The command opens a browser window and returns a one-time activation code. This code expires after 10 minutes.

For more authentication options, see Connect from the Atlas CLI.

Update the Atlas CLI

To update the Atlas CLI with Homebrew, follow the steps below.

1

Update the Atlas CLI.

If you installed the Atlas CLI and mongosh together using the mongodb-atlas package, invoke the following brew command:

brew update
brew upgrade mongodb-atlas

If you installed the Atlas CLI and mongosh together using the mongodb-atlas-cli package, invoke the following brew command:

brew update
brew upgrade mongodb-atlas-cli
2

Verify successful update of the Atlas CLI.

Run the --version command:

atlas --version

The response returns your Atlas CLI version.

Install the Atlas CLI

To install the Atlas CLI using Chocolatey, follow the steps below.

Complete the Prerequisites

To install the Atlas CLI using Chocolatey, you must do the following:

  1. Ensure that your system meets the requirements for installing Chocolatey.

  2. Install Chocolatey using cmd.exe or PowerShell.exe. To learn more, see Installing Chocolatey.

Procedure

1

Install the Atlas CLI.

choco install mongodb-atlas
2

When prompted, enter A to confirm installation.

3

Close and reopen your terminal after the installation to see the changes in your path.

4

Verify successful Atlas CLI installation.

Run the atlas command from any directory:

atlas

The response includes available commands and options for the Atlas CLI.

5

Authenticate with Atlas.

After you install the Atlas CLI, authenticate:

atlas auth login

The command opens a browser window and returns a one-time activation code. This code expires after 10 minutes.

For more authentication options, see Connect from the Atlas CLI.

Update the Atlas CLI

To update the Atlas CLI with Chocolatey, follow the steps below.

1

Update the Atlas CLI.

choco upgrade mongodb-atlas
2

Verify successful update of the Atlas CLI.

Run the --version command:

atlas --version

The response returns your Atlas CLI version.

Install the Atlas CLI

To install the Atlas CLI using Docker, follow the steps below.

Complete the Prerequisites

To install the Atlas CLI using Docker, install the Docker engine or Docker desktop.

Procedure

To pull the latest Atlas CLI Docker image, run the following command:

docker pull mongodb/atlas

If you run docker pull mongodb/atlas without specifying a version tag, Docker automatically pulls the latest version of the Docker image (mongodb/atlas:latest).

To pull a specific version of the Docker image, run the following command, replacing <tag> with the version tag:

docker pull mongodb/atlas:<tag>

To learn how to run Atlas CLI commands with Docker after you pull the Docker image, see Run Atlas CLI Commands with Docker.

Authenticate with Atlas

After pulling the Docker image, authenticate to start using the Atlas CLI:

docker run -it mongodb/atlas auth login

The command opens a browser window and returns a one-time activation code. This code expires after 10 minutes.

For more authentication options, see Connect from the Atlas CLI.

Install the Atlas CLI

To install the Atlas CLI by downloading the binary, follow the steps below.

Procedure

1

Install the Atlas 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.

2

(Optional) Add Atlas CLI to your PATH.

You can run the binary from any directory if you do one of the following:

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

  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.

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

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

cd atlascli_1.59.3-macOS_x86_64
mv atlas /usr/local/bin
3

Verify successful Atlas CLI installation.

Run the atlas command from any directory:

atlas

The response includes available commands and options for the Atlas CLI.

4

Authenticate with Atlas.

After you install the Atlas CLI, authenticate:

atlas auth login

The command opens a browser window and returns a one-time activation code. This code expires after 10 minutes.

For more authentication options, see Connect from the Atlas CLI.

Update the Atlas CLI

To update the Atlas CLI by downloading the binary, follow the steps below.

1

Update the Atlas CLI.

  1. Remove any existing Atlas CLI binaries to prevent version conflicts.

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

    Operating System
    Download

    Windows

    MacOS

    Ubuntu/Debian

    RHEL/CentOS/SLES/AMZ

    Linux

  3. Run the executable file.

2

Verify successful update of the Atlas CLI.

Run the --version command:

atlas --version

The response returns your Atlas CLI version.

Install the Atlas CLI

To install the Atlas CLI on RHEL-based systems using Yum, follow the steps below.

Procedure

1

Configure yum for your edition of MongoDB.

Create a /etc/yum.repos.d/mongodb-enterprise-7.0.repo file so that you can install Atlas CLI directly using yum. Replace 7.0 with your edition of MongoDB.

[mongodb-enterprise-7.0]
name=MongoDB Repository
baseurl=https://repo.mongodb.com/yum/redhat/$releasever/mongodb-enterprise/7.0/$basearch/
gpgcheck=1
enabled=1
gpgkey=https://pgp.mongodb.com/server-7.0.asc
2

Install the Atlas CLI and mongosh.

Invoke the following yum command to install both the Atlas CLI and mongosh:

sudo yum install -y mongodb-atlas

If you don't want to install mongosh, invoke the following yum command instead to install the Atlas CLI only:

sudo yum install -y mongodb-atlas-cli
3

Verify successful Atlas CLI installation.

Run the atlas command from any directory:

atlas

The response includes available commands and options for the Atlas CLI.

4

Authenticate with Atlas.

After you install the Atlas CLI, authenticate:

atlas auth login

The command opens a browser window and returns a one-time activation code. This code expires after 10 minutes.

For more authentication options, see Connect from the Atlas CLI.

Update the Atlas CLI

To update the Atlas CLI with Yum, follow the steps below.

1

Update the Atlas CLI.

If you installed the Atlas CLI and mongosh together using the mongodb-atlas package, invoke the following yum command:

yum update mongodb-atlas

If you installed the Atlas CLI only using the mongodb-atlas-cli package, invoke the following yum command:

yum update mongodb-atlas-cli
2

Verify successful update of the Atlas CLI.

Run the --version command:

atlas --version

The response returns your Atlas CLI version.

Install the Atlas CLI

To install the Atlas CLI on RHEL-based systems using Yum, follow the steps below.

Procedure

1

Configure yum for your edition of MongoDB.

Create a /etc/yum.repos.d/mongodb-org-7.0.repo file so that you can install Atlas CLI directly using yum. Replace 7.0 with your edition of MongoDB.

[mongodb-org-7.0]
name=MongoDB Repository
baseurl=https://repo.mongodb.org/yum/redhat/$releasever/mongodb-org/7.0/x86_64/
gpgcheck=1
enabled=1
gpgkey=https://pgp.mongodb.com/server-7.0.asc
2

Install the Atlas CLI and mongosh.

Invoke the following yum command to install both the Atlas CLI and mongosh:

sudo yum install -y mongodb-atlas

If you don't want to install mongosh, invoke the following yum command instead to install the Atlas CLI only:

sudo yum install -y mongodb-atlas-cli
3

Verify successful Atlas CLI installation.

Run the atlas command from any directory:

atlas

The response includes available commands and options for the Atlas CLI.

4

Authenticate with Atlas.

After you install the Atlas CLI, authenticate:

atlas auth login

The command opens a browser window and returns a one-time activation code. This code expires after 10 minutes.

For more authentication options, see Connect from the Atlas CLI.

Update the Atlas CLI

To update the Atlas CLI with Yum, follow the steps below.

1

Update the Atlas CLI.

If you installed the Atlas CLI and mongosh together using the mongodb-atlas package, invoke the following yum command:

yum update mongodb-atlas

If you installed the Atlas CLI only using the mongodb-atlas-cli package, invoke the following yum command:

yum update mongodb-atlas-cli
2

Verify successful update of the Atlas CLI.

Run the --version command:

atlas --version

The response returns your Atlas CLI version.

Install the Atlas CLI

To install the Atlas CLI on Amazon Linux 2023 using Yum, follow the steps below.

Procedure

1

Configure yum for your edition of MongoDB.

Create a /etc/yum.repos.d/mongodb-enterprise-7.0.repo file so that you can install Atlas CLI directly using yum. Replace 7.0 with your edition of MongoDB.

[mongodb-enterprise-7.0]
name=MongoDB Enterprise Repository
baseurl=https://repo.mongodb.com/yum/amazon/2023/mongodb-enterprise/7.0/$basearch/
gpgcheck=1
enabled=1
gpgkey=https://pgp.mongodb.com/server-7.0.asc
2

Install the Atlas CLI and mongosh.

Invoke the following yum command to install both the Atlas CLI and mongosh:

sudo yum install -y mongodb-atlas

If you don't want to install mongosh, invoke the following yum command instead to install the Atlas CLI only:

sudo yum install -y mongodb-atlas-cli
3

Verify successful Atlas CLI installation.

Run the atlas command from any directory:

atlas

The response includes available commands and options for the Atlas CLI.

4

Authenticate with Atlas.

After you install the Atlas CLI, authenticate:

atlas auth login

The command opens a browser window and returns a one-time activation code. This code expires after 10 minutes.

For more authentication options, see Connect from the Atlas CLI.

Update the Atlas CLI

To update the Atlas CLI with Yum, follow the steps below.

1

Update the Atlas CLI.

If you installed the Atlas CLI and mongosh together using the mongodb-atlas package, invoke the following yum command:

yum update mongodb-atlas

If you installed the Atlas CLI only using the mongodb-atlas-cli package, invoke the following yum command:

yum update mongodb-atlas-cli
2

Verify successful update of the Atlas CLI.

Run the --version command:

atlas --version

The response returns your Atlas CLI version.

Install the Atlas CLI

To install the Atlas CLI on Amazon Linux 2023 using Yum, follow the steps below.

Procedure

1

Configure yum for your edition of MongoDB.

Create a /etc/yum.repos.d/mongodb-org-7.0.repo file so that you can install Atlas CLI directly using yum. Replace 7.0 with your edition of MongoDB.

[mongodb-org-7.0]
name=MongoDB Repository
baseurl=https://repo.mongodb.org/yum/amazon/2023/mongodb-org/7.0/x86_64/
gpgcheck=1
enabled=1
gpgkey=https://pgp.mongodb.com/server-7.0.asc
2

Install the Atlas CLI and mongosh.

Invoke the following yum command to install both the Atlas CLI and mongosh:

sudo yum install -y mongodb-atlas

If you don't want to install mongosh, invoke the following yum command instead to install the Atlas CLI only:

sudo yum install -y mongodb-atlas-cli
3

Verify successful Atlas CLI installation.

Run the atlas command from any directory:

atlas

The response includes available commands and options for the Atlas CLI.

4

Authenticate with Atlas.

After you install the Atlas CLI, authenticate:

atlas auth login

The command opens a browser window and returns a one-time activation code. This code expires after 10 minutes.

For more authentication options, see Connect from the Atlas CLI.

Update the Atlas CLI

To update the Atlas CLI with Yum, follow the steps below.

1

Update the Atlas CLI.

If you installed the Atlas CLI and mongosh together using the mongodb-atlas package, invoke the following yum command:

yum update mongodb-atlas

If you installed the Atlas CLI only using the mongodb-atlas-cli package, invoke the following yum command:

yum update mongodb-atlas-cli
2

Verify successful update of the Atlas CLI.

Run the --version command:

atlas --version

The response returns your Atlas CLI version.

Take the Next Steps

Connect from the Atlas CLI to start using the Atlas CLI commands.

Back
Overview
Next
Check Compatibility
Rate this page

On this page