Environment Variables Reference

Currently, all environment variables are experimental.

User Configurable

User configurable environment variables permit users to control various behaviors of the State Tool.

Environment VariableDescription
ACTIVESTATE_CLI_CONFIGDIR• Override the configuration directory location
ACTIVESTATE_CLI_CACHEDIR• Override the cache directory location
ACTIVESTATE_PROJECT• Predefine the activestate.yaml (absolute path) used for activated states
ACTIVESTATE_PRIVATE_KEY• Predefine the private key (not file path) used to decrypt secrets
• You can obtain the value by running state export private-key once authenticated
ACTIVESTATE_API_KEY• Predefine the API key token to use for authentication
• Use with ACTIVESTATE_PRIVATE_KEY to bypass authentication by plain text password
ACTIVESTATE_CLI_DISABLE_UPDATES• Set to true to disable State Tool automatically updating itself
ACTIVESTATE_CLI_DISABLE_ANALYTICS• Set to true to disable State Tool from sending analytics data

Variables set after use

The following variables are set in the runtime after state checkout.

Environment VariableDescription
ACTIVESTATE_PROJECTThe absolute path to the activestate.yaml of the activated project
ACTIVESTATE_ACTIVATEDThe absolute path of the directory containing the activestate.yaml of the activated project
ACTIVESTATE_ACTIVATED_IDThe unique “activation id” which can be used for debugging