Roll back an upgrade
Roll back a release line
Section titled “Roll back a release line”You can’t move an instance back to an earlier release line in place. Rolling back reinstalls Kindo from the backups you took before the upgrade, and loses everything that changed since. Restore the earlier backup rather than installing fresh. Installing fresh creates new encryption keys, which can’t read your restored databases.
1. Back up the current state
Section titled “1. Back up the current state”In case you need to return, back up the current databases and the Qdrant, ClickHouse, and HyperDX data. If the upgrade finished, also back up the config with the current Kindo CLI.
If Kindo serves your own certificate, save it too. Run this from the folder that holds your backups:
( set -euo pipefail fail() { echo "error: $*" >&2; exit 1; } names=$(kubectl -n api get ingress -o json | jq -r '[.items[].spec.tls[]?.secretName | select(. != null and . != "")] | unique | .[]') \ || fail "could not read the Ingresses in the api namespace" if [ -z "$names" ]; then echo "The api Ingress serves no TLS Secret of its own, so there is nothing to save" exit 0 fi [ "$(printf '%s\n' "$names" | wc -l)" -eq 1 ] || fail "the api Ingresses name more than one TLS Secret: $(printf "%s\n" "$names" | paste -sd " " -)" secret=$(kubectl -n api get secret "$names" -o json) || fail "could not read the TLS Secret $names in the api namespace" if [ -n "$(printf '%s' "$secret" | jq -r '.metadata.annotations["cert-manager.io/certificate-name"] // empty')" ]; then echo "cert-manager issues $names, so there is nothing to save" exit 0 fi umask 077 printf '%s' "$secret" | jq -e '{"tls.crt": .data["tls.crt"], "tls.key": .data["tls.key"]} | select(.["tls.crt"] and .["tls.key"])' \ > ingress-tls.json.partial || fail "the TLS Secret $names in the api namespace holds no certificate and key" mv ingress-tls.json.partial ingress-tls.json echo "saved the certificate and key from $names to ingress-tls.json")2. Remove Kindo and its namespaces
Section titled “2. Remove Kindo and its namespaces”Run this with the current CLI:
kindo uninstall all --delete-namespaces3. Restore your external databases and object storage
Section titled “3. Restore your external databases and object storage”Restore them from before the upgrade.
4. Restore the config backup
Section titled “4. Restore the config backup”Restore the config backup you took before the upgrade, with the earlier version’s CLI. To return to 2026.09, use the 2026.09 CLI and the backup you took before the config migration. Run it from the directory that holds your install contract and environment bindings files.
kindo restore kindo-before-upgrade.bundle5. Put the ingress certificate back
Section titled “5. Put the ingress certificate back”If you saved your certificate in step 1, put it back. Run this from the same folder:
( set -euo pipefail fail() { echo "error: $*" >&2; exit 1; } names=$(kubectl -n api get ingress -o json | jq -r '[.items[].spec.tls[]?.secretName | select(. != null and . != "")] | unique | .[]') \ || fail "could not read the Ingresses in the api namespace" if [ -z "$names" ]; then echo "The api Ingress serves no TLS Secret of its own, so there is nothing to put back" exit 0 fi [ -s ingress-tls.json ] || fail "no saved ingress certificate (ingress-tls.json) in $PWD" [ "$(printf '%s\n' "$names" | wc -l)" -eq 1 ] || fail "the api Ingresses name more than one TLS Secret: $(printf "%s\n" "$names" | paste -sd " " -)" namespaces=$(kubectl get ingress -A -o json \ | jq -r --arg n "$names" '[.items[] | select(any(.spec.tls[]?; .secretName == $n)) | .metadata.namespace] | unique | .[]') \ || fail "could not list the Ingresses" while IFS= read -r ns; do have=$(kubectl -n "$ns" get secret "$names" --ignore-not-found -o name) \ || fail "could not check for $names in the $ns namespace" if [ -n "$have" ]; then echo "$ns already has $names" continue fi jq --arg n "$names" --arg ns "$ns" \ '{apiVersion: "v1", kind: "Secret", type: "kubernetes.io/tls", metadata: {name: $n, namespace: $ns}, data: .}' \ ingress-tls.json | kubectl create -f - >/dev/null || fail "could not create $names in the $ns namespace" echo "created $names in $ns" done <<< "$namespaces")6. Restore the Qdrant, ClickHouse, and HyperDX data
Section titled “6. Restore the Qdrant, ClickHouse, and HyperDX data”Restore it from before the upgrade.
