# Install astra with Homebrew, winget

Command-Line Interface for DataStax Astra. Version 1.1.0 via Homebrew; verified 2026-07-08. Also installable with winget: winget install --id Boof2015.Astra -e.

## 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
- **Version:** 1.1.0
- **Source summary:** Command-Line Interface for DataStax Astra
- **Homepage:** <https://docs.datastax.com/en/astra-cli>
- **Repository:** <https://github.com/datastax/astra-cli>
- **Last updated:** 2026-07-08T11:57:43Z
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- astra (alias)

## Install behavior

- Bottle: not available

## Freshness

- Page generated: 2026-08-03
- Package-manager version: 1.1.0
## 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

- <https://api.github.com/repos/datastax/astra-cli>
- <https://docs.datastax.com/en/astra-cli>
- <https://github.com/datastax/astra-cli#readme>
- 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
## 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


## Combined YAML source

View the package source record on GitHub. [combined/astra.yml](https://github.com/mxcl/pkgdb/blob/main/combined/astra.yml)


## Sources

- pkg.so package database
- Geiger risk classifier
- curated configuration and credential file locations
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph