Kubernetes Installation

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.

​

Start Here

1. Get an Enterprise license. Request a license enabled for Helm installations and obtain its registry credentials from the install portal or our team. Existing trial users must also confirm Helm access with our team.
2. Review the installation prerequisites, then prepare your cluster using the Amazon EKS, Azure AKS, or Google GKE guide. These pages cover the provider-specific infrastructure and Helm values.
3. Return to Install with Helm to log in to the registry, configure and install OpenHands, and validate your first conversation. Apply the provider-specific values from your cluster guide.

​

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

​

Supporting Services

​

Guides

​

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.