Skip to content

Terrateam is open-source GitOps infrastructure orchestration. It integrates with GitHub to automate Terraform, OpenTofu, CDKTF, Terragrunt, and Pulumi workflows through pull requests.

License

Notifications You must be signed in to change notification settings

terrateamio/terrateam

Terrateam

GitHub Stars Join our Slack Latest Release OCaml License: MPL-2.0


Open-Source Terraform automation in pull requests

Terrateam automates Terraform plans and applies in pull requests. Built from day one to handle thousands of workspaces across monorepos or many repos, with complex dependencies at any scale.

  • GitOps for Scale: Manage 10 or 10,000 workspaces with tag-based configuration
  • Flexible Automation: Works with Terraform, OpenTofu, Terragrunt, CDKTF, Pulumi, any CLI
  • Smart Locking: Apply-only locks mean unlimited parallel plans
  • Policy Engine: Enforce rules with OPA/Rego, require approvals by team/role
  • Cost & Drift Detection: Catch infrastructure drift and show cost estimates automatically
  • Self-Hostable: Stateless by design. Your runners, your state, your secrets

Terrateam UI - Run Dashboard

Why Terrateam?

While others built for simple workflows, we engineered for reality:

  • Tag-based configuration - Define rules once, apply everywhere
  • Monorepo-first - Handle thousands of workspaces without breaking a sweat
  • Composable policies - tag:production AND team:payments - express complex rules simply
  • Full visibility UI - Track every run, view execution logs, debug failures - all in the OSS version

Learn more about our architecture →


Try Terrateam

Hosted SaaS

Start free →

Self-Hosted

Quick Start

# Clone the repository
git clone https://github.com/terrateamio/terrateam
cd terrateam/docker/terrat

# Run the setup
docker-compose up setup

# The Terrateam setup wizard will be available at http://localhost:3000

Features

  • GitOps pull request automation
  • Pre and post-merge applies
  • RBAC + OIDC integration
  • Policy enforcement (OPA, Rego, Checkov, built-in)
  • Cost estimation
  • Safe parallel execution with locking
  • Cross-environment and dependency coordination
  • Config builder for advanced workflows
  • Full UI to track runs, view logs, and debug workflows (included in OSS)
  • Self-hostable (server and private runners)

Configuration

Configure workflows via .terrateam/config.yml. See Configuration Reference.


Learn More


Resources


Contributing

We welcome contributions! See CONTRIBUTING.md or join our Slack.


License

Terrateam is MPL-2.0 licensed. Some enterprise features are under a separate enterprise license.