From aedc9dc95363457a8c2f024f9fc75e5022036ffd Mon Sep 17 00:00:00 2001
From: Ilyaas Kapadia <86218345+IlyaasK@users.noreply.github.com>
Date: Wed, 5 Aug 2026 17:20:02 -0400
Subject: [PATCH] docs: link Terraform provider

---
 docs.json                  |  1 +
 integrations/overview.mdx  |  1 +
 integrations/terraform.mdx | 39 ++++++++++++++++++++++++++++++++++++++
 3 files changed, 41 insertions(+)
 create mode 100644 integrations/terraform.mdx

diff --git a/docs.json b/docs.json
index 34f4648..979b0a2 100644
--- a/docs.json
+++ b/docs.json
@@ -232,6 +232,7 @@
               "integrations/notte",
               "integrations/vibium",
               "integrations/stagehand",
+              "integrations/terraform",
               "integrations/valtown",
               {
                 "group": "Vercel",
diff --git a/integrations/overview.mdx b/integrations/overview.mdx
index 273f190..9bb54af 100644
--- a/integrations/overview.mdx
+++ b/integrations/overview.mdx
@@ -34,6 +34,7 @@ Kernel provides detailed guides for popular agent frameworks:
 - **[Claude Agent SDK](/integrations/claude/claude-agent-sdk)** - Run Claude Agent SDK automations in cloud browsers
 - **[Claude Managed Agents](/integrations/claude/claude-managed-agents)** - Run Anthropic's hosted agent harness against cloud browsers
 - **[Stagehand](/integrations/stagehand)** - AI browser automation with natural language
+- **[Terraform](/integrations/terraform)** - Manage durable Kernel infrastructure as code
 - **[Computer Use (Anthropic)](/integrations/computer-use/anthropic)** - Claude's computer use capability
 - **[Computer Use (OpenAI)](/integrations/computer-use/openai)** - OpenAI's computer use capability
 - **[Computer Use (Gemini)](/integrations/computer-use/gemini)** - Gemini's computer use capability
diff --git a/integrations/terraform.mdx b/integrations/terraform.mdx
new file mode 100644
index 0000000..ae834d8
--- /dev/null
+++ b/integrations/terraform.mdx
@@ -0,0 +1,39 @@
+---
+title: "Terraform"
+description: "Manage durable Kernel infrastructure with Terraform"
+---
+
+Use the official Kernel Terraform provider to manage durable infrastructure such as projects and browser pools.
+
+## Install the provider
+
+Add `kernel/kernel` to your Terraform configuration:
+
+```hcl
+terraform {
+  required_providers {
+    kernel = {
+      source = "kernel/kernel"
+    }
+  }
+}
+
+provider "kernel" {}
+```
+
+Set `KERNEL_API_KEY` and, when needed, `KERNEL_PROJECT_ID` in the environment where Terraform runs. You can then manage Kernel projects and browser pools, read existing projects, profiles, proxies, and extensions, and import existing projects or browser pools by ID.
+
+<Note>
+The provider manages durable desired configuration. Use the Kernel SDKs or API for runtime browser operations such as creating sessions, acquiring browsers, releasing browsers, and viewing logs.
+</Note>
+
+## Provider documentation
+
+<CardGroup cols={2}>
+  <Card title="Terraform Registry" icon="cube" href="https://registry.terraform.io/providers/kernel/kernel/latest">
+    Browse installation instructions and the generated resource and data source reference.
+  </Card>
+  <Card title="GitHub" icon="github" href="https://github.com/kernel/terraform-provider-kernel">
+    View examples, release notes, source code, and contribution guidance.
+  </Card>
+</CardGroup>