For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
CommunitySign Up
HomeGuidesVerbsAPI ReferenceSelf-HostingClient SDKsTutorialsChangelog
HomeGuidesVerbsAPI ReferenceSelf-HostingClient SDKsTutorialsChangelog
  • Overview
    • Licensing
    • Post-Install Steps
    • Setting up WebRTC and SIP TLS
    • Krisp Turn-Taking
  • Hosting Providers
    • AWS
    • Azure
    • GCP
    • OCI
  • Bare metal / VPS
    • Debian package
  • Kubernetes
    • AWS (EKS)
    • Azure (AKS)
    • GCP (GKE)
    • Exoscale (SKS)
LogoLogo
CommunitySign Up
On this page
  • Prerequisites
  • Provision the EKS Cluster
  • Deploy jambonz
  • Cleanup
  • Resources
Kubernetes

AWS (EKS)

Deploy jambonz on Amazon Elastic Kubernetes Service
Was this page helpful?
Edit this page
Previous

Azure (AKS)

Deploy jambonz on Azure Kubernetes Service
Next
Built with

Prerequisites

You will need:

  • An AWS account with appropriate permissions
  • AWS CLI installed and configured with your credentials
  • Terraform >= 1.5
  • kubectl installed

Provision the EKS Cluster

The Terraform templates for provisioning an EKS cluster are available here.

  • Clone the Terraform repository to your local machine.
  • Navigate to aws/provision-eks-cluster.
  • Copy terraform.tfvars.example to terraform.tfvars and edit it with your desired settings.
  • Run terraform init && terraform plan && terraform apply to provision the cluster.
  • Update your kubeconfig: aws eks update-kubeconfig --region <region> --name <cluster-name>
  • Verify: kubectl get nodes --show-labels

EKS uses Elastic IPs for SIP and RTP nodes, assigned automatically via an ec2-eip-allocator init container. The Terraform templates configure the necessary IAM permissions for this.

Deploy jambonz

Once the cluster is provisioned, deploy jambonz using the Helm chart. Follow the instructions in the Helm chart README to configure and install.

After deployment, complete the Post-Install Steps and generate a license key as described in Software Licensing.

Cleanup

When tearing down, follow this order:

  1. helm uninstall jambonz -n jambonz
  2. kubectl delete namespace jambonz
  3. kubectl delete svc --all-namespaces --field-selector spec.type=LoadBalancer
  4. Wait 60 seconds for AWS to clean up load balancers.
  5. terraform destroy

Resources

  • EKS Terraform templates
  • jambonz Helm chart