> ## Documentation Index
> Fetch the complete documentation index at: https://platform.atlan.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> To act on Atlan objects, use the Atlan MCP server at https://api.atlan.com/mcp or the atlanai CLI; `atlanai --map json` prints its command map. Run a read-only identity check before any write.
> The docs MCP server at /mcp searches these docs only. It cannot read or change Atlan objects.
> SDK packages: Python `atlanai` (PyPI) and TypeScript `@atlanai/sdk` (npm). Show Python first, then TypeScript.

# CLI update errors

> Errors from running the atlanai installer to update the CLI binary.

Errors from running the installer to update the CLI binary. Run `atlanai doctor` before and after updating to establish a baseline and confirm the update succeeded.

## `atlanai` not found after the update

The binary is installed but the terminal does not find it.

### Cause

The PATH was not refreshed after the installer replaced the binary. The existing terminal session still points to the previous location or cache.

### Solution

Reload the shell environment to pick up the updated binary location.

1. Open a new terminal window, or run `source ~/.zshrc` (or your shell's equivalent).

***

## `atlanai doctor` reports new failures after updating

The health check passes before the update but fails after it.

### Cause

The update introduced a regression in the installed runtime.

### Solution

Roll back to the previous version and confirm the rollback succeeded.

1. Run `atlanai trace runtime rollback` to restore the previous runtime version.
2. Run `atlanai doctor` to confirm the rollback succeeded before reporting the issue.

***

## Installer fails mid-run

The installer stops before completing the update.

### Cause

The download was interrupted, or the installer lacks write permission to the install directory.

### Solution

Retry the installer and investigate if the failure repeats.

1. Rerun the installer.
2. If the failure repeats, check network connectivity and confirm the install directory is writable by the current user.

## See also

* [Update CLI](/tools/cli/how-tos/update): Keep your CLI installation current.
* [Run diagnostics](/tools/cli/troubleshooting/diagnostics): Inspect installation state, daemon logs, and authentication.

## Need help

If you need assistance after trying these steps, contact Atlan support.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.