Configuration

Vesta is configured through Helm values. Below is the full reference for all configurable parameters.

Helm Values

Parameter	Description	Default
`operator.image.tag`	Operator image tag	Chart appVersion
`api.image.tag`	API server image tag	Chart appVersion
`ui.image.tag`	UI image tag	Chart appVersion
`api.database.existingSecret`	Name of secret containing `DATABASE_URL`	`""`
`api.database.url`	Inline database URL (if not using a secret)	`""`
`api.ingress.enabled`	Enable API ingress	`false`
`api.ingress.host`	API ingress hostname	`kubernetes.getvesta.sh`
`config.domain`	Default domain for app ingresses	`apps.getvesta.sh`
`config.clusterIssuer`	cert-manager ClusterIssuer for TLS	`letsencrypt-prod`
`config.ingressClassName`	Ingress class to use	`""`
`ui.enabled`	Deploy the web UI	`true`
`ui.ingress.enabled`	Enable UI ingress	`false`
`ui.ingress.host`	UI ingress hostname	`ui.getvesta.sh`

Upgrading

To upgrade Vesta with new values:

helm upgrade vesta oci://ghcr.io/vesta-infra/charts/vesta \
  -n vesta-system \
  --reuse-values \
  --set ui.ingress.enabled=true \
  --set ui.ingress.host=dashboard.example.com

To pin specific image versions:

helm upgrade vesta oci://ghcr.io/vesta-infra/charts/vesta \
  -n vesta-system \
  --reuse-values \
  --set operator.image.tag=0.3.27 \
  --set api.image.tag=0.3.27 \
  --set ui.image.tag=0.3.27

Optional: Metrics Server

If you want to use autoscaling, install the Kubernetes metrics server:

kubectl apply -f https://github.com/kubernetes-sigs/metrics-server/releases/latest/download/components.yaml