> 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

# Troubleshoot Errors

## Troubleshoot Local Atlas Deployment Issues

### Local Machine Issues

If the Atlas CLI slows down to an unusable state after you create multiple local Atlas deployments and load data, you might have reached the limits of your machine.

If you're working on Docker Desktop for [Windows](https://docs.docker.com/desktop/settings/windows/#resources) or [MacOS](https://docs.docker.com/desktop/settings/mac/#resources), consider allocating more memory.

### Docker Issues

The Atlas CLI uses [Docker](https://www.docker.com/) for `atlas deployments` commands.

- For MacOS or Windows, install [Docker Desktop v4.31+.](https://docs.docker.com/desktop/release-notes/#4310)

- For Linux, install [Docker Engine v27.0+.](https://docs.docker.com/engine/release-notes/27/)

If your local Atlas deployment doesn't work, you might need to clean up your Docker environment and start fresh:

```text
docker stop $(docker ps -a -q) && docker system prune -a
```

### Failed to Install or Update the AtlasCLI Plugin

If the Atlas CLI plugin fails to install or update, make sure that you have access to the [GitHub API](https://docs.github.com/en/rest), as GitHub API access is required to install or update the Atlas CLI plugin.

### Run Diagnostics

If you run into issues and with `atlas deployments` commands and need support, run the following command to provide detailed diagnostics:

```sh
atlas deployments diagnostics <deploymentName> --output json > out.json
```

## Command Errors

### Error: missing credentials

Ensure that you either:

- Run `atlas config init` and add your API keys to your [profile](https://www.mongodb.com/docs/atlas/cli/current/atlas-cli-save-connection-settings.md#std-label-config-toml-location) or add your API keys to your [environment variables](https://www.mongodb.com/docs/atlas/cli/current/atlas-cli-env-variables.md#std-label-atlas-cli-env-vars). If you created a profile with a custom name or are using more than one profile, specify the correct profile with the `--profile` flag.

- Run `atlas auth login` to authenticate using your Atlas login credentials and an authentication token.

To learn more, see [Connect from the Atlas CLI.](https://www.mongodb.com/docs/atlas/cli/current/connect-atlas-cli.md#std-label-connect-atlas-cli)

### atlas: command not found

The `atlas` executable might be in a directory that isn't in your $PATH. You can either add the directory to your $PATH, move the executable to a directory which is in your $PATH, or run the executable directly from its location.

### 400 (request "TENANT\_ATTRIBUTE\_READ\_ONLY") The attribute pitEnabled is read-only for tenant clusters and cannot be changed by the user.

This error might appear if you try to run [atlas clusters create](https://www.mongodb.com/docs/atlas/cli/current/command/atlas-clusters-create.md#std-label-atlas-clusters-create) with the `--backup` argument for a shared cluster. The `--backup` argument is unavailable for clusters smaller than `M10`.

### 401 (request "Unauthorized") You are not authorized for this resource.

The credentials you provided aren't valid for the project specified in your Atlas CLI command. Check your public and private key strings for accuracy.

If your credentials are stored in a [configuration file](https://www.mongodb.com/docs/atlas/cli/current/atlas-cli-save-connection-settings.md#std-label-config-toml-location), make sure that the configuration file is in the correct location. To learn more, see [Locate the Configuration File](https://www.mongodb.com/docs/atlas/cli/current/atlas-cli-save-connection-settings.md#std-label-config-toml-location). If the Atlas CLI can't find your configuration file and you don't store credentials in [environment variables](https://www.mongodb.com/docs/atlas/cli/current/atlas-cli-env-variables.md#std-label-atlas-cli-env-vars), a `401` error will result.

### 401 (request "Unauthorized") Current user is not authorized to perform this action.

The user account or API key that you used to [connect to the Atlas CLI](https://www.mongodb.com/docs/atlas/cli/current/connect-atlas-cli.md#std-label-connect-atlas-cli) doesn't have permission to perform the requested action. User accounts and API keys must have the appropriate [user roles](https://www.mongodb.com/docs/atlas/reference/user-roles/) to run Atlas CLI commands. To assign or change a user's roles, see:

- [Manage Organization Users](https://www.mongodb.com/docs/atlas/access/manage-org-users/)

- [Manage Access to a Project](https://www.mongodb.com/docs/atlas/access/manage-project-access/)

- [API configuration](https://www.mongodb.com/docs/atlas/configure-api-access/)

### 401 (request "Unauthorized") The currently logged in user does not have the group creator role in organization \<org-id>.

This error might appear when trying to create a new [project](https://www.mongodb.com/docs/atlas/tutorial/manage-projects/). The user account or API key that you use to authenticate must have the `Organization Project Creator` role at the [organization level](https://www.mongodb.com/docs/atlas/tutorial/manage-organizations/) in order to create new projects.

### 403 (request "Forbidden") IP address \<ip-address> is not allowed to access this resource.

The user's IP address that you use to authenticate is not on the [access list](https://www.mongodb.com/docs/atlas/configure-api-access/) for the requested project. Add your IP address to the [access list](https://www.mongodb.com/docs/atlas/configure-api-access/) to run commands.

To learn more, see the following pages:

- For project access lists, see [Configure IP Access List Entries.](https://www.mongodb.com/docs/atlas/security/ip-access-list/)

- For API key access lists, see [Get Started with the Atlas Administration API.](https://www.mongodb.com/docs/atlas/configure-api-access/)

To add your IP address to an API key's access list:

1. Go to the Access Manager page for your project.

   If it isn't already displayed, select the organization that contains your desired project from the  Organizations menu in the navigation bar.

   Select your desired project from the list of projects in the Projects page.

   Next to the Projects menu, expand the  Options menu, then click Project Settings.

   Click Access Manager in the navigation bar.

2. Go to the API key's access list.

   Click the API Keys tab.

   Click  to the right of the API (Application Programming Interface) Key.

   Click Edit Permissions and click Next.

3. Add your IP address to the API key's access list.

   Do one of the following tasks in the API Access List section:

   - Click Add Access List Entry and type an IP (Internet Protocol) address.

   - If your current host for accessing Atlas will also make API (Application Programming Interface) requests with this API (Application Programming Interface) key, click Use Current IP Address .

   Click Save.

### 404 (request "Not Found") An invalid group ID \<group-id> was specified.

The project ID entered with the command does not exist. Check your project ID by navigating to the Settings sub-section of the Project section in the Atlas left-side navigation.

**Note:**

`group ID` and `project ID` are synonymous in MongoDB cloud services.

### Alert Config Not Deleted

This error might appear if the Atlas CLI can't delete the alert configuration specified by the ID.

### podman not found

This error appears if you try to run an `atlas deployments` command inside our official docker container, `mongodb/atlas` in v1.26 or later. Instead, follow the steps decribed in [Create a Local Atlas Deployment with Docker.](https://www.mongodb.com/docs/atlas/cli/current/atlas-cli-deploy-docker.md#std-label-atlas-cli-deploy-docker)

You should inspect past containers in your cluster with the following command:

```text
podman ps -a
```

Then, remove any that start with `mongod` or `mongot` with the following command:

```text
podman container rm -f -v <name or ID>
```

**Tip:**

You can safely uninstall podman if you're on MacOS.

If you installed podman with homebrew, use this command to uninstall:

```text
brew uninstall podman
```

## Configuration Errors

### Blank output when reading home directory

This error might appear if the Atlas CLI can't access your home directory.

### HOMEDRIVE, HOMEPATH, or USERPROFILE are blank

This error might appear if the Atlas CLI can't access your home directory.
