> [!IMPORTANT]
> **Terrateam is now part of Stategraph.**
>
> Stategraph replaces the flat state file with a real database for faster plans, parallel execution, and better visibility into infrastructure.
>
> Use Terrateam on its own or together with Stategraph.
>
> → Learn more: https://stategraph.com
---
## 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
---
### 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 →](https://terrateam.io/monorepo-at-scale)
---
## Try Terrateam
### Hosted SaaS
[Start free →](https://terrateam.io)
### Self-Hosted
#### Quick Start
```bash
# 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](https://docs.terrateam.io/configuration-reference).
---
## Learn More
* [Monorepo at Scale](https://terrateam.io/monorepo-at-scale) - How we handle thousands of workspaces
* [Technical Architecture](https://terrateam.io/technical-architecture) - The engine under the hood
* [Configuration Reference](https://docs.terrateam.io/configuration-reference) - Tag queries and advanced workflows
* [Blog](https://terrateam.io/blog) - Updates and best practices
---
## Resources
* [Documentation](https://docs.terrateam.io)
* [Quickstart Guide](https://docs.terrateam.io/getting-started/quickstart-guide)
* [Community Slack](https://terrateam.io/slack)
---
## Contributing
We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) or join our [Slack](https://terrateam.io/slack).
Instructions for setting up the OCaml development sandbox are in [README.setup.md](./README.setup.md)
---
## License
Terrateam is MPL-2.0 licensed. The open-source version includes all core features.
Enterprise Edition Features (Hosted SaaS & Self-Hosted Enterprise):
- RBAC - Role-based access control
- Centralized Configuration - Manage config across multiple repos
- Gatekeeper - Advanced approval workflows
These enterprise features are available in our Hosted SaaS or via self-hosted Enterprise Edition licensing.
