DriftHound
A Watchdog for Your Infrastructure State
Monitor infrastructure drift for Terraform, OpenTofu, and Terragrunt. Real-time drift detection with automated alerting.
What is DriftHound?
A Rails web application that receives Terraform drift reports via API and provides visibility into infrastructure drift across your projects.
Infrastructure Drift Detection Made Simple
DriftHound monitors your Terraform, OpenTofu, and Terragrunt infrastructure for drift— detecting when your actual infrastructure state diverges from your declared configuration.
- Track drift across multiple projects and environments
- Store historical drift check data
- Get instant Slack notifications on drift detection
- View detailed change summaries with add/modify/destroy counts
Key Features
Everything you need to monitor infrastructure drift
Web Dashboard
View all projects and their drift status at a glance. Track history and analyze trends over time.
Slack Notifications
Receive instant alerts when drift is detected. Configure per-project or environment-specific notifications.
GitHub Actions
Seamless CI/CD integration with our official GitHub Action. Automate drift checks on every push.
Easy Deployment
Deploy to Kubernetes with our Helm chart or use Docker images. Production-ready in minutes.
API-First
RESTful API for submitting drift reports. Authenticate with bearer tokens, integrate with any tool.
Historical Data
Store and track drift check history per project. Compare checks and identify patterns.
Quick Start
Get up and running in minutes
GitHub Actions Integration
Add DriftHound to your workflow:
- name: Run drift detection
uses: treezio/drifthound-action@v1
with:
drifthound-url: ${{ secrets.DRIFTHOUND_URL }}
drifthound-token: ${{ secrets.DRIFTHOUND_TOKEN }}Deploy with Helm
Install DriftHound to your Kubernetes cluster:
helm repo add drifthound https://treezio.github.io/helm-chart-drifthound
helm repo update
helm install drifthound drifthound/drifthound \
--set postgresql.enabled=true \
--set ingress.enabled=trueRun with Docker
Start DriftHound using Docker Compose:
docker pull ghcr.io/treezio/drifthound:latest
# Run with Docker Compose
docker-compose up -dCLI Usage
Install and use the DriftHound CLI:
curl -L https://raw.githubusercontent.com/treezio/DriftHound/main/bin/drifthound-cli \
-o /usr/local/bin/drifthound && chmod +x /usr/local/bin/drifthound
drifthound --tool=terraform \
--project=my-project \
--environment=production \
--token=${{ DRIFTHOUND_API_TOKEN }} \
--api-url=${{ DRIFTHOUND_HOST }} \
--dir=./terraformReady to Monitor Your Infrastructure?
Start tracking infrastructure drift today with DriftHound