> This page location: /docs.md > /docs/tools-and-connectors.md > /docs/atlas/cli/current.md

> For the complete MongoDB documentation index, see www.mongodb.com/docs/llms.txt

<!--
Tab options on this page. Append to the .md URL to filter:
  ?tabs=<id,...>   select specific tabs (e.g. ?tabs=nodejs,shell)
  ?allTabs=true    include every tab
  (no param)       default: one tab per tabset

Available tabs:
  other tabs: homebrew-quick, download-quick, apt-quick, yum-quick, ent-noble, ent-jammy, comm-noble, comm-jammy, ent-deb-13, ent-deb-12, comm-deb-13, comm-deb-12
-->

# 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.](https://www.mongodb.com/docs/atlas/cli/current/compatibility.md#std-label-compatibility-atlas-cli)

To verify packages before installation, see [Verify the Integrity of Atlas CLI Packages.](https://www.mongodb.com/docs/atlas/cli/current/verify-packages.md#std-label-verify-packages)

## Quick Start

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

### Homebrew (macOS/Linux)

```sh
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`:

```sh
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.

   ```sh
   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.

   ### Ubuntu 24.04 (Noble)

   ```sh
   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:

   ```sh
   sudo apt-get update
   ```

4. Install the Atlas CLI and [`mongosh`](https://www.mongodb.com/docs/mongodb-shell.md#mongodb-binary-bin.mongosh).

   Invoke the following `apt` command to install both the Atlas CLI and [`mongosh`:](https://www.mongodb.com/docs/mongodb-shell.md#mongodb-binary-bin.mongosh)

   ```sh
   sudo apt-get install -y mongodb-atlas
   ```

   If you don't want to install [`mongosh`](https://www.mongodb.com/docs/mongodb-shell.md#mongodb-binary-bin.mongosh), invoke the following `apt` command instead to install the Atlas CLI only:

   ```sh
   sudo apt-get install -y mongodb-atlas-cli
   ```

5. Verify successful Atlas CLI installation.

   Run the `atlas` command from any directory:

   ```sh
   atlas
   ```

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

6. Authenticate with Atlas.

   After you install the Atlas CLI, authenticate:

   ```sh
   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.](https://www.mongodb.com/docs/atlas/cli/current/connect-atlas-cli.md#std-label-connect-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`](https://www.mongodb.com/docs/mongodb-shell.md#mongodb-binary-bin.mongosh) together using the `mongodb-atlas` package, invoke the following `apt` command:

   ```sh
   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:

   ```sh
   sudo apt-get install --only-upgrade mongodb-atlas-cli
   ```

2. Verify successful update of the Atlas CLI.

   Run the `--version` command:

   ```sh
   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`:

```sh
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.

   ```sh
   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.

   ### Ubuntu 24.04 (Noble)

   ```sh
   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:

   ```sh
   sudo apt-get update
   ```

4. Install the Atlas CLI and [`mongosh`](https://www.mongodb.com/docs/mongodb-shell.md#mongodb-binary-bin.mongosh).

   Invoke the following `apt` command to install both the Atlas CLI and [`mongosh`:](https://www.mongodb.com/docs/mongodb-shell.md#mongodb-binary-bin.mongosh)

   ```sh
   sudo apt-get install -y mongodb-atlas
   ```

   If you don't want to install [`mongosh`](https://www.mongodb.com/docs/mongodb-shell.md#mongodb-binary-bin.mongosh), invoke the following `apt` command instead to install the Atlas CLI only:

   ```sh
   sudo apt-get install -y mongodb-atlas-cli
   ```

5. Verify successful Atlas CLI installation.

   Run the `atlas` command from any directory:

   ```sh
   atlas
   ```

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

6. Authenticate with Atlas.

   After you install the Atlas CLI, authenticate:

   ```sh
   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.](https://www.mongodb.com/docs/atlas/cli/current/connect-atlas-cli.md#std-label-connect-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`](https://www.mongodb.com/docs/mongodb-shell.md#mongodb-binary-bin.mongosh) together using the `mongodb-atlas` package, invoke the following `apt` command:

   ```sh
   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:

   ```sh
   sudo apt-get install --only-upgrade mongodb-atlas-cli
   ```

2. Verify successful update of the Atlas CLI.

   Run the `--version` command:

   ```sh
   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`:

```sh
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.

   ```sh
   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.

   ### Debian 13 (Trixie)

   ```sh
   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:

   ```sh
   sudo apt-get update
   ```

4. Install the Atlas CLI and [`mongosh`](https://www.mongodb.com/docs/mongodb-shell.md#mongodb-binary-bin.mongosh).

   Invoke the following `apt` command to install both the Atlas CLI and [`mongosh`:](https://www.mongodb.com/docs/mongodb-shell.md#mongodb-binary-bin.mongosh)

   ```sh
   sudo apt-get install -y mongodb-atlas
   ```

   If you don't want to install [`mongosh`](https://www.mongodb.com/docs/mongodb-shell.md#mongodb-binary-bin.mongosh), invoke the following `apt` command instead to install the Atlas CLI only:

   ```sh
   sudo apt-get install -y mongodb-atlas-cli
   ```

5. Verify successful Atlas CLI installation.

   Run the `atlas` command from any directory:

   ```sh
   atlas
   ```

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

6. Authenticate with Atlas.

   After you install the Atlas CLI, authenticate:

   ```sh
   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.](https://www.mongodb.com/docs/atlas/cli/current/connect-atlas-cli.md#std-label-connect-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`](https://www.mongodb.com/docs/mongodb-shell.md#mongodb-binary-bin.mongosh) together using the `mongodb-atlas` package, invoke the following `apt` command:

   ```sh
   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:

   ```sh
   sudo apt-get install --only-upgrade mongodb-atlas-cli
   ```

2. Verify successful update of the Atlas CLI.

   Run the `--version` command:

   ```sh
   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`:

```sh
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.

   ```sh
   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.

   ### Debian 13 (Trixie)

   ```sh
   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:

   ```sh
   sudo apt-get update
   ```

4. Install the Atlas CLI and [`mongosh`](https://www.mongodb.com/docs/mongodb-shell.md#mongodb-binary-bin.mongosh).

   Invoke the following `apt` command to install both the Atlas CLI and [`mongosh`:](https://www.mongodb.com/docs/mongodb-shell.md#mongodb-binary-bin.mongosh)

   ```sh
   sudo apt-get install -y mongodb-atlas
   ```

   If you don't want to install [`mongosh`](https://www.mongodb.com/docs/mongodb-shell.md#mongodb-binary-bin.mongosh), invoke the following `apt` command instead to install the Atlas CLI only:

   ```sh
   sudo apt-get install -y mongodb-atlas-cli
   ```

5. Verify successful Atlas CLI installation.

   Run the `atlas` command from any directory:

   ```sh
   atlas
   ```

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

6. Authenticate with Atlas.

   After you install the Atlas CLI, authenticate:

   ```sh
   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.](https://www.mongodb.com/docs/atlas/cli/current/connect-atlas-cli.md#std-label-connect-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`](https://www.mongodb.com/docs/mongodb-shell.md#mongodb-binary-bin.mongosh) together using the `mongodb-atlas` package, invoke the following `apt` command:

   ```sh
   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:

   ```sh
   sudo apt-get install --only-upgrade mongodb-atlas-cli
   ```

2. Verify successful update of the Atlas CLI.

   Run the `--version` command:

   ```sh
   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.](https://brew.sh/)

#### Procedure

1. Install the Atlas CLI and [`mongosh`](https://www.mongodb.com/docs/mongodb-shell.md#mongodb-binary-bin.mongosh).

   Invoke the following `brew` command to install both the Atlas CLI and [`mongosh`:](https://www.mongodb.com/docs/mongodb-shell.md#mongodb-binary-bin.mongosh)

   ```sh
   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:

   ```sh
   atlas
   ```

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

3. Authenticate with Atlas.

   After you install the Atlas CLI, authenticate:

   ```sh
   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.](https://www.mongodb.com/docs/atlas/cli/current/connect-atlas-cli.md#std-label-connect-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`](https://www.mongodb.com/docs/mongodb-shell.md#mongodb-binary-bin.mongosh) together using the `mongodb-atlas` package, invoke the following `brew` command:

   ```sh
   brew update
   brew upgrade mongodb-atlas
   ```

   If you installed the Atlas CLI and [`mongosh`](https://www.mongodb.com/docs/mongodb-shell.md#mongodb-binary-bin.mongosh) together using the `mongodb-atlas-cli` package, invoke the following `brew` command:

   ```sh
   brew update
   brew upgrade mongodb-atlas-cli
   ```

2. Verify successful update of the Atlas CLI.

   Run the `--version` command:

   ```sh
   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](https://docs.chocolatey.org/en-us/choco/setup#requirements) for installing Chocolatey.

2. Install Chocolatey using `cmd.exe` or `PowerShell.exe`. To learn more, see [Installing Chocolatey.](https://docs.chocolatey.org/en-us/choco/setup#installing-chocolatey)

#### Procedure

1. Install the Atlas CLI.

   ```shell
   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:

   ```sh
   atlas
   ```

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

5. Authenticate with Atlas.

   After you install the Atlas CLI, authenticate:

   ```sh
   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.](https://www.mongodb.com/docs/atlas/cli/current/connect-atlas-cli.md#std-label-connect-atlas-cli)

### Update the Atlas CLI

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

1. Update the Atlas CLI.

   ```shell
   choco upgrade mongodb-atlas
   ```

2. Verify successful update of the Atlas CLI.

   Run the `--version` command:

   ```sh
   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](https://docs.docker.com/engine/install/) or [Docker desktop.](https://docs.docker.com/desktop/)

#### Procedure

To pull the latest [Atlas CLI Docker image](https://hub.docker.com/repository/docker/mongodb/atlas/general), run the following command:

```text
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:

```text
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.](https://www.mongodb.com/docs/atlas/cli/current/atlas-cli-docker.md#std-label-atlas-cli-docker)

#### Authenticate with Atlas

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

```sh
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.](https://www.mongodb.com/docs/atlas/cli/current/connect-atlas-cli.md#std-label-connect-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.

   Download and extract the correct binary for your operating system:

   | Operating System | Download |
   | --- | --- |
   | Windows | [.zip](https://fastdl.mongodb.org/mongocli/mongodb-atlas-cli_1.59.4_windows_x86_64.zip), [.msi](https://fastdl.mongodb.org/mongocli/mongodb-atlas-cli_1.59.4_windows_x86_64.msi) |
   | MacOS | [.zip (x86-64)](https://fastdl.mongodb.org/mongocli/mongodb-atlas-cli_1.59.4_macos_x86_64.zip), [.zip (ARM)](https://fastdl.mongodb.org/mongocli/mongodb-atlas-cli_1.59.4_macos_arm64.zip) |
   | Ubuntu/Debian | [.deb (x86-64)](https://fastdl.mongodb.org/mongocli/mongodb-atlas-cli_1.59.4_linux_x86_64.deb), [.deb (ARM)](https://fastdl.mongodb.org/mongocli/mongodb-atlas-cli_1.59.4_linux_arm64.deb) |
   | RHEL/CentOS/SLES/AMZ | [.rpm (x86-64)](https://fastdl.mongodb.org/mongocli/mongodb-atlas-cli_1.59.4_linux_x86_64.rpm), [.rpm (ARM)](https://fastdl.mongodb.org/mongocli/mongodb-atlas-cli_1.59.4_linux_arm64.rpm) |
   | Linux | [.tar.gz (x86-64)](https://fastdl.mongodb.org/mongocli/mongodb-atlas-cli_1.59.4_linux_x86_64.tar.gz), [.tar.gz (ARM)](https://fastdl.mongodb.org/mongocli/mongodb-atlas-cli_1.59.4_linux_arm64.tar.gz) |

   **Note:**

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

   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.4-macOS_x86_64` directory.

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

   ```sh
   cd atlascli_1.59.4-macOS_x86_64
   mv atlas /usr/local/bin
   ```

3. Verify successful Atlas CLI installation.

   Run the `atlas` command from any directory:

   ```sh
   atlas
   ```

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

4. Authenticate with Atlas.

   After you install the Atlas CLI, authenticate:

   ```sh
   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.](https://www.mongodb.com/docs/atlas/cli/current/connect-atlas-cli.md#std-label-connect-atlas-cli)

### Update the Atlas CLI

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

1. Update the Atlas CLI.

   Remove any existing Atlas CLI binaries to prevent version conflicts.

   Download and extract the correct binary for your operating system:

   | Operating System | Download |
   | --- | --- |
   | Windows | [.zip](https://fastdl.mongodb.org/mongocli/mongodb-atlas-cli_1.59.4_windows_x86_64.zip), [.msi](https://fastdl.mongodb.org/mongocli/mongodb-atlas-cli_1.59.4_windows_x86_64.msi) |
   | MacOS | [.zip (x86-64)](https://fastdl.mongodb.org/mongocli/mongodb-atlas-cli_1.59.4_macos_x86_64.zip), [.zip (ARM)](https://fastdl.mongodb.org/mongocli/mongodb-atlas-cli_1.59.4_macos_arm64.zip) |
   | Ubuntu/Debian | [.deb (x86-64)](https://fastdl.mongodb.org/mongocli/mongodb-atlas-cli_1.59.4_linux_x86_64.deb), [.deb (ARM)](https://fastdl.mongodb.org/mongocli/mongodb-atlas-cli_1.59.4_linux_arm64.deb) |
   | RHEL/CentOS/SLES/AMZ | [.rpm (x86-64)](https://fastdl.mongodb.org/mongocli/mongodb-atlas-cli_1.59.4_linux_x86_64.rpm), [.rpm (ARM)](https://fastdl.mongodb.org/mongocli/mongodb-atlas-cli_1.59.4_linux_arm64.rpm) |
   | Linux | [.tar.gz (x86-64)](https://fastdl.mongodb.org/mongocli/mongodb-atlas-cli_1.59.4_linux_x86_64.tar.gz), [.tar.gz (ARM)](https://fastdl.mongodb.org/mongocli/mongodb-atlas-cli_1.59.4_linux_arm64.tar.gz) |

   Run the executable file.

2. Verify successful update of the Atlas CLI.

   Run the `--version` command:

   ```sh
   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.

   ```text
   [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`](https://www.mongodb.com/docs/mongodb-shell.md#mongodb-binary-bin.mongosh).

   Invoke the following `yum` command to install both the Atlas CLI and [`mongosh`:](https://www.mongodb.com/docs/mongodb-shell.md#mongodb-binary-bin.mongosh)

   ```sh
   sudo yum install -y mongodb-atlas
   ```

   If you don't want to install [`mongosh`](https://www.mongodb.com/docs/mongodb-shell.md#mongodb-binary-bin.mongosh), invoke the following `yum` command instead to install the Atlas CLI only:

   ```sh
   sudo yum install -y mongodb-atlas-cli
   ```

3. Verify successful Atlas CLI installation.

   Run the `atlas` command from any directory:

   ```sh
   atlas
   ```

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

4. Authenticate with Atlas.

   After you install the Atlas CLI, authenticate:

   ```sh
   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.](https://www.mongodb.com/docs/atlas/cli/current/connect-atlas-cli.md#std-label-connect-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`](https://www.mongodb.com/docs/mongodb-shell.md#mongodb-binary-bin.mongosh) together using the `mongodb-atlas` package, invoke the following `yum` command:

   ```sh
   yum update mongodb-atlas
   ```

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

   ```sh
   yum update mongodb-atlas-cli
   ```

2. Verify successful update of the Atlas CLI.

   Run the `--version` command:

   ```sh
   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.

   ```text
   [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`](https://www.mongodb.com/docs/mongodb-shell.md#mongodb-binary-bin.mongosh).

   Invoke the following `yum` command to install both the Atlas CLI and [`mongosh`:](https://www.mongodb.com/docs/mongodb-shell.md#mongodb-binary-bin.mongosh)

   ```sh
   sudo yum install -y mongodb-atlas
   ```

   If you don't want to install [`mongosh`](https://www.mongodb.com/docs/mongodb-shell.md#mongodb-binary-bin.mongosh), invoke the following `yum` command instead to install the Atlas CLI only:

   ```sh
   sudo yum install -y mongodb-atlas-cli
   ```

3. Verify successful Atlas CLI installation.

   Run the `atlas` command from any directory:

   ```sh
   atlas
   ```

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

4. Authenticate with Atlas.

   After you install the Atlas CLI, authenticate:

   ```sh
   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.](https://www.mongodb.com/docs/atlas/cli/current/connect-atlas-cli.md#std-label-connect-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`](https://www.mongodb.com/docs/mongodb-shell.md#mongodb-binary-bin.mongosh) together using the `mongodb-atlas` package, invoke the following `yum` command:

   ```sh
   yum update mongodb-atlas
   ```

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

   ```sh
   yum update mongodb-atlas-cli
   ```

2. Verify successful update of the Atlas CLI.

   Run the `--version` command:

   ```sh
   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.

   ```text
   [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`](https://www.mongodb.com/docs/mongodb-shell.md#mongodb-binary-bin.mongosh).

   Invoke the following `yum` command to install both the Atlas CLI and [`mongosh`:](https://www.mongodb.com/docs/mongodb-shell.md#mongodb-binary-bin.mongosh)

   ```sh
   sudo yum install -y mongodb-atlas
   ```

   If you don't want to install [`mongosh`](https://www.mongodb.com/docs/mongodb-shell.md#mongodb-binary-bin.mongosh), invoke the following `yum` command instead to install the Atlas CLI only:

   ```sh
   sudo yum install -y mongodb-atlas-cli
   ```

3. Verify successful Atlas CLI installation.

   Run the `atlas` command from any directory:

   ```sh
   atlas
   ```

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

4. Authenticate with Atlas.

   After you install the Atlas CLI, authenticate:

   ```sh
   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.](https://www.mongodb.com/docs/atlas/cli/current/connect-atlas-cli.md#std-label-connect-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`](https://www.mongodb.com/docs/mongodb-shell.md#mongodb-binary-bin.mongosh) together using the `mongodb-atlas` package, invoke the following `yum` command:

   ```sh
   yum update mongodb-atlas
   ```

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

   ```sh
   yum update mongodb-atlas-cli
   ```

2. Verify successful update of the Atlas CLI.

   Run the `--version` command:

   ```sh
   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.

   ```text
   [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`](https://www.mongodb.com/docs/mongodb-shell.md#mongodb-binary-bin.mongosh).

   Invoke the following `yum` command to install both the Atlas CLI and [`mongosh`:](https://www.mongodb.com/docs/mongodb-shell.md#mongodb-binary-bin.mongosh)

   ```sh
   sudo yum install -y mongodb-atlas
   ```

   If you don't want to install [`mongosh`](https://www.mongodb.com/docs/mongodb-shell.md#mongodb-binary-bin.mongosh), invoke the following `yum` command instead to install the Atlas CLI only:

   ```sh
   sudo yum install -y mongodb-atlas-cli
   ```

3. Verify successful Atlas CLI installation.

   Run the `atlas` command from any directory:

   ```sh
   atlas
   ```

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

4. Authenticate with Atlas.

   After you install the Atlas CLI, authenticate:

   ```sh
   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.](https://www.mongodb.com/docs/atlas/cli/current/connect-atlas-cli.md#std-label-connect-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`](https://www.mongodb.com/docs/mongodb-shell.md#mongodb-binary-bin.mongosh) together using the `mongodb-atlas` package, invoke the following `yum` command:

   ```sh
   yum update mongodb-atlas
   ```

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

   ```sh
   yum update mongodb-atlas-cli
   ```

2. Verify successful update of the Atlas CLI.

   Run the `--version` command:

   ```sh
   atlas --version
   ```

   The response returns your Atlas CLI version.

## Take the Next Steps

[Connect from the Atlas CLI](https://www.mongodb.com/docs/atlas/cli/current/connect-atlas-cli.md#std-label-connect-atlas-cli) to start using the [Atlas CLI commands.](https://www.mongodb.com/docs/atlas/cli/current/command/atlas.md#std-label-atlas)
