Skip to content
These docs are a preview of Self-Managed Kindo 2026.11, an upcoming release.

Roll back an upgrade

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.

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:

Terminal window
(
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"
)

Run this with the current CLI:

Terminal window
kindo uninstall all --delete-namespaces

3. Restore your external databases and object storage

Section titled “3. Restore your external databases and object storage”

Restore them from before the upgrade.

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.

Terminal window
kindo restore kindo-before-upgrade.bundle

If you saved your certificate in step 1, put it back. Run this from the same folder:

Terminal window
(
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.