astra config use

astra config use [-qV] [--no-input] [--[no-]spinner] [--dump-logs[=FILE]]
                 [-cf=PATH] [--color=WHEN] [-o=FORMAT] [NAME]

Sets an existing profile to be used as the default for all commands. Use the --default option when creating a new profile to set it as the default automatically.

Options

NAME

Profile to set as default

-cf, --config-file

The .astrarc file to work with. See astra config path -h for how this is resolved.

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

# Set an existing profile as the default
$ astra config use my_profile

# Set a profile as the default when creating it
$ astra config create my_profile -t @token.txt --default

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