Skip to main content

Kubernetes installation

Faheem Code 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 Faheem Code into their existing infrastructure.

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

Faheem Code Enterprise consists of several components deployed as Kubernetes workloads:

Screenshot: Faheem Code Enterprise Architecture.

Core components

ComponentDescription
Faheem Code ServerMain application server handling UI, API, and agent orchestration
Runtime APIManages sandbox lifecycle: provisioning, scaling, and cleanup
Runtimes (Sandboxes)Isolated containers where agents execute code
KeycloakIdentity and access management
LiteLLM ProxyRoutes requests to your LLM provider(s)
PostgreSQLPersistent storage for application data
RedisCaching and session management

Supporting services

ComponentDescription
Conversation BucketS3-compatible storage for conversation history
Image LoaderPre-loads runtime container images on nodes

Guides

Sizing guide

Size your node pools, volume storage, and database from peak concurrent sandboxes.

Install with Helm

End-to-end installation instructions using your Faheem Code Enterprise license.

Installing Sysbox

Install the Sysbox runtime so agent sandboxes can run securely.

DNS and TLS

Automate DNS records and TLS certificates with external-dns and cert-manager.

Amazon EKS

Prepare an Amazon EKS cluster to run Faheem Code Enterprise.

External PostgreSQL

Configure Faheem Code to use your own PostgreSQL database instead of the bundled instance.

Resource limits

Configure memory, CPU, and storage for optimal performance.

Upgrade guidance

Generic advice for upgrading the Kubernetes cluster underneath Faheem Code.

Request access

Kubernetes-based installation is currently available to select customers on request. If you're interested in deploying Faheem Code 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.