> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tembo.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> What you need before installing Tembo on Kubernetes, and the cloud resources Tembo creates with Terraform.

> [!NOTE]
>
> Kubernetes support is currently in early access. To get on the list, book a demo call with the Tembo team: [Book a Demo](https://book.avoma.com/tembo/tembo-demo/)

Installing Tembo on Kubernetes takes three steps, the same on every cloud:

1. **Cloud resources:** on [AWS](https://docs.tembo.io/features/self-hosted/kubernetes/prerequisites/aws.md) or [GCP](https://docs.tembo.io/features/self-hosted/kubernetes/prerequisites/gcp.md), prepare your cluster and network, then apply Tembo's Terraform module. It creates the cloud resources Tembo needs, and outputs the Helm values that use them.
2. **[GitHub](https://docs.tembo.io/features/self-hosted/kubernetes/prerequisites/github.md):** create your install's GitHub App, and keep its credentials in a Kubernetes Secret.
3. **[Deploy](https://docs.tembo.io/features/self-hosted/kubernetes/deploy.md):** one `helm install` with the module's Helm values and your own.

## What you need

From Tembo, once you're in early access:

* A license key. It signs you in to Tembo's registry, `registry.tembo.io`, for the Helm chart and images, and gives your install the agent host image.
* The chart version to install: 0.1.20 or later, the first on `registry.tembo.io`.
* The image tags for the platform and the host controller.

Your own:

* A Kubernetes cluster with an Ingress controller, and a TLS certificate for your hostname. Your cloud's page lists what the cluster needs.
* DNS for your hostname, through [external-dns](https://github.com/kubernetes-sigs/external-dns) or records you create.
* Helm 3.8 or later, for charts from OCI registries, kubectl, and Terraform 1.5 or later.

## What the module creates

Agent hosts run outside your cluster, as cloud instances the host controller launches. On each cloud, the module creates:

* **The host controller's identity:** a role bound to the chart's service account, which can launch agent hosts and change or delete only its own.
* **The agent hosts' identity and network access:** the role or service account hosts run as, and their firewall rules or security group.
* **Object storage:** a bucket for project images, session snapshots and file uploads, and the control plane's access to it.
* **Helm values** for the chart: the identities above, a host class and pool named `default`, and the bucket.

## Choose your cloud

> [card] [AWS](https://docs.tembo.io/features/self-hosted/kubernetes/prerequisites/aws.md)
>
> EKS, with agent hosts on EC2.

> [card] [GCP](https://docs.tembo.io/features/self-hosted/kubernetes/prerequisites/gcp.md)
>
> GKE, with agent hosts on Compute Engine.

Azure is coming soon.

***

## Need Help?

If you run into any issues, contact [support@tembo.io](mailto:support@tembo.io).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.