You've got 3,000 lines of Terraform spread across 40 files, organized into modules, with variables referencing other variables referencing data sources. It works. It deploys. But can you actually see what it builds?
This is one of the most common challenges in infrastructure-as-code. The code is the source of truth, but it's not visual. You can't glance at a .tf file and immediately understand the architecture the way you can with a diagram.
Here are five practical approaches to visualize your Terraform infrastructure, ranked from simplest to most sophisticated.
1. terraform graph + Graphviz
Terraform has a built-in graph command that outputs a dependency graph in DOT format. You can pipe it through Graphviz to generate a visual diagram.
terraform graph | dot -Tpng > graph.png
This is the quickest approach — one command, no external tools needed (besides Graphviz). It shows every resource and its dependencies, which is useful for understanding execution order.
The problem is readability. For any real-world infrastructure, the output is a massive, tangled web of nodes and arrows. A typical production setup with 50+ resources generates a graph that's essentially unreadable. It includes internal Terraform resources (providers, data sources, variables) that add noise without adding understanding.
Terraform graph is useful for debugging dependency issues — "why is this resource waiting for that one?" — but it's not suitable for architecture documentation.
2. Terraform Visual (VS Code extension)
If you use VS Code, the Terraform Visual extension renders a visual graph of your Terraform resources directly in your editor. It reads your .tf files and generates an interactive diagram that you can zoom, pan, and click on.
The advantage over terraform graph is that it filters out noise and only shows the resources you care about. It also updates in real-time as you edit your code, which is useful during development.
The limitation is that it's tied to VS Code. You can't easily share the output with someone who uses a different editor, and the diagrams aren't suitable for documentation or presentations.
3. Python Diagrams library
The diagrams library for Python lets you define architecture diagrams programmatically. While it doesn't read Terraform files directly, you can write a Python script that mirrors your Terraform architecture.
from diagrams import Diagram, Cluster
from diagrams.aws.compute import EKS
from diagrams.aws.database import RDS, ElastiCache
from diagrams.aws.network import ELB, Route53
with Diagram("Production Architecture", show=False):
dns = Route53("Route 53")
lb = ELB("ALB")
with Cluster("EKS Cluster"):
services = [EKS("api"),
EKS("worker"),
EKS("scheduler")]
db = RDS("PostgreSQL")
cache = ElastiCache("Redis")
dns >> lb >> services
services >> db
services >> cache
This produces clean, professional diagrams with official AWS icons. The Python code can be committed alongside your Terraform code and updated in the same PR. It's a good approach for teams that want version-controlled diagrams.
The downside is duplication — you're maintaining two representations of the same infrastructure (Terraform and Python). When someone adds a new resource in Terraform but forgets to update the diagram code, they drift apart.
4. Paste your code into InfraSketch
This is the approach I built InfraSketch for. Instead of writing separate diagram code, you paste your existing Terraform HCL and the tool generates the architecture diagram automatically.
# Just paste this into InfraSketch:
resource "aws_vpc" "main" {
cidr_block = "10.0.0.0/16"
}
resource "aws_eks_cluster" "app" {
name = "production"
vpc_config {
subnet_ids = [aws_subnet.private.id]
}
}
resource "aws_rds_cluster" "db" {
cluster_identifier = "app-db"
engine = "aurora-postgresql"
}
# InfraSketch parses this and generates a
# grouped diagram with AWS icons automatically
The tool parses resource types, detects references between resources, groups them by category (networking, compute, database, etc.), and renders a diagram with official AWS architecture icons. Everything runs in the browser — your code never leaves your machine.
This works well for quick visualization — "let me see what this Terraform actually creates" — and for generating diagrams to include in documentation or README files. The limitation is that it does static analysis only (it doesn't run terraform plan), so it may miss resources created by complex expressions or external modules.
5. Rover (Terraform Visualizer)
Rover is an open-source tool that reads Terraform state files or plan output and generates interactive diagrams. Unlike InfraSketch which does static analysis of HCL code, Rover works with the actual state — meaning it shows exactly what's deployed, including resources created by modules and count/for_each expressions.
# Generate a plan
terraform plan -out=plan.out
# Visualize it
rover -planPath plan.out
Rover produces an interactive web-based diagram that you can zoom, filter, and search. It's more accurate than static analysis because it uses the resolved state, but it requires you to have Terraform initialized and access to the state file.
Which approach should you use?
It depends on what you're trying to accomplish.
If you need a quick visualization while developing, use InfraSketch or the VS Code extension. Paste your code, see the diagram, iterate.
If you need accurate diagrams of what's actually deployed, use Rover with your state file. It's the most accurate because it works with resolved state rather than source code.
If you need presentation-ready diagrams that are version-controlled, use the Python Diagrams library. It takes more effort but produces the most polished output.
If you need to debug dependency chains, terraform graph is still the right tool despite its messy output.
The best approach for most teams is to combine methods: use InfraSketch or Rover for day-to-day visualization, and the Python Diagrams library for documentation that needs to look polished.
Visualize your Terraform instantly Paste your Terraform HCL and see the architecture diagram in seconds. Now with an interactive drag-and-drop editor, GCP support, and more. Open InfraSketch