Upgrade

Use this page to upgrade a Kubernetes (Helm) deployment.

Back up your PostgreSQL metadata databases before upgrading. See Back up PostgreSQL.

1

Update values

• Syntho License key upgrade

  • In helm/ray/values.yaml

    • SynthoLicense: <new-license-key>

  • In helm/syntho-ui/values.yaml

    • SynthoLicense: <new-license-key>

• Application version upgrade

  • helm/ray/values.yaml

    • ray-cluster:
        image:
          tag: <new-version-number>

  • helm/syntho-ui/values.yaml

    • frontend:
        image:
          tag: <new-version-number>
      backend:
        image:
          tag: <new-version-number>
      core:
        image:
          tag: <new-version-number>

2

Rotate ImagePullSecret (if registry credentials changed)

kubectl delete secret syntho-cr-secret -n syntho
kubectl create secret docker-registry syntho-cr-secret \
  --namespace syntho \
  --docker-server=<REGISTRY_HOST> \
  --docker-username=<USERNAME> \
  --docker-password=<PASSWORD>

3

Apply the upgrade

helm upgrade ray-cluster ./helm/ray/chart \
  --values helm/ray/values.yaml \
  --namespace syntho

helm upgrade syntho-ui ./helm/syntho-ui \
  --values helm/syntho-ui/values.yaml \
  --namespace syntho

4

Verify

kubectl get pods -n syntho
kubectl get events -n syntho --sort-by=.lastTimestamp | tail -n 30

If pods are restarting:

kubectl logs -n syntho <pod-name>

Ray CRDs (only for some upgrades)

Some Ray/KubeRay upgrades require CRD changes.

If Helm reports CRD-related errors, upgrade the CRDs first (or reinstall Ray following the guidance from Syntho Support).