Skip to main content
Use these environment variables to configure CDK Terrain (CDKTN) behavior.
Variable NameDescriptionDefault
CDKTF_DISABLE_PLUGIN_CACHE_ENVIf set to true or 1, CDKTN disables the plugin cache. Otherwise, CDKTN creates the plugin cache directory in ~/.terraform.d/plugin-cache if it is not already present.
GITHUB_API_TOKEN_CDKTFIf set, the provider add and provider update command will use this token for authenticated requests to Github when looking for pre-built provider packages for Go.
CDKTF_HOMEWhere CDKTN should store cache and configuration files.~/.cdktf
CDKTF_LOG_FILE_DIRECTORYThe directory path where CDKTN should create cdktf.log and print logs at the debug level. If not set, CDKTN writes logs to standard out at the level specified in CDKTF_LOG_LEVEL.standard out
CDKTF_LOG_LEVELControls how much log information CDKTN prints to the console. You can set it to one of the following values: all, debug, info, warn, error, fatal, off.warn
CHECKPOINT_DISABLEIf set to any value, CDKTN will not send telemetry data.
DISABLE_VERSION_CHECKIf set to true or 1, CDKTN will not perform a version check. If it is not set, CDKTN verifies that your installed library version matches the CLI version. If they do not match, CDKTN displays a warning.
FORCE_COLORIf set to 0, CDKTN disables colored CLI output. Refer to chalk documentation for other supported values.
HTTP_PROXY or http_proxyThe proxy that CDKTN should use for all HTTP requests.
TERRAFORM_BINARY_NAMEThe name of the Terraform-compatible binary that CDKTN should use. Set to tofu to use OpenTofu instead of Terraform.terraform
TF_TOKEN_app_terraform_ioThe token CDKTN should use to authenticate with Terraform Cloud. Must be set to a valid HCP Terraform API token. In case of TFE app_terraform_io would be your hostname.
CIIf set to true or 1, CDKTN will run in a non-interactive CI mode.