Update the CLI

Keep ana up to date, check available versions, and submit feedback.

ana self <COMMAND>

Commands

Update options

The update command accepts these options. You can also name a specific version, as shown in the examples below.

ana self update [OPTIONS]

Use --check and --list separately. Do not combine either with a version or --force.

Examples

Update to the latest version

To install the latest version, run:

ana self update

If an update is available, ana installs it without asking for confirmation. It then updates eligible managed tools.

Update to a specific version

To see which versions are available, run:

ana self update --list

Then, install the version you want:

ana self update <VERSION>

If that version is already installed, ana leaves it unchanged. To reinstall it, use:

ana self update --force <VERSION>

Check for an update

To check for an update and choose whether to install it, run:

ana self update --check

The confirmation defaults to Yes. Pressing Enter or running with empty input can install the update. Enter n to decline, or use --list if you only want to inspect available versions.

Package-managed builds

If you installed ana with conda, activate its environment and update it through conda instead:

conda update ana-cli

Update settings

Ana checks for updates automatically and displays a notification when one is available. Notifications do not install updates. To turn them off, set ANA_UPDATE_CHECK=false.

The following optional settings control updates:

Update sources and prereleases

Use the defaults for regular releases. With ANA_PRERELEASES=true, the default update source uses its dev channel; the GitHub source includes prereleases alongside regular releases. Available versions can differ between sources, so use ana self update --list before requesting one.

Submit feedback

To report a bug or request a feature, run:

ana self feedback

This opens the Anaconda CLI issue chooser. If ANA_OPEN_BROWSER=false, ana prints the link instead.

Display the user-agent string

If you need to inspect how ana identifies its HTTP requests, run:

ana self user-agent

You can add --prefix followed by a conda environment path to include usage information for that environment. Review the output before sharing it in a public issue.