Quickstart Guide

Choose Your Deployment Path

Get started with Terrateam in the way that works best for your team:

☁️ Terrateam Cloud Fastest setup • 2 minutes • Fully managed service • Free tier available

🏢 Self-Hosted Full control • 10-30 minutes • Your infrastructure • Complete data sovereignty

☁️ Terrateam Cloud

The fastest way to start using Terrateam. Perfect for teams who want to focus on Terraform, not infrastructure.

How It Works

Sign up at terrateam.io/signup
Choose your path in the setup wizard:
- Demo Repository (2-3 minutes) - Learn with simulated infrastructure
- Your Repository (5-10 minutes) - Connect your existing Terraform code

Create your first pull request - Terrateam automatically runs terraform plan on every PR

🏢 Self-Hosted Deployment

Deploy Terrateam in your own environment for complete control and data sovereignty.

Choose Your Deployment Method

🐳 Docker Compose Quick setup with automated wizard • Perfect for development and small teams • 10-15 minutes

☸️ Kubernetes / Helm Production-ready with high availability • Ideal for enterprise deployments • 20-30 minutes

Quick Start with Docker

Get running quickly with our automated setup wizard:

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

# Start the setup wizard
docker-compose up setup

# Open http://localhost:3000 and follow the wizard

The setup wizard guides you through the entire process:

Terrateam Self-Hosted Setup Wizard - Choose VCS Provider

The wizard automatically:

Creates your GitHub App or configures GitLab integration
Generates all credentials and keys
Configures webhooks and permissions
Validates your entire setup

What’s Next?

After the wizard completes:

Make a change - Edit any .tf file
Open a pull request - Terrateam automatically runs terraform plan
Review and apply - Comment terrateam apply to deploy