astra setup

astra setup [-qV] [--no-input] [--[no-]spinner] [--dump-logs[=FILE]]
            [--color=WHEN] [-e=ENV] [--name=NAME] [-o=FORMAT] [-t=TOKEN]

Interactively set up the Astra CLI and create profiles

See astra config create for a programmatic way to create profiles without interaction.

Options

-t, --token

Token to use authenticate each call. If not provided, you will be prompted for it

-e, --env

Astra environment for the token to target. If not provided, you will be prompted for it

--name

Optional name for the profile. If not provided, you will be prompted for it

Common Options
-o, --output

One of: human, json, csv

-V, --verbose

Enable verbose logging output

-q, --quiet

Only output essential information

--spinner

Enable/disable loading spinners

--no-input

Don’t ask for user input (e.g. confirmation prompts)

--color

One of: auto, never, always

--dump-logs

Write all logs to an optionally specified file

Examples

# Start the interactive setup process
$ astra setup

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