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

# Kubernetes Installation

> Deploy OpenHands Enterprise into your own Kubernetes cluster using Helm

OpenHands Enterprise can be deployed into an existing Kubernetes cluster using Helm.
This approach gives you full control over the deployment and is ideal for teams with
Kubernetes expertise who want to integrate OpenHands into their existing infrastructure.

<Note>
  If you prefer a simpler installation, see the [Quick Start](/enterprise/quick-start)
  guide for VM-based deployment.
</Note>

## When to Use This Approach

Choose the Kubernetes installation path when you:

* Have an existing Kubernetes cluster you want to deploy into
* Need fine-grained control over resource allocation and scaling
* Want to integrate with existing infrastructure (external PostgreSQL, Redis, S3)
* Have a platform team familiar with Helm and Kubernetes operations
* Need to comply with specific infrastructure policies or constraints

## Architecture Overview

OpenHands Enterprise consists of several components deployed as Kubernetes workloads:

<img src="https://mintcdn.com/allhandsai/0uHeKtMvLEHMx2U1/enterprise/k8s-install/images/architecture.svg?fit=max&auto=format&n=0uHeKtMvLEHMx2U1&q=85&s=1ab3e2537475c68aff3f5311c66e26e3" alt="OpenHands Enterprise Architecture" width="1979" height="960" data-path="enterprise/k8s-install/images/architecture.svg" />

### Core Components

| Component                | Description                                                       |
| ------------------------ | ----------------------------------------------------------------- |
| **OpenHands Server**     | Main application server handling UI, API, and agent orchestration |
| **Runtime API**          | Manages sandbox lifecycle—provisioning, scaling, and cleanup      |
| **Runtimes (Sandboxes)** | Isolated containers where agents execute code                     |
| **Keycloak**             | Identity and access management                                    |
| **LiteLLM Proxy**        | Routes requests to your LLM provider(s)                           |
| **PostgreSQL**           | Persistent storage for application data                           |
| **Redis**                | Caching and session management                                    |

### Supporting Services

| Component               | Description                                    |
| ----------------------- | ---------------------------------------------- |
| **Conversation Bucket** | S3-compatible storage for conversation history |
| **Image Loader**        | Pre-loads runtime container images on nodes    |

## Guides

<Card title="External PostgreSQL" icon="database" href="/enterprise/external-postgres">
  Configure OpenHands to use your own PostgreSQL database instead of the bundled instance.
</Card>

<Card title="Resource Limits" icon="gauge-high" href="/enterprise/k8s-install/resource-limits">
  Configure memory, CPU, and storage for optimal performance.
</Card>

## Request Access

Kubernetes-based installation is currently available to select customers on request.
If you're interested in deploying OpenHands Enterprise into your own Kubernetes cluster,
please contact our team to discuss your requirements.

<Card title="Contact Sales" icon="envelope" href="https://openhands.dev/contact">
  Get in touch with our team to request access to Kubernetes installation.
</Card>