Get Started
Welcome. This is the on-ramp. By the end of it you'll have the Terrantula CLI on your PATH, a working fleet view of your existing Terraform, and a clear sense of whether Terrantula solves a problem you actually have.
Is this for you?
You're running the same Terraform a hundred times for a hundred tenants — per-customer stacks, per-region cells, per-PR ephemeral environments. The individual resources don't matter; the population does. Workspace explosion, capacity tribal knowledge, naming collisions, deprovisioning hygiene, slow onboarding — if those pains are familiar, you're in the right place.
The one-line pitch: Terraform names your pets. Terrantula herds your cattle.
Terrantula sits on top of whatever runs your Terraform today — Terraform Cloud, Atmos, Atlantis, or a plain GitHub Actions workflow with state in S3. It adds the missing fleet layer: typed entities with lifecycle, cell placement with capacity limits, relationships with cardinality enforcement, and Actions that modify your IaC by opening pull requests. Terrantula never runs terraform apply — your existing CI does that, exactly as it does today.
If you're not there yet — you just have Terraform sprawl and no fleet-wide view — that's the visibility on-ramp, and it's still for you. Import your state, get a graph, decide later.
What to read, in order
- Install — get the CLI (and, optionally, the self-hosted backend).
- What is Terrantula — the plain-language definition.
- Features — the capability breadth at a glance.
- Use-cases — find yourself in one of the patterns.
- FAQ — the questions everyone asks.
Already running Terraform a particular way? Jump straight to the on-ramp that matches:
Where this leads
Get Started orients you. From here:
- Learn Terrantula builds your mental model — the cattle mindset and the core concepts (entities, cells, relationships, Actions).
- Quick Start is the hands-on path: import your Terraform state and open a dashboard in under five minutes.
- Your First Fleet is the guided build of the primitives, in order.