Skip to main content

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