Environment variables
Infracost uses a number of environment variables to customize various aspects of its behavior; these can be particularly useful in CI/CD integrations. Configuration values are chosen in this order:
- CLI flags (run
infracost --help
to see them) - Environment variables
- Configuration file
#
INFRACOST_API_KEYInfracost API key, run infracost register
to get one.
#
INFRACOST_LOG_LEVELCan be set to info
or warn
in CI/CD systems to reduce noise, or debug
to troubleshoot.
#
INFRACOST_SKIP_UPDATE_CHECKSet to true
to skip the Infracost update check; can be useful in CI/CD systems. We recommend watching the Infracost repo for releases by going to the repo page, clicking on the Watch button, selecting Custom, then Releases and clicking on Apply. Be sure to upgrade regularly as we continually add new resources to Infracost.
#
INFRACOST_TERRAFORM_BINARYUsed to change the path to the terraform
binary, e.g.:
#
CI/CD integrationsIf you're using a CI/CD integration, our Docker image (Dockerfile) has the latest stable versions of terraform and terragrunt; so you can set this environment variable to:
terraform
(default, latest stable version of terraform)terraform_0.14
(latest patch version of 0.14)terraform_0.13
(latest patch version of 0.13)terraform_0.12
(latest patch version of 0.12)terragrunt
(latest patch version of 0.27, if you need other versions of Terragrunt in the Docker image, please create an issue)
Infracost works with Terraform v0.12 and above.
#
INFRACOST_TERRAFORM_WORKSPACEUsed to set the Terraform workspace (this sets the TF_WORKSPACE
internally):
Only set this for multi-workspace deployments, otherwise it might result in the Terraform error "workspaces not supported". If you see this error, try running unset INFRACOST_TERRAFORM_WORKSPACE
and unset TF_WORKSPACE
.
#
INFRACOST_TERRAFORM_CLOUD_TOKENFor Terraform Cloud/Enterprise users, set this to a Team API Token or User API Token so Infracost can use it to access the plan.
#
INFRACOST_TERRAFORM_CLOUD_HOSTFor Terraform Enterprise users, used to override the default app.terraform.io
backend host.
#
INFRACOST_SELF_HOSTED_TELEMETRYSet to false
to opt-out of telemetry when using a self-hosted Cloud Pricing API.
#
Terraform environment variablesStandard Terraform environment variables such as TF_CLI_CONFIG_FILE
can also be added if required, for example: