Amazon EKS Installation

Prerequisites

• Amazon EKS cluster, Kubernetes 1.26+.
• kubectl configured for the target cluster.
• helm 3.
• AWS CLI logged in (for Marketplace methods).

Method 1: AWS Marketplace (Metered)

• Product: Wave Autoscale - Kubernetes AI-Driven Autoscaling (Metered) (opens in a new tab)
• Helm chart: delivered via AWS Marketplace.
• Image registry: AWS Marketplace ECR.
• License: handled by the Marketplace metering product.

values-aws-marketplace-metering.yaml

spec:
  # Option A: create a new PVC and specify a StorageClass.
  storageClassName: "<STORAGE_CLASS_NAME>"
 
  # Option B: use a pre-existing PVC.
  # existingPvcName: "<EXISTING_PVC_NAME>"

Install

Subscribe to the Marketplace product above and follow AWS Marketplace's "Continuous Delivery" / "Configure software" flow, which provides the exact helm install command for your subscription. Use the values-*.yaml above.

Method 2: AWS Marketplace (BYOL)

• Product: Wave Autoscale - Kubernetes AI-Driven Autoscaling (BYOL) (opens in a new tab)
• Helm chart: delivered via AWS Marketplace.
• Image registry: AWS Marketplace ECR.
• License: Wave-issued license key set in license.key.

values-aws-marketplace-byol.yaml

license:
  key: "<LICENSE_KEY>"
 
spec:
  # Option A: create a new PVC and specify a StorageClass.
  storageClassName: "<STORAGE_CLASS_NAME>"
 
  # Option B: use a pre-existing PVC.
  # existingPvcName: "<EXISTING_PVC_NAME>"

Install

Subscribe to the BYOL Marketplace product above and follow the Marketplace's installation flow with the values file from this section.

Method 3: GHCR

• Helm chart: https://release.waveautoscale.io/helm-chart
• Image registry: ghcr.io/stclab-inc/*
• Pull secret: GHCR pull secret provided by the Wave team.

values-ghcr.yaml

ghcr:
  enabled: true
  dockerconfigjson: "<GHCR_PULL_SECRET_DOCKERCONFIGJSON>"
 
license:
  key: "<LICENSE_KEY>"
 
spec:
  # Option A: create a new PVC and specify a StorageClass.
  storageClassName: "<STORAGE_CLASS_NAME>"
 
  # Option B: use a pre-existing PVC.
  # existingPvcName: "<EXISTING_PVC_NAME>"

Install

Replace <CHART_VERSION> with the Wave Autoscale Helm chart version you want.

helm repo add wave-autoscale-helm https://release.waveautoscale.io/helm-chart
helm repo update
 
helm install wave-autoscale-helm wave-autoscale-helm/wave-autoscale-helm \
  -f values-ghcr.yaml \
  --version <CHART_VERSION> \
  --create-namespace \
  -n wave-autoscale

Verify the install

kubectl get pods -n wave-autoscale

Open the web console with port-forward:

kubectl port-forward -n wave-autoscale svc/wave-autoscale-svc 3025:3025

Browse to http://localhost:3025.

Update (GHCR method)

helm repo update
 
helm upgrade wave-autoscale-helm wave-autoscale-helm/wave-autoscale-helm \
  -f values-ghcr.yaml \
  --version <CHART_VERSION> \
  -n wave-autoscale

For Marketplace methods, follow the Marketplace's update flow.

Uninstall

helm uninstall wave-autoscale-helm -n wave-autoscale

Next steps

• Important: Before You Begin: runtime behaviors to know.
• Helm Values & Environment Variables: full env vars and Helm values.
• Troubleshooting: common issues.