croud uses a configuration to store user specific data, such as profiles or authentication tokens, to disk so they can be persisted. The configuration file is located inside the user’s config directory, e.g. on a Linux system it would be the following path:


To determine the location of the config files croud uses the appdirs package. Please refer to package documentation for further details.

Configuration file formatting

The contents of the configuration file of a fresh croud installation are YAML formatted and look like this:

default-format: table
    auth-token: NULL
    auth-token: NULL
    auth-token: NULL

Configuration file keys

The keys have the following meaning:


The name of the profile that is used for making API requests. This value needs to correspond to one of the items of profiles.


The default output format for API requests. This can be either table (default, displays the most important fields), wide (a table format displaying all fields), json, or yaml. This value is only used if the current profile does not specify a format.


A dictionary of available profiles. There are three default profiles available (see Available profiles). Each profile consists of auth-token, endpoint, region, and format.

auth-token is populated with the API token upon login.

endpoint is the full URL of the API endpoint that is used for requests.

region is the specific region within which CrateDB Cloud resources are accessed.

format is the output format for this profile. This key is optional and if it is missing, the output format will fall back on default-format.

Manage configuration via CLI

croud offers the possibility to manage its configuration and profiles using the croud config {show | profiles} commands.

Please refer to the config command reference for further details.

Available profiles

The API endpoint for all profiles is

Profile Region Format table table table

Incompatible versions

The configuration file format changed in version 0.23.0 when profiles were introduced.

If you have an older version of croud installed already, you will get the following message upon execution of a command with the new version of croud:

$ croud me
==> Error: Your configuration file is incompatible with the current version of croud.
==> Info: Please delete the file '/home/<user>/.config/Crate/croud.yaml' or update it manually.

You can either delete the old configuration file, or manually edit the content by pasting the default configuration stated above.


How helpful was this page?