Skip to content

Drift Detection

Drift Detection runs a Plan operation against all Dirspaces in a repository. If changes are found then a GitHub Issue in the repository is automatically created. Reconciliation can optionally be enabled.

Terrateam Configuration Terrateam behavior can be configured via a config.yml. This file is located in a directory named .terrateam at the root of your Terraform repository: .terrateam/config.yml.

See Configuration documentation for details.


Top-level key: drift

See Configuration Reference documentation for details.

enabledBooleanSpecified whether drift detection is enabled. If set to false, drift detection and reconciliation will not run. Default is false.
scheduleStringThe interval to run drift detection and reconciliation: hourly, daily, weekly, monthly
reconcileBooleanSpecified whether reconciliation is enabled. Default is false.

Default configuration:

enabled: false
reconcile: false

Example configuration:

enabled: true
reconcile: false
schedule: daily

Drift Detection operations are equivalent to Plan operations. Existing Workflows and Hooks run for all Drift Detection operations. The following environment variable is defined for Plan and Apply operations initiated by Drift Detection:



The schedule key can be set to one of the following values:

  • hourly
  • daily
  • weekly
  • monthly

There is no default and this key is required.


The reconcile key will enable or disable reconciliation. Drift Detection automatically runs a Plan operation against all of a repositories Dirspaces. If changes are found and reconciliation is enabled then an Apply operation will automatically run against the Terraform Plan file that is generated.


GitHub Issues

If changes are found during Drift Detection initiated operations then a GitHub Issue can be created with the following configuration:

- type: drift_create_issue

Duplicate issues for identical changes will not be created.

GitHub Issue Drift Detected


It’s easy to create a Slack notification using the official GitHub integration for Slack.

  1. Install the app against your desired Slack workspace and channel
  2. Use the /github command to subscribe to your Terraform repository:
    /github subscribe owner/repo issues

Custom Notifications

To create a custom notification or action when Drift Detection initiated operations find changes, one could implement a custom hook using the Terrateam configuration file.


- type: run # run on every drift run with changes
cmd: ['bash', '-c', '$TERRATEAM_ROOT/']

Example notification script

#!/usr/bin/env bash
set -e
if [[ "$TERRATEAM_RUN_KIND" == "drift" ]] && [[ -f "$TERRATEAM_RESULTS_FILE" ]]; then
We use cookies and similar technologies to provide certain features, enhance the user experience and deliver content that is relevant to your interests. Depending on their purpose, analysis and marketing cookies may be used in addition to technically necessary cookies. By clicking on "Agree and continue", you declare your consent to the use of the aforementioned cookies. Here you can make detailed settings or revoke your consent (in part if necessary) with effect for the future. For further information, please refer to our Privacy Policy .