# Install astra with Homebrew, winget Command-Line Interface for DataStax Astra. Version 1.0.4 via Homebrew; verified 2026-06-22. ## Install ```sh sudo av install brew:astra ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install astra ``` Evidence: local Homebrew formula metadata ### Windows - winget (92%): ```sh winget install --id Boof2015.Astra -e ``` Evidence: Windows Package Manager source index: Boof2015.Astra from https://cdn.winget.microsoft.com/cache/source.msix ## Package facts - **Package key:** brew:astra - **Package manager:** Homebrew - **Package manager page:** - **Version:** 1.0.4 - **Source summary:** Command-Line Interface for DataStax Astra - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** Apache-2.0 - **Source archive:** - **Last updated:** 2026-06-22T14:02:46-07:00 - **Generated:** 2026-07-08T07:18:31+00:00 ## Executables - astra (cli) - astra (alias) ## Build dependencies - graalvm - gradle ## Install behavior - Post-install hook: not defined - Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, x86_64_linux ## Freshness - Page generated: 2026-07-08 - Package-manager version: 1.0.4 - Package-manager updated: 2026-06-22 - Local data: ok - Upstream repository: https://github.com/datastax/astra-cli - Upstream latest detected: v1.0.4 (current) ## Project history and usage astra is the command-line interface for DataStax Astra. It gives developers terminal access to Astra database and platform operations, including authenticated commands, setup, configuration profiles, output formatting, upgrades, and environment-aware automation. ### Project history The datastax/astra-cli repository was created in 2022. The current README describes the 1.0.0 beta generation of the CLI and points readers to the v0.x branch for the previous version, marking a significant rewrite or compatibility break in the tool's history. The 1.x README emphasizes cross-platform Linux, macOS, and Windows support, official install scripts, Homebrew installation, direct releases, an astra upgrade command, and a more interactive terminal experience with colors, spinners, prompts, completions, stricter validation, and XDG-aware paths. ### Adoption history Astra CLI adoption is tied to DataStax Astra itself rather than to a general-purpose database client market. The official README documents install scripts and Homebrew as supported paths, while the supplied package facts also list a winget package. Its package-manager role is to make cloud database operations scriptable on developer machines and CI systems. ### How it is used Users typically run astra setup to create or update credentials in a central .astrarc file, then use astra config subcommands and resource commands such as astra db list. The CLI can also avoid the credentials file by accepting --token and --env, and it supports JSON or CSV output for scripting. ### Why package nerds care For package nerds, astra is a vendor cloud CLI with explicit state paths and credential behavior. The v1 move to XDG_CONFIG_HOME/astra/.astrarc or ~/.astrarc matters because package upgrades can change where tokens live, how scripts authenticate, and whether users should upgrade through the CLI itself or through their package manager. ### Timeline - 2022: datastax/astra-cli repository created on GitHub. - 2020s: v0.x CLI existed before the current README's 1.0.0 beta generation. - 2020s: v1.x README documents Linux, macOS, and Windows support plus XDG-aware configuration. - 2026: GitHub tags and repository metadata showed active v1-era releases. ### Related projects - DataStax Astra is the managed database platform operated by the CLI. - Apache Cassandra and related Astra DB tooling are adjacent to the CLI's database-management use cases. - Homebrew and winget provide package-manager installation routes alongside DataStax's official install scripts. ### Sources - - - - source_facts.package-manager ## Security Notes narrow executable package without higher-risk signals. - **Geiger risk:** green / low - narrow executable package without higher-risk signals ## Configuration and credential file locations These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval. ## Configuration files - Unix: $XDG_CONFIG_HOME/astra/.astrarc, ~/.astrarc ## Credential files - Unix: $XDG_CONFIG_HOME/astra/.astrarc, ~/.astrarc ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** astra - **Version Scheme:** 0 - **Revision:** 0 - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** stable ## Other Package-Manager Records - winget - Boof2015.Astra: normalized package name match | Windows Package Manager source index: Boof2015.Astra from https://cdn.winget.microsoft.com/cache/source.msix ## Related links - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata. - [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata. - [Database and data packages](https://www.automicvault.com/pkg/database-data-tools/) - Matched database, SQL, migration, or data-store metadata. - [graalvm](https://www.automicvault.com/pkg/brew/graalvm/) - Build dependency declared by Homebrew. - [gradle](https://www.automicvault.com/pkg/brew/gradle/) - Build dependency declared by Homebrew. - [apache-geode](https://www.automicvault.com/pkg/brew/apache-geode/) - Shares av.db curated category or tags: cli, data, database. - [arcadedb](https://www.automicvault.com/pkg/brew/arcadedb/) - Shares av.db curated category or tags: cli, data, database. - [automysqlbackup](https://www.automicvault.com/pkg/brew/automysqlbackup/) - Shares av.db curated category or tags: cli, data, database. - [basex](https://www.automicvault.com/pkg/brew/basex/) - Shares av.db curated category or tags: cli, data, database. - [bee](https://www.automicvault.com/pkg/brew/bee/) - Shares av.db curated category or tags: cli, data, database. - [berkeley-db](https://www.automicvault.com/pkg/brew/berkeley-db/) - Shares av.db curated category or tags: cli, data, database. - [cassandra](https://www.automicvault.com/pkg/brew/cassandra/) - Shares av.db curated category or tags: cli, data, database. - [cdb](https://www.automicvault.com/pkg/brew/cdb/) - Shares av.db curated category or tags: cli, data, database. - [cql-proxy](https://www.automicvault.com/pkg/brew/cql-proxy/) - Local metadata places this package in an adjacent workflow. Shared terms: astra, cli, data, database, datastax. - [cubejs-cli](https://www.automicvault.com/pkg/brew/cubejs-cli/) - Local package facts share a topical domain. Shared terms: cli, command-line, data, interface, line. - [cypher-shell](https://www.automicvault.com/pkg/brew/cypher-shell/) - Local metadata places this package in an adjacent workflow. Shared terms: cli, command-line, data, database, line. ## Combined YAML source View the package source record on GitHub. [combined/astra.yml](https://github.com/automic-vault/db/blob/main/combined/astra.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated configuration and credential file locations - curated package history - package version freshness - av.db category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph