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

  • Homebrew

rm ~/.astra/cli/astra
Delete custom installation

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)

This 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.

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:

Was this helpful?

Give Feedback

How can we improve the documentation?

© Copyright IBM Corporation 2025 | Privacy policy | Terms of use Manage Privacy Choices

Apache, Apache Cassandra, Cassandra, Apache Tomcat, Tomcat, Apache Lucene, Apache Solr, Apache Hadoop, Hadoop, Apache Pulsar, Pulsar, Apache Spark, Spark, Apache TinkerPop, TinkerPop, Apache Kafka and Kafka are either registered trademarks or trademarks of the Apache Software Foundation or its subsidiaries in Canada, the United States and/or other countries. Kubernetes is the registered trademark of the Linux Foundation.

General Inquiries: Contact IBM