If you prefer a simpler installation, see the Quick Start
guide for VM-based deployment.
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:
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
Resource Limits
Configure memory, CPU, and storage for optimal performance.
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.Contact Sales
Get in touch with our team to request access to Kubernetes installation.