Upgrade from pre-1.0 versions of the Astra CLI

Astra CLI 1.0 and later do not support in-place upgrades from versions earlier than 1.0.

If you have an earlier version installed, you must delete the astra executable before you can install the latest version:

macOS and Linux

Delete the astra executable:

rm ~/.astra/cli/astra

If you installed the Astra CLI to a custom location, you can use the following command to delete the astra executable if it exists in your PATH:

rm $(which astra)

The rm command does not delete your Astra CLI home folder and configuration file (.astra and .astrarc). Leave these files in place so that the new version of the Astra CLI can continue to connect using your existing configuration.

Homebrew

brew uninstall datastax/astra-cli/astra-cli

Uninstalling with Homebrew does not delete your Astra CLI home folder and configuration file (.astra and .astrarc). Leave these files in place so that the new version of the Astra CLI can continue to connect using your existing configuration.

After you delete the old astra executable, follow the instructions in Install the Astra CLI to install the latest version.

Breaking changes in version 1.0

Astra CLI version 1.0 is largely backwards-compatible with pre-1.0 versions. However, there are some changes that might break certain scripted usage, such as:

New standardized JSON and CSV output formats and exit codes.
Minor command and flag name changes. For a full list of name changes, see the release notes.

Upgrade from pre-1.0 versions of the Astra CLI

Was this helpful?

Give Feedback