Helm Chart

Deploy the OnePAM Zero Trust Access Gateway on Kubernetes using Helm.

OnePAM Gateway Helm Chart

Deploy and manage OnePAM gateways on Kubernetes clusters with the official Helm chart. Supports session recording, TLS, VPN, and multi-replica deployments.


helm repo add onepam https://onepamcom.github.io/helm-charts
helm install gateway onepam/onepam-gateway

Requirements

  • Kubernetes 1.24+
  • Helm 3.x
  • A registered gateway in your OnePAM instance (Gateway ID and API token)
  • Outbound HTTPS (443) to your OnePAM server

Quick Start

# Add the Helm repository
helm repo add onepam https://onepamcom.github.io/helm-charts
helm repo update

# Install with required values
helm install gateway onepam/onepam-gateway \
  --set gateway.gatewayId="YOUR-GATEWAY-ID" \
  --set gateway.apiUrl="https://your-instance.onepam.com" \
  --set gateway.apiToken="YOUR-API-TOKEN" \
  --namespace onepam \
  --create-namespace

# Verify the deployment
kubectl -n onepam get pods

Configuration

Key Values
ValueDefaultDescription
gateway.gatewayId-Gateway ID from OnePAM (required)
gateway.apiUrl-OnePAM server URL (required)
gateway.apiToken-API token for gateway authentication (required)
replicaCount1Number of gateway replicas
image.repositoryghcr.io/onepam/gatewayContainer image repository
image.taglatestContainer image tag
service.typeClusterIPKubernetes service type
service.port443Service port
S3 Session Recording
ValueDefaultDescription
gateway.s3.bucket-S3 bucket for session recordings
gateway.s3.region-S3 bucket region
gateway.s3.accessKey-S3 access key
gateway.s3.secretKey-S3 secret key
TLS / ACME
ValueDefaultDescription
gateway.acme.enabledfalseEnable Let's Encrypt TLS
gateway.acme.domain-Domain for TLS certificate
gateway.acme.email-ACME registration email

Example Values File

values.yaml
replicaCount: 2

gateway:
  gatewayId: "your-gateway-uuid"
  apiUrl: "https://your-instance.onepam.com"
  apiToken: "your-api-token"

  s3:
    bucket: "onepam-recordings"
    region: "us-east-1"

  acme:
    enabled: true
    domain: "gateway.example.com"
    email: "[email protected]"

  vpn:
    enabled: false

resources:
  requests:
    cpu: 100m
    memory: 128Mi
  limits:
    cpu: 500m
    memory: 256Mi
# Deploy with values file
helm install gateway onepam/onepam-gateway \
  -f values.yaml \
  --namespace onepam \
  --create-namespace

Chart Management

# Upgrade to a newer chart version
helm repo update
helm upgrade gateway onepam/onepam-gateway -f values.yaml -n onepam

# Check release status
helm status gateway -n onepam

# View release history
helm history gateway -n onepam

# Rollback to a previous revision
helm rollback gateway 1 -n onepam

# Uninstall
helm uninstall gateway -n onepam