{"id":79422,"date":"2026-10-20T04:29:51","date_gmt":"2026-10-20T04:29:51","guid":{"rendered":"https:\/\/www.devopsschool.com\/blog\/?p=79422"},"modified":"2026-10-20T04:29:56","modified_gmt":"2026-10-20T04:29:56","slug":"how-to-install-mongodb-atlas-cli-on-mac-windows-and-linux-complete-step-by-step-tutorial","status":"publish","type":"post","link":"https:\/\/www.devopsschool.com\/blog\/how-to-install-mongodb-atlas-cli-on-mac-windows-and-linux-complete-step-by-step-tutorial\/","title":{"rendered":"How to Install MongoDB Atlas CLI on Mac, Windows, and Linux: Complete Step-by-Step Tutorial"},"content":{"rendered":"\n

SEO Title:<\/strong> Install MongoDB Atlas CLI on macOS, Windows & Linux \u2013 Complete Guide<\/p>\n\n\n\n

Meta Description:<\/strong> Learn how to install MongoDB Atlas CLI on macOS, Windows, Ubuntu, Debian, RHEL, and CentOS with step-by-step commands, login instructions, verification, updates, and troubleshooting.<\/p>\n\n\n\n

Focus Keywords:<\/strong> install MongoDB Atlas CLI, MongoDB Atlas CLI macOS, MongoDB Atlas CLI Windows, install Atlas CLI Ubuntu, MongoDB Atlas CLI Linux, Atlas CLI commands, MongoDB CLI installation<\/p>\n\n\n\n

\n\n\n\n

1. Introduction<\/h2>\n\n\n\n

MongoDB Atlas is a fully managed cloud database platform that allows developers and organizations to deploy, operate, and scale MongoDB databases across major cloud providers.<\/p>\n\n\n\n

Although MongoDB Atlas provides a web-based management console, developers, database administrators, DevOps engineers, and cloud engineers often need a faster and more automation-friendly way to manage database infrastructure.<\/p>\n\n\n\n

This is where the MongoDB Atlas Command Line Interface (Atlas CLI)<\/strong> becomes useful.<\/p>\n\n\n\n

The Atlas CLI allows you to interact with MongoDB Atlas directly from your terminal without repeatedly opening the MongoDB Atlas web console.<\/p>\n\n\n\n

Using Atlas CLI, you can:<\/p>\n\n\n\n

    \n
  • Manage MongoDB Atlas organizations and projects.<\/li>\n\n\n\n
  • List and manage database clusters.<\/li>\n\n\n\n
  • Manage database users and access controls.<\/li>\n\n\n\n
  • Configure project-level network access.<\/li>\n\n\n\n
  • Manage supported backup and database services.<\/li>\n\n\n\n
  • Automate administrative tasks.<\/li>\n\n\n\n
  • Integrate MongoDB Atlas operations into CI\/CD pipelines.<\/li>\n\n\n\n
  • Use named configuration profiles across environments.<\/li>\n<\/ul>\n\n\n\n

    In this tutorial, we will install MongoDB Atlas CLI on macOS, Windows, and Linux, authenticate with MongoDB Atlas, and execute essential commands.<\/p>\n\n\n\n

    2. What Is MongoDB Atlas CLI?<\/h2>\n\n\n\n

    MongoDB Atlas CLI is MongoDB’s official command-line tool for interacting with MongoDB Atlas.<\/p>\n\n\n\n

    The CLI executable is named:<\/p>\n\n\n

    atlas<\/code><\/span><\/pre>\n\n\n
    For example, you can check the installed version:<\/p>\n\n\n
    atlas --version<\/code><\/span><\/pre>\n\n\n
    Authenticate with your MongoDB Atlas account:<\/p>\n\n\n
    atlas auth login<\/code><\/span><\/pre>\n\n\n
    List accessible Atlas projects:<\/p>\n\n\n
    atlas projects list<\/span><\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
    List clusters in the selected project:<\/p>\n\n\n
    atlas clusters list<\/span><\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
    MongoDB Atlas CLI vs. MongoDB Shell<\/h3>\n\n\n\n
    It is important to distinguish MongoDB Atlas CLI from MongoDB Shell (mongosh<\/code>).<\/p>\n\n\n\n
    Feature<\/th>MongoDB Atlas CLI<\/th>MongoDB Shell<\/th><\/tr>
    Executable<\/td>atlas<\/code><\/td>mongosh<\/code><\/td><\/tr>
    Primary purpose<\/td>Manage Atlas infrastructure<\/td>Query and modify database data<\/td><\/tr>
    Manage Atlas projects<\/td>Yes<\/td>No<\/td><\/tr>
    Manage Atlas clusters<\/td>Yes<\/td>No<\/td><\/tr>
    Execute MongoDB queries<\/td>Not its primary purpose<\/td>Yes<\/td><\/tr>
    Database administration<\/td>Atlas resource administration<\/td>Database-level operations<\/td><\/tr>
    CI\/CD integration<\/td>Yes<\/td>Yes<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
    Important:<\/strong> Installing Atlas CLI does not install a MongoDB database server. Homebrew’s Atlas CLI package also installs mongosh<\/code>, but other distribution methods may require MongoDB Shell to be installed separately.<\/p>\n\n\n\n
    \n\n\n\n
    3. System Requirements<\/h2>\n\n\n\n
    Before installation, confirm that your operating system is supported.<\/p>\n\n\n\n
    Operating system<\/th>Supported versions<\/th>Architecture<\/th><\/tr>
    macOS<\/td>12.0 or later<\/td>Intel x86-64, ARM64<\/td><\/tr>
    Windows<\/td>Windows 10, 11<\/td>x86-64<\/td><\/tr>
    Windows Server<\/td>2016, 2019<\/td>x86-64<\/td><\/tr>
    Ubuntu<\/td>22.04, 24.04<\/td>x86-64, ARM64<\/td><\/tr>
    Debian<\/td>12, 13<\/td>x86-64, ARM64<\/td><\/tr>
    RHEL \/ CentOS<\/td>8, 9, 10<\/td>x86-64, ARM64<\/td><\/tr>
    Amazon Linux<\/td>2023<\/td>x86-64, ARM64<\/td><\/tr>
    SUSE Linux Enterprise<\/td>15<\/td>x86-64, ARM64<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
    Additional Prerequisites<\/h3>\n\n\n\n
    You should have:<\/p>\n\n\n\n
      \n
    • An active internet connection.<\/li>\n\n\n\n
    • Terminal, Bash, Zsh, PowerShell, or Command Prompt access.<\/li>\n\n\n\n
    • Appropriate permissions to install software.<\/li>\n\n\n\n
    • A MongoDB Atlas account to manage cloud resources.<\/li>\n\n\n\n
    • Access to the required MongoDB Atlas organizations and projects.<\/li>\n<\/ul>\n\n\n\n
      You can create a MongoDB Atlas account from:<\/p>\n\n\n\n
      \nhttps:\/\/www.mongodb.com\/cloud\/atlas\/register\n<\/div><\/figure>\n\n\n\n
      \n\n\n\n
      4. Install MongoDB Atlas CLI on macOS<\/h1>\n\n\n\n
      MongoDB recommends using Homebrew to install Atlas CLI on macOS.<\/p>\n\n\n\n
      This method supports both Intel and Apple Silicon Macs.<\/p>\n\n\n\n
      Step 1: Open Terminal<\/h2>\n\n\n\n
      Open Terminal from:<\/p>\n\n\n\n
      Applications \u2192 Utilities \u2192 Terminal<\/p>\n\n\n\n
      Alternatively, press Command + Space<\/code>, search for Terminal, and open it.<\/p>\n\n\n\n
      Step 2: Check macOS Version<\/h2>\n\n\n\n
      Run:<\/p>\n\n\n
      sw_vers<\/code><\/span><\/pre>\n\n\n
      Example output:<\/p>\n\n\n
      ProductName<\/span>:        macOS\nProductVersion<\/span>:     26.6\nBuildVersion<\/span>:       ...<\/code><\/span>Code language:<\/span> HTTP<\/span> (<\/span>http<\/span>)<\/span><\/small><\/pre>\n\n\n
      The actual values depend on your Mac.<\/p>\n\n\n\n
      Check the processor architecture:<\/p>\n\n\n
      uname -m<\/code><\/span><\/pre>\n\n\n
      Possible outputs:<\/p>\n\n\n
      arm64<\/code><\/span><\/pre>\n\n\n
      This indicates Apple Silicon.<\/p>\n\n\n\n
      Or:<\/p>\n\n\n
      x86_64<\/code><\/span><\/pre>\n\n\n
      This indicates an Intel architecture.<\/p>\n\n\n\n
      Both are supported.<\/p>\n\n\n\n
      Step 3: Check Whether Homebrew Is Installed<\/h2>\n\n\n\n
      Run:<\/p>\n\n\n
      brew --version<\/code><\/span><\/pre>\n\n\n
      If Homebrew is installed, the command displays its version.<\/p>\n\n\n\n
      If you receive:<\/p>\n\n\n
      zsh<\/span>: command not found: brew<\/code><\/span>Code language:<\/span> HTTP<\/span> (<\/span>http<\/span>)<\/span><\/small><\/pre>\n\n\n
      Install Homebrew using the official installer:<\/p>\n\n\n
      \/bin\/bash -c \"$(curl -fsSL https:\/\/raw.githubusercontent.com\/Homebrew\/install\/HEAD\/install.sh)\"<\/span><\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
      Review the installation instructions and complete the prompted steps.<\/p>\n\n\n\n
      On Apple Silicon, Homebrew commonly uses:<\/p>\n\n\n
      \/opt\/homebrew<\/code><\/span><\/pre>\n\n\n
      On Intel Macs, the default prefix is commonly:<\/p>\n\n\n
      \/usr\/local<\/code><\/span><\/pre>\n\n\n
      If brew<\/code> remains unavailable, follow the shell configuration instructions displayed by the Homebrew installer.<\/p>\n\n\n\n
      Verify:<\/p>\n\n\n
      brew --version<\/code><\/span><\/pre>\n\n\n
      Step 4: Update Homebrew<\/h2>\n\n\n\n
      Run:<\/p>\n\n\n
      brew update<\/code><\/span><\/pre>\n\n\n
      This refreshes Homebrew’s package metadata.<\/p>\n\n\n\n
      Step 5: Install MongoDB Atlas CLI<\/h2>\n\n\n\n
      Execute:<\/p>\n\n\n
      brew install mongodb-atlas-cli<\/code><\/span><\/pre>\n\n\n
      Homebrew downloads and installs the Atlas CLI package.<\/p>\n\n\n\n
      The package also installs MongoDB Shell (mongosh<\/code>).<\/p>\n\n\n\n
      An alternative supported Homebrew package name is:<\/p>\n\n\n
      brew install mongodb-atlas<\/code><\/span><\/pre>\n\n\n
      Use either package, not both.<\/p>\n\n\n\n
      Step 6: Verify MongoDB Atlas CLI Installation<\/h2>\n\n\n\n
      Run:<\/p>\n\n\n
      atlas --version<\/code><\/span><\/pre>\n\n\n
      Example output format:<\/p>\n\n\n
      atlascli<\/span> version<\/span>: 1.x<\/span>.x<\/span><\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
      The exact output varies by release.<\/p>\n\n\n\n
      Display available commands:<\/p>\n\n\n
      atlas --help<\/code><\/span><\/pre>\n\n\n
      Or:<\/p>\n\n\n
      atlas<\/code><\/span><\/pre>\n\n\n
      If the CLI displays usage information and available commands, the installation is successful.<\/p>\n\n\n\n
      Step 7: Check the Atlas CLI Executable<\/h2>\n\n\n\n
      Run:<\/p>\n\n\n
      which atlas<\/code><\/span><\/pre>\n\n\n
      Or:<\/p>\n\n\n
      command -v atlas<\/code><\/span><\/pre>\n\n\n
      The command returns the executable path.<\/p>\n\n\n\n
      For an Apple Silicon Homebrew installation, it may look like:<\/p>\n\n\n
      \/opt\/homebrew\/bin\/atlas<\/code><\/span><\/pre>\n\n\n
      On an Intel Mac, it may be:<\/p>\n\n\n
      \/usr\/local\/bin\/atlas<\/code><\/span><\/pre>\n\n\n
      Step 8: Verify MongoDB Shell (Optional)<\/h2>\n\n\n\n
      Run:<\/p>\n\n\n
      mongosh --version<\/code><\/span><\/pre>\n\n\n
      This confirms that MongoDB Shell is available.<\/p>\n\n\n\n
      MongoDB Atlas CLI is now installed on macOS.<\/strong><\/p>\n\n\n\n
      \n\n\n\n
      5. Install MongoDB Atlas CLI on Windows 10\/11<\/h1>\n\n\n\n
      MongoDB provides official Windows installer packages in MSI and ZIP formats.<\/p>\n\n\n\n
      The MSI installer is generally the simplest option for Windows users.<\/p>\n\n\n\n
      Method 1: Install Using the Windows MSI Installer<\/h2>\n\n\n\n
      Step 1: Check Windows Architecture<\/h3>\n\n\n\n
      Open PowerShell.<\/p>\n\n\n\n
      Execute:<\/p>\n\n\n
      [System.Runtime.InteropServices.RuntimeInformation]<\/span>::OSArchitecture<\/span><\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
      Expected result on a supported x64 system:<\/p>\n\n\n
      X64<\/code><\/span><\/pre>\n\n\n
      Step 2: Download Atlas CLI for Windows<\/h3>\n\n\n\n
      Visit the official MongoDB Atlas CLI installation page:<\/p>\n\n\n\n
      \nhttps:\/\/www.mongodb.com\/docs\/atlas\/cli\/current\/install-atlas-cli\n<\/div><\/figure>\n\n\n\n
      Or the official release page:<\/p>\n\n\n\n
      \nhttps:\/\/github.com\/mongodb\/mongodb-atlas-cli\/releases\/latest\n<\/div><\/figure>\n\n\n\n
      Download the appropriate Windows x86-64 MSI installer.<\/p>\n\n\n\n
      Step 3: Run the MSI Installer<\/h3>\n\n\n\n
      Locate the downloaded .msi<\/code> file.<\/p>\n\n\n\n
      Double-click it and follow the installation wizard.<\/p>\n\n\n\n
      Accept the installation location and complete the installation.<\/p>\n\n\n\n
      Depending on your environment, administrator permissions may be required.<\/p>\n\n\n\n
      Step 4: Open a New PowerShell Terminal<\/h3>\n\n\n\n
      After installation, open a new PowerShell window.<\/p>\n\n\n\n
      Execute:<\/p>\n\n\n
      atlas --version<\/code><\/span><\/pre>\n\n\n
      Then:<\/p>\n\n\n
      atlas --help<\/code><\/span><\/pre>\n\n\n
      If both commands work, the installation is complete.<\/p>\n\n\n\n
      Step 5: Verify the Executable Location<\/h3>\n\n\n\n
      Run:<\/p>\n\n\n
      Get-Command atlas<\/code><\/span><\/pre>\n\n\n
      Alternatively:<\/p>\n\n\n
      where<\/span>.exe<\/span> atlas<\/span><\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
      These commands help identify which executable Windows is using.<\/p>\n\n\n\n
      If Atlas CLI is not found, check the installation directory and configure your Windows PATH environment variable.<\/p>\n\n\n\n
      Method 2: Install Using the Windows ZIP Package<\/h2>\n\n\n\n
      This method is useful if you prefer a portable installation or do not want to use MSI.<\/p>\n\n\n\n
      Step 1: Download the ZIP Package<\/h3>\n\n\n\n
      Download the official Windows x86-64 ZIP archive from the latest release page.<\/p>\n\n\n\n
      For the commands below, rename the downloaded ZIP file to:<\/p>\n\n\n
      atlas-cli-windows<\/span>.zip<\/span><\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
      Place it in your Downloads folder.<\/p>\n\n\n\n
      Step 2: Create an Installation Directory<\/h3>\n\n\n\n
      Open PowerShell:<\/p>\n\n\n
      $installDir = Join-Path $HOME \"Tools\\AtlasCLI\"<\/span>\n\nNew<\/span>-Item -ItemType Directory -Path $installDir -Force<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
      Step 3: Extract the Package<\/h3>\n\n\n\n
      Run:<\/p>\n\n\n
      Expand-Archive `\n  -Path \"$HOME\\Downloads\\atlas-cli-windows.zip\"<\/span> `\n  -DestinationPath $installDir `\n  -Force<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
      Step 4: Locate atlas.exe<\/h3>\n\n\n\n
      Execute:<\/p>\n\n\n
      Get-ChildItem -Path $installDir -Recurse -Filter atlas.exe<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
      Identify the directory containing atlas.exe<\/code>.<\/p>\n\n\n\n
      If the executable is in a nested folder, move it to the main installation directory:<\/p>\n\n\n
      $atlasExe = Get-ChildItem -Path $installDir -Recurse -Filter atlas.exe |\n    Select-Object -First 1<\/span>\n\nif<\/span> (-not $atlasExe) {\n    throw<\/span> \"atlas.exe was not found in the extracted archive.\"<\/span>\n}\n\nif<\/span> ($atlasExe.DirectoryName -ne $installDir) {\n    Copy-Item $atlasExe.FullName (Join-Path $installDir \"atlas.exe\"<\/span>) -Force\n}<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
      Step 5: Test the Executable<\/h3>\n\n\n\n
      Run:<\/p>\n\n\n
      & \"$installDir\\atlas.exe\"<\/span> --version<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
      Step 6: Add Atlas CLI to the Windows PATH<\/h3>\n\n\n\n
      Execute:<\/p>\n\n\n
      $userPath = [Environment]::GetEnvironmentVariable(\"Path\"<\/span>, \"User\"<\/span>)\n\nif<\/span> (($userPath -split \";\"<\/span>) -notcontains $installDir) {\n    $newPath = ($userPath.TrimEnd(\";\"<\/span>) + \";\"<\/span> + $installDir).TrimStart(\";\"<\/span>)\n\n    [Environment]::SetEnvironmentVariable(\n        \"Path\"<\/span>,\n        $newPath,\n        \"User\"<\/span>\n    )\n}<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
      Update the current PowerShell session:<\/p>\n\n\n
      $env:Path += \";$installDir\"<\/span><\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
      Step 7: Verify Installation<\/h3>\n\n\n\n
      Run:<\/p>\n\n\n
      atlas --version<\/code><\/span><\/pre>\n\n\n
      Then:<\/p>\n\n\n
      atlas --help<\/code><\/span><\/pre>\n\n\n
      MongoDB Atlas CLI is now ready to use on Windows.<\/p>\n\n\n\n
      \n\n\n\n
      6. Install MongoDB Atlas CLI on Ubuntu Linux<\/h1>\n\n\n\n
      MongoDB provides Debian packages and an official APT installation method.<\/p>\n\n\n\n
      The following repository example follows MongoDB’s documented Ubuntu 22.04 (jammy<\/code>) repository configuration.<\/p>\n\n\n\n
      Method 1: Install Using APT on Ubuntu 22.04<\/h2>\n\n\n\n
      Step 1: Check Ubuntu Version<\/h3>\n\n\n\n
      Execute:<\/p>\n\n\n
      cat \/etc\/os-release<\/code><\/span><\/pre>\n\n\n
      Check architecture:<\/p>\n\n\n
      uname -m<\/code><\/span><\/pre>\n\n\n
      Possible values include:<\/p>\n\n\n
      x86_64<\/code><\/span><\/pre>\n\n\n
      Or:<\/p>\n\n\n
      aarch64<\/code><\/span><\/pre>\n\n\n
      Step 2: Update Package Metadata<\/h3>\n\n\n
      sudo apt-get<\/span> update<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
      Step 3: Install Dependencies<\/h3>\n\n\n
      sudo apt-get<\/span> install -y curl gnupg ca-certificates<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
      Step 4: Import MongoDB’s Repository Signing Key<\/h3>\n\n\n\n
      Execute:<\/p>\n\n\n
      curl -fsSL https:\/\/pgp.mongodb.com\/server-8.0.asc | \\<\/span>\n  sudo gpg -o \/usr\/share\/keyrings\/mongodb-server-8.0<\/span>.gpg \\\n  --dearmor<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
      This imports the repository signing key into a dedicated keyring.<\/p>\n\n\n\n
      Step 5: Add the MongoDB Repository<\/h3>\n\n\n\n
      Execute:<\/p>\n\n\n
      echo<\/span> \"deb [ arch=amd64,arm64 signed-by=\/usr\/share\/keyrings\/mongodb-server-8.0.gpg ] \\\nhttps:\/\/repo.mongodb.com\/apt\/ubuntu jammy\/mongodb-enterprise\/8.0 \\\nmultiverse\"<\/span> | sudo tee \/etc\/apt\/sources.list<\/span>.d\/mongodb-enterprise-8.0<\/span>.list<\/span><\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
      Note:<\/strong> This repository command specifically uses Ubuntu jammy<\/code> (22.04). Do not blindly reuse it on Ubuntu 24.04 or Debian. For those systems, use the direct package installation method below or the repository configuration documented for your distribution.<\/p>\n\n\n\n
      Step 6: Update APT<\/h3>\n\n\n
      sudo apt-get<\/span> update<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
      Step 7: Install MongoDB Atlas CLI<\/h3>\n\n\n\n
      Execute:<\/p>\n\n\n
      sudo apt-get<\/span> install -y mongodb-atlas<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
      Notice the package name:<\/p>\n\n\n
      mongodb-atlas<\/code><\/span><\/pre>\n\n\n
      This is the documented APT repository package name, whereas the Homebrew package is named mongodb-atlas-cli<\/code>.<\/p>\n\n\n\n
      Step 8: Verify Installation<\/h3>\n\n\n\n
      Run:<\/p>\n\n\n
      atlas --version<\/code><\/span><\/pre>\n\n\n
      And:<\/p>\n\n\n
      atlas --help<\/code><\/span><\/pre>\n\n\n
      Find the executable:<\/p>\n\n\n
      command -v atlas<\/code><\/span><\/pre>\n\n\n
      Check the installed package:<\/p>\n\n\n
      dpkg -l mongodb-atlas<\/code><\/span><\/pre>\n\n\n
      The installation is complete.<\/p>\n\n\n\n
      Method 2: Install Using a DEB File on Ubuntu or Debian<\/h2>\n\n\n\n
      This approach is useful on supported Ubuntu and Debian versions when you do not want to configure an additional APT repository.<\/p>\n\n\n\n
      Step 1: Download the Package<\/h3>\n\n\n\n
      Open:<\/p>\n\n\n\n
      \nhttps:\/\/github.com\/mongodb\/mongodb-atlas-cli\/releases\/latest\n<\/div><\/figure>\n\n\n\n
      Download the Linux .deb<\/code> file matching your architecture.<\/p>\n\n\n\n
      For example, release assets use names in this format:<\/p>\n\n\n
      mongodb-atlas-cli_1<\/span>.59<\/span>.3_linux_x86_64<\/span>.deb<\/span><\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
      For ARM64:<\/p>\n\n\n
      mongodb-atlas-cli_1<\/span>.59<\/span>.3_linux_arm64<\/span>.deb<\/span><\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
      These filenames refer to release 1.59.3. Use the equivalent filename for whichever version you download.<\/p>\n\n\n\n
      Step 2: Navigate to Downloads<\/h3>\n\n\n
      cd ~\/Downloads<\/code><\/span><\/pre>\n\n\n
      Step 3: Install the Package<\/h3>\n\n\n\n
      For an x86-64 package, using the filename above:<\/p>\n\n\n
      sudo apt install .\/mongodb-atlas-cli_1.59.3_linux_x86_64.deb<\/code><\/span><\/pre>\n\n\n
      For ARM64:<\/p>\n\n\n
      sudo apt install .\/mongodb-atlas-cli_1.59.3_linux_arm64.deb<\/code><\/span><\/pre>\n\n\n
      Use only the command corresponding to your downloaded file and architecture.<\/p>\n\n\n\n
      APT attempts to resolve dependencies using the configured repositories.<\/p>\n\n\n\n
      Step 4: Verify Installation<\/h3>\n\n\n
      atlas --version<\/code><\/span><\/pre>\n\n
      atlas --help<\/code><\/span><\/pre>\n\n\n
      MongoDB Atlas CLI is now installed.<\/p>\n\n\n\n
      \n\n\n\n
      7. Install MongoDB Atlas CLI on RHEL and CentOS<\/h1>\n\n\n\n
      MongoDB also supports RHEL and CentOS through RPM packages and YUM-compatible repositories.<\/p>\n\n\n\n
      Method 1: Install Using the MongoDB YUM Repository<\/h2>\n\n\n\n
      Step 1: Check the Operating System<\/h3>\n\n\n\n
      Execute:<\/p>\n\n\n
      cat \/etc\/os-release<\/code><\/span><\/pre>\n\n\n
      Check processor architecture:<\/p>\n\n\n
      uname -m<\/code><\/span><\/pre>\n\n\n
      Step 2: Create the MongoDB Repository Configuration<\/h3>\n\n\n\n
      Run:<\/p>\n\n\n
      sudo tee \/etc\/yum.repos.d\/mongodb-enterprise-8.0.repo <<EOF<\/code><\/span><\/pre>\n\n
      [mongodb-enterprise-8.0]<\/p>\n\n\n\n
      name=MongoDB Enterprise Repository baseurl=https:\/\/repo.mongodb.com\/yum\/redhat\/\\$releasever\/mongodb-enterprise\/8.0\/\\$basearch\/ gpgcheck=1 enabled=1 gpgkey=https:\/\/pgp.mongodb.com\/server-8.0.asc EOF<\/p>\n\n\n\n
      This configures MongoDB’s documented Enterprise 8.0 RPM repository.<\/p>\n\n\n\n
      Step 3: Install MongoDB Atlas CLI<\/h3>\n\n\n\n
      Execute:<\/p>\n\n\n
      sudo yum install -y mongodb-atlas<\/code><\/span><\/pre>\n\n\n
      On modern RHEL-based systems, dnf<\/code> is also commonly available:<\/p>\n\n\n
      sudo dnf install -y mongodb-atlas<\/code><\/span><\/pre>\n\n\n
      Use the package manager supported by your distribution.<\/p>\n\n\n\n
      Step 4: Verify Installation<\/h3>\n\n\n\n
      Run:<\/p>\n\n\n
      atlas --version<\/code><\/span><\/pre>\n\n\n
      Check the package:<\/p>\n\n\n
      rpm -q mongodb-atlas<\/code><\/span><\/pre>\n\n\n
      Display available commands:<\/p>\n\n\n
      atlas --help<\/code><\/span><\/pre>\n\n\n
      Method 2: Install Directly from an RPM Package<\/h2>\n\n\n\n
      Download the appropriate RPM package from:<\/p>\n\n\n\n
      \nhttps:\/\/github.com\/mongodb\/mongodb-atlas-cli\/releases\/latest\n<\/div><\/figure>\n\n\n\n
      For example:<\/p>\n\n\n
      mongodb-atlas-cli_1<\/span>.59<\/span>.3_linux_x86_64<\/span>.rpm<\/span><\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
      Navigate to the downloaded package directory:<\/p>\n\n\n
      cd ~\/Downloads<\/code><\/span><\/pre>\n\n\n
      Install:<\/p>\n\n\n
      sudo dnf install .\/mongodb-atlas-cli_1.59.3_linux_x86_64.rpm<\/code><\/span><\/pre>\n\n\n
      For ARM64, download the corresponding linux_arm64.rpm<\/code> package instead.<\/p>\n\n\n\n
      Verify:<\/p>\n\n\n
      atlas --version<\/code><\/span><\/pre>\n\n\n
      Amazon Linux:<\/strong> For Amazon Linux 2023, use a compatible RPM package or confirm the appropriate repository configuration for your platform before installation.<\/p>\n\n\n\n
      \n\n\n\n
      8. Alternative Linux Installation Using a TAR.GZ Archive<\/h1>\n\n\n\n
      MongoDB also distributes standalone Linux binary archives.<\/p>\n\n\n\n
      This method is useful when you want to install the CLI without managing an RPM or Debian package.<\/p>\n\n\n\n
      Step 1: Download the Correct Archive<\/h3>\n\n\n\n
      Visit:<\/p>\n\n\n\n
      \nhttps:\/\/github.com\/mongodb\/mongodb-atlas-cli\/releases\/latest\n<\/div><\/figure>\n\n\n\n
      Download the Linux TAR.GZ archive corresponding to your processor architecture.<\/p>\n\n\n\n
      For example:<\/p>\n\n\n
      mongodb-atlas-cli_1<\/span>.59<\/span>.3_linux_x86_64<\/span>.tar<\/span>.gz<\/span><\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
      Step 2: Extract the Archive<\/h3>\n\n\n\n
      Navigate to Downloads:<\/p>\n\n\n
      cd ~\/Downloads<\/code><\/span><\/pre>\n\n\n
      Extract:<\/p>\n\n\n
      tar<\/span> -xzf<\/span> mongodb-atlas-cli_1<\/span>.59<\/span>.3_linux_x86_64<\/span>.tar<\/span>.gz<\/span><\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
      Step 3: Locate the Executable<\/h3>\n\n\n\n
      Run:<\/p>\n\n\n
      find . -type f -name atlas<\/code><\/span><\/pre>\n\n\n
      The command locates an executable named atlas<\/code> in the extracted files.<\/p>\n\n\n\n
      Step 4: Install the Binary<\/h3>\n\n\n\n
      After finding the extracted executable, install it in a directory on your PATH<\/code>.<\/p>\n\n\n\n
      For example, if the extracted binary is at .\/bin\/atlas<\/code>:<\/p>\n\n\n
      sudo install -m 0755 .\/bin\/atlas \/usr\/local\/bin\/atlas<\/code><\/span><\/pre>\n\n\n
      Adjust the source path if the extracted archive uses a different directory structure.<\/p>\n\n\n\n
      Step 5: Verify Installation<\/h3>\n\n\n
      atlas --version<\/code><\/span><\/pre>\n\n\n
      You can now invoke the Atlas CLI from any terminal directory.<\/p>\n\n\n\n
      \n\n\n\n
      9. Authenticate with MongoDB Atlas CLI<\/h1>\n\n\n\n
      After installing the CLI, the next step is authenticating with MongoDB Atlas.<\/p>\n\n\n\n
      Step 1: Log In Using Your Atlas Account<\/h2>\n\n\n\n
      Run:<\/p>\n\n\n
      atlas auth login<\/code><\/span><\/pre>\n\n\n
      The CLI initiates an authentication workflow using your browser.<\/p>\n\n\n\n
      A one-time activation code is generated.<\/p>\n\n\n\n
      The code expires after approximately 10 minutes.<\/p>\n\n\n\n
      Complete the authentication process in the browser and return to the terminal.<\/p>\n\n\n\n
      Step 2: Verify Authentication<\/h2>\n\n\n\n
      Execute:<\/p>\n\n\n
      atlas auth whoami<\/code><\/span><\/pre>\n\n\n
      This command displays information about the currently authenticated identity.<\/p>\n\n\n\n
      Step 3: List MongoDB Atlas Projects<\/h2>\n\n\n\n
      Run:<\/p>\n\n\n
      atlas projects list<\/span><\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
      The command lists projects accessible to the authenticated identity, subject to the required permissions.<\/p>\n\n\n\n
      For JSON-formatted output:<\/p>\n\n\n
      atlas projects list<\/span> --output json<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
      Step 4: List MongoDB Atlas Clusters<\/h2>\n\n\n\n
      Execute:<\/p>\n\n\n
      atlas clusters list<\/span><\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
      To query a specific project without changing your default configuration:<\/p>\n\n\n
      atlas clusters list<\/span> --projectId YOUR_PROJECT_ID<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
      Replace YOUR_PROJECT_ID<\/code> with your actual MongoDB Atlas project ID.<\/p>\n\n\n\n
      Step 5: View Cluster Details<\/h2>\n\n\n\n
      Run:<\/p>\n\n\n
      atlas clusters describe YOUR_CLUSTER_NAME<\/code><\/span><\/pre>\n\n\n
      Specify the project if necessary:<\/p>\n\n\n
      atlas clusters describe YOUR_CLUSTER_NAME \\\n  --projectId YOUR_PROJECT_ID<\/code><\/span><\/pre>\n\n\n
      On PowerShell, keep the command on one line or use PowerShell’s backtick continuation syntax instead of Bash’s backslash.<\/p>\n\n\n\n
      Step 6: Log Out<\/h2>\n\n\n
      atlas auth logout<\/code><\/span><\/pre>\n\n\n
      This ends the CLI’s authenticated session.<\/p>\n\n\n\n
      \n\n\n\n
      10. Configure Atlas CLI Using API Keys<\/h1>\n\n\n\n
      For CI\/CD pipelines, Terraform workflows, infrastructure automation, or unattended scripts, interactive browser authentication is generally not appropriate.<\/p>\n\n\n\n
      MongoDB Atlas supports API key and service-account authentication.<\/p>\n\n\n\n
      Step 1: Create an Atlas API Key<\/h2>\n\n\n\n
      In the MongoDB Atlas console, configure an appropriate organization or project API key with the required permissions.<\/p>\n\n\n\n
      Keep access scoped to the operations the automation needs.<\/p>\n\n\n\n
      Step 2: Initialize the CLI Configuration<\/h2>\n\n\n\n
      Run:<\/p>\n\n\n
      atlas config init<\/code><\/span><\/pre>\n\n\n
      The CLI prompts for the API credentials and configuration information.<\/p>\n\n\n\n
      Use the prompts rather than placing private credentials directly in command arguments.<\/p>\n\n\n\n
      Step 3: Verify the Configuration<\/h2>\n\n\n\n
      Execute:<\/p>\n\n\n
      atlas config list<\/span><\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
      To inspect the default profile:<\/p>\n\n\n
      atlas config describe default<\/span><\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
      Sensitive API key values are redacted from the normal configuration description output.<\/p>\n\n\n\n
      Security recommendation:<\/strong> For automated environments, prefer MongoDB Atlas service accounts or appropriately scoped API keys, managed through a secure secrets platform. Avoid committing credentials or CLI configuration files containing secrets to Git.<\/p>\n\n\n\n
      \n\n\n\n
      11. Manage Multiple Atlas Environments with Profiles<\/h1>\n\n\n\n
      When working with development, staging, and production environments, separate Atlas CLI profiles can help reduce mistakes.<\/p>\n\n\n\n
      Step 1: Configure a Development Profile<\/h2>\n\n\n
      atlas auth login --profile development<\/code><\/span><\/pre>\n\n\n
      Complete the authentication process.<\/p>\n\n\n\n
      Step 2: Configure a Production Profile<\/h2>\n\n\n
      atlas auth login --profile production<\/code><\/span><\/pre>\n\n\n
      Use the appropriate account and organization permissions.<\/p>\n\n\n\n
      Step 3: List Configured Profiles<\/h2>\n\n\n
      atlas config list<\/span><\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
      Step 4: Run Commands with a Specific Profile<\/h2>\n\n\n\n
      Development:<\/p>\n\n\n
      atlas clusters list<\/span> --profile development<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
      Production:<\/p>\n\n\n
      atlas clusters list<\/span> --profile production<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
      Profiles can store default organization and project information.<\/p>\n\n\n\n
      Important:<\/strong> Profile names do not themselves enforce environment isolation. Permissions depend on the Atlas identity, organization roles, project roles, and credentials associated with each profile. Explicitly specifying --projectId<\/code> is useful when running commands against sensitive resources.<\/p>\n\n\n\n
      \n\n\n\n
      12. Essential MongoDB Atlas CLI Commands<\/h1>\n\n\n\n
      The following commands are useful immediately after installation.<\/p>\n\n\n\n
      Task<\/th>Command<\/th><\/tr>
      Check CLI version<\/td>atlas --version<\/code><\/td><\/tr>
      Show help<\/td>atlas --help<\/code><\/td><\/tr>
      Log in<\/td>atlas auth login<\/code><\/td><\/tr>
      Check authenticated identity<\/td>atlas auth whoami<\/code><\/td><\/tr>
      Log out<\/td>atlas auth logout<\/code><\/td><\/tr>
      List projects<\/td>atlas projects list<\/code><\/td><\/tr>
      List clusters<\/td>atlas clusters list<\/code><\/td><\/tr>
      View cluster details<\/td>atlas clusters describe CLUSTER_NAME<\/code><\/td><\/tr>
      List profiles<\/td>atlas config list<\/code><\/td><\/tr>
      Configure API keys interactively<\/td>atlas config init<\/code><\/td><\/tr>
      View profile configuration<\/td>atlas config describe default<\/code><\/td><\/tr>
      View project JSON<\/td>atlas projects list --output json<\/code><\/td><\/tr>
      Show cluster help<\/td>atlas clusters --help<\/code><\/td><\/tr>
      Show API command help<\/td>atlas api --help<\/code><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
      Example: Validate Atlas CLI and Cluster Access<\/h2>\n\n\n\n
      The following Bash script checks that the CLI is installed and confirms access to MongoDB Atlas:<\/p>\n\n\n
      #!\/usr\/bin\/env bash<\/span>\n\nset -euo pipefail\n\necho<\/span> \"Checking MongoDB Atlas CLI...\"<\/span>\n\natlas --version\n\necho<\/span> \"Checking authentication...\"<\/span>\n\natlas auth whoami\n\necho<\/span> \"Listing available projects...\"<\/span>\n\natlas projects list<\/span>\n\necho<\/span> \"Listing clusters in the selected project...\"<\/span>\n\natlas clusters list<\/span>\n\necho<\/span> \"Validation completed successfully.\"<\/span><\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
      Save the file as:<\/p>\n\n\n
      check-atlas-cli<\/span>.sh<\/span><\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
      Make it executable:<\/p>\n\n\n
      chmod<\/span> +x<\/span> check-atlas-cli<\/span>.sh<\/span><\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
      Execute:<\/p>\n\n\n
      .\/check-atlas-cli.sh<\/code><\/span><\/pre>\n\n\n
      This is a read-only validation example. It does not create, update, or delete cloud resources.<\/p>\n\n\n\n
      \n\n\n\n
      13. How to Update MongoDB Atlas CLI<\/h1>\n\n\n\n
      Keeping the CLI updated helps maintain compatibility and provides access to bug fixes and new functionality.<\/p>\n\n\n\n
      macOS \u2014 Homebrew<\/h2>\n\n\n
      brew update\nbrew upgrade mongodb-atlas-cli<\/code><\/span><\/pre>\n\n\n
      If you installed using the alternative Homebrew package:<\/p>\n\n\n
      brew upgrade mongodb-atlas<\/code><\/span><\/pre>\n\n\n
      Verify:<\/p>\n\n\n
      atlas --version<\/code><\/span><\/pre>\n\n\n
      Ubuntu\/Debian \u2014 APT Repository Installation<\/h2>\n\n\n
      sudo apt-get<\/span> update\nsudo apt-get<\/span> install --only-upgrade mongodb-atlas<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
      This assumes you installed the mongodb-atlas<\/code> package from a configured APT repository.<\/p>\n\n\n\n
      If you installed a downloaded DEB package instead, obtain the updated DEB file and install that version.<\/p>\n\n\n\n
      RHEL\/CentOS \u2014 YUM or DNF<\/h2>\n\n\n
      sudo yum update mongodb-atlas<\/code><\/span><\/pre>\n\n\n
      Or:<\/p>\n\n\n
      sudo dnf upgrade mongodb-atlas<\/code><\/span><\/pre>\n\n\n
      Windows \u2014 MSI<\/h2>\n\n\n\n
      Download the latest supported MSI installer and run the installation.<\/p>\n\n\n\n
      For ZIP-based installations, download the updated ZIP and replace the old executable with the new one after verifying the package.<\/p>\n\n\n\n
      Always confirm:<\/p>\n\n\n
      atlas --version<\/code><\/span><\/pre>\n\n\n
      \n\n\n\n
      14. Troubleshooting Common MongoDB Atlas CLI Errors<\/h1>\n\n\n\n
      Error or issue<\/th>Possible cause<\/th>Recommended fix<\/th><\/tr>
      atlas: command not found<\/code><\/td>CLI not installed or PATH missing<\/td>Verify executable location and PATH<\/td><\/tr>
      zsh: command not found: brew<\/code><\/td>Homebrew missing or incorrectly configured<\/td>Install\/configure Homebrew<\/td><\/tr>
      atlas is not recognized<\/code><\/td>Windows cannot locate executable<\/td>Add the CLI directory to PATH<\/td><\/tr>
      Permission denied<\/code><\/td>Executable permission problem<\/td>Verify permissions and installation path<\/td><\/tr>
      exec format error<\/code><\/td>Incorrect operating system or CPU architecture<\/td>Download the correct binary<\/td><\/tr>
      401 Unauthorized<\/code><\/td>Invalid or expired authentication<\/td>Reauthenticate and verify credentials<\/td><\/tr>
      403 Forbidden<\/code><\/td>Insufficient Atlas permissions<\/td>Review organization\/project roles and API access settings<\/td><\/tr>
      TLS certificate error<\/td>Certificate trust or proxy issue<\/td>Check CA certificates and network configuration<\/td><\/tr>
      APT repository error<\/td>Incorrect source, signing key, or distribution<\/td>Check the repository setup<\/td><\/tr>
      Authentication timeout<\/td>Network, proxy, or browser authentication issue<\/td>Verify connectivity and repeat login<\/td><\/tr>
      No clusters returned<\/td>Incorrect project selection or insufficient access<\/td>Check profile, project ID, and permissions<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
      Troubleshooting 1: atlas Command Not Found on macOS<\/h2>\n\n\n\n
      Run:<\/p>\n\n\n
      command -v atlas<\/code><\/span><\/pre>\n\n\n
      Check the installed Homebrew package:<\/p>\n\n\n
      brew list<\/span> mongodb-atlas-cli<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
      Verify your shell PATH:<\/p>\n\n\n
      echo<\/span> \"$PATH\"<\/span><\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
      If Homebrew is installed but unavailable in the shell, check the Homebrew environment configuration.<\/p>\n\n\n\n
      Troubleshooting 2: Atlas CLI Not Recognized on Windows<\/h2>\n\n\n\n
      Run:<\/p>\n\n\n
      Get-Command atlas<\/code><\/span><\/pre>\n\n\n
      Check PATH:<\/p>\n\n\n
      $env:Path<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
      Confirm that the directory containing atlas.exe<\/code> is present.<\/p>\n\n\n\n
      If you just updated PATH, close and reopen PowerShell.<\/p>\n\n\n\n
      Troubleshooting 3: MongoDB Atlas Authentication Failed<\/h2>\n\n\n\n
      First verify local installation:<\/p>\n\n\n
      atlas --version<\/code><\/span><\/pre>\n\n\n
      Try logging in again:<\/p>\n\n\n
      atlas auth login<\/code><\/span><\/pre>\n\n\n
      Check your authentication state:<\/p>\n\n\n
      atlas auth whoami<\/code><\/span><\/pre>\n\n\n
      If an API key is being used, verify its validity, scope, and applicable access-list requirements.<\/p>\n\n\n\n
      Troubleshooting 4: Cannot List MongoDB Atlas Clusters<\/h2>\n\n\n\n
      Run:<\/p>\n\n\n
      atlas projects list<\/span><\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
      Then explicitly specify the target project:<\/p>\n\n\n
      atlas clusters list<\/span> --projectId YOUR_PROJECT_ID<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
      If the operation returns an authorization error, confirm the identity has sufficient project-level permissions.<\/p>\n\n\n\n
      Troubleshooting 5: Network or Proxy Problems<\/h2>\n\n\n\n
      Organizations using corporate firewalls may require proxy configuration.<\/p>\n\n\n\n
      For Bash:<\/p>\n\n\n
      export<\/span> HTTPS_PROXY=\"http:\/\/proxy.example.com:8080\"<\/span><\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
      For Windows PowerShell:<\/p>\n\n\n
      $env:HTTPS_PROXY = \"http:\/\/proxy.example.com:8080\"<\/span><\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
      The proxy address is an illustrative placeholder. Replace it with your organization’s approved proxy settings.<\/p>\n\n\n\n
      For normal operations, use a trusted certificate chain rather than disabling TLS certificate verification.<\/p>\n\n\n\n
      \n\n\n\n
      15. How to Uninstall MongoDB Atlas CLI<\/h1>\n\n\n\n
      macOS<\/h2>\n\n\n\n
      If installed with Homebrew:<\/p>\n\n\n
      brew uninstall mongodb-atlas-cli<\/code><\/span><\/pre>\n\n\n
      Or, if applicable:<\/p>\n\n\n
      brew uninstall mongodb-atlas<\/code><\/span><\/pre>\n\n\n
      Ubuntu\/Debian<\/h2>\n\n\n\n
      For an installation from the MongoDB APT repository:<\/p>\n\n\n
      sudo apt remove mongodb-atlas<\/code><\/span><\/pre>\n\n\n
      For a standalone DEB installation, determine its installed package name first:<\/p>\n\n\n
      dpkg -l | grep -i atlas<\/code><\/span><\/pre>\n\n\n
      Then remove only the corresponding Atlas CLI package.<\/p>\n\n\n\n
      RHEL\/CentOS<\/h2>\n\n\n\n
      For the repository package:<\/p>\n\n\n
      sudo dnf remove mongodb-atlas<\/code><\/span><\/pre>\n\n\n
      For direct RPM installations, first inspect:<\/p>\n\n\n
      rpm -qa | grep -i atlas<\/code><\/span><\/pre>\n\n\n
      Remove the relevant installed package.<\/p>\n\n\n\n
      Windows<\/h2>\n\n\n\n
      For MSI installations, use Windows Settings \u2192 Installed Apps to uninstall MongoDB Atlas CLI.<\/p>\n\n\n\n
      For portable ZIP installations, delete the installed executable and remove its directory from your PATH.<\/p>\n\n\n\n
      Configuration profiles may remain after uninstalling the executable. Delete them only if you intentionally want to remove local authentication and configuration information.<\/p>\n\n\n\n
      \n\n\n\n
      16. Frequently Asked Questions<\/h1>\n\n\n\n
      Q1. Is MongoDB Atlas CLI free to install?<\/h3>\n\n\n\n
      Yes. MongoDB Atlas CLI is freely available to download and install. However, cloud database infrastructure provisioned through Atlas may incur charges.<\/p>\n\n\n\n
      Q2. Do I need MongoDB Server installed to use Atlas CLI?<\/h3>\n\n\n\n
      No. Atlas CLI communicates with MongoDB Atlas management services and does not require a local MongoDB database server.<\/p>\n\n\n\n
      Q3. Does MongoDB Atlas CLI work on Apple Silicon?<\/h3>\n\n\n\n
      Yes. MongoDB Atlas CLI supports ARM-based Apple Silicon Macs.<\/p>\n\n\n\n
      Q4. Can I install MongoDB Atlas CLI on Windows 11?<\/h3>\n\n\n\n
      Yes. Download the official Windows x86-64 MSI or ZIP package.<\/p>\n\n\n\n
      Q5. What is the difference between atlas<\/code> and mongocli<\/code>?<\/h3>\n\n\n\n
      atlas<\/code> is the dedicated MongoDB Atlas CLI. The older MongoDB CLI (mongocli<\/code>) supported MongoDB Atlas, Cloud Manager, and Ops Manager.<\/p>\n\n\n\n
      MongoDB has deprecated mongocli atlas<\/code> commands and recommends migrating Atlas operations to atlas<\/code>.<\/p>\n\n\n\n
      Q6. Can I use MongoDB Atlas CLI with Terraform?<\/h3>\n\n\n\n
      Yes, but the tools serve different purposes.<\/p>\n\n\n\n
      Terraform is typically used to define and manage MongoDB Atlas infrastructure declaratively through the MongoDB Atlas provider.<\/p>\n\n\n\n
      Atlas CLI is useful for interactive administrative operations, troubleshooting, inspection, and scripts.<\/p>\n\n\n\n
      For infrastructure managed by Terraform, avoid making untracked CLI changes that could create configuration drift.<\/p>\n\n\n\n
      Q7. Can I use MongoDB Atlas CLI in GitHub Actions or CI\/CD?<\/h3>\n\n\n\n
      Yes. Use appropriately scoped machine credentials or service accounts with secure secret management.<\/p>\n\n\n\n
      Avoid interactive login commands in unattended pipelines.<\/p>\n\n\n\n
      Q8. Is MongoDB Compass required?<\/h3>\n\n\n\n
      No. MongoDB Compass is an optional graphical tool used to explore and work with MongoDB database data.<\/p>\n\n\n\n
      Atlas CLI works independently.<\/p>\n\n\n\n
      \n\n\n\n
      17. Best Practices for Production Environments<\/h1>\n\n\n\n
      Follow these guidelines when using Atlas CLI in enterprise and production environments:<\/p>\n\n\n\n
        \n
      1. Install Atlas CLI from official MongoDB sources.<\/li>\n\n\n\n
      2. Verify downloaded packages and checksums before deploying to sensitive environments.<\/li>\n\n\n\n
      3. Pin CLI versions in automated environments.<\/li>\n\n\n\n
      4. Use separate, appropriately scoped credentials for development and production.<\/li>\n\n\n\n
      5. Prefer service accounts or narrowly scoped API keys for CI\/CD.<\/li>\n\n\n\n
      6. Avoid storing credentials directly in scripts, repositories, or command history.<\/li>\n\n\n\n
      7. Check the selected organization and project before performing modifications.<\/li>\n\n\n\n
      8. Prefer read-only access for monitoring and inspection workflows.<\/li>\n\n\n\n
      9. Use Terraform or another infrastructure-as-code solution for infrastructure that requires controlled declarative state.<\/li>\n\n\n\n
      10. Review commands and their permissions before running them in production.<\/li>\n<\/ol>\n\n\n\n
        Production safety tip:<\/strong> The atlas setup<\/code> command is useful for first-time onboarding, but it can create database resources, configure network access, and initialize a deployment. Do not run it against an established organization without understanding its effects.<\/p>\n\n\n\n
        \n\n\n\n
        18. MongoDB Atlas CLI Installation Cheat Sheet<\/h1>\n\n\n\n
        Operating system<\/th>Installation<\/th><\/tr>
        macOS Intel<\/td>brew install mongodb-atlas-cli<\/code><\/td><\/tr>
        macOS Apple Silicon<\/td>brew install mongodb-atlas-cli<\/code><\/td><\/tr>
        Windows 10\/11<\/td>Official MSI or ZIP installer<\/td><\/tr>
        Ubuntu 22.04<\/td>Configure MongoDB APT repository, then sudo apt-get install mongodb-atlas<\/code><\/td><\/tr>
        Ubuntu 24.04<\/td>Official compatible DEB package<\/td><\/tr>
        Debian 12\/13<\/td>Official compatible DEB package<\/td><\/tr>
        RHEL\/CentOS<\/td>MongoDB YUM repository or RPM package<\/td><\/tr>
        Amazon Linux 2023<\/td>Compatible official RPM package<\/td><\/tr>
        Other supported Linux systems<\/td>Official TAR.GZ binary<\/td><\/tr>
        Verify<\/td>atlas --version<\/code><\/td><\/tr>
        Authenticate<\/td>atlas auth login<\/code><\/td><\/tr>
        Check authentication<\/td>atlas auth whoami<\/code><\/td><\/tr>
        List projects<\/td>atlas projects list<\/code><\/td><\/tr>
        List clusters<\/td>atlas clusters list<\/code><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
        \n\n\n\n
        19. Conclusion<\/h1>\n\n\n\n
        MongoDB Atlas CLI is an essential command-line tool for developers, database administrators, DevOps engineers, and platform teams managing MongoDB Atlas cloud infrastructure.<\/p>\n\n\n\n
        Installation is straightforward on the three major operating systems:<\/p>\n\n\n\n