How to Upgrade K8up

Never remove the CRDs, as you might lose the respective resources!

Upgrade K8up from 1.x to 2.x

Because of the move of K8up to its own GitHub organization, and a cleanup of several namings, there are visible changes from a user’s perspective in K8up 2.x, which require (manual) intervention for a successful upgrade. These changes require you to update your configuration of K8up.

Move to our own GitHub organization

We have moved K8up into its own GitHub organization. As a result, we also updated some names.

  • In the CRD definition, what was is now We’ve also updated the version from v1alpha to v1. So, for example, becomes

  • The default values for the annotations have been changed from to Internally used annotations will be handled transparently. But annotations, which have been added to resources (such as need to be updated accordingly (in the previous example to Alternatively, you can also change the annotations back in the operator’s configuration. In the previous example, you could set BACKUP_BACKUPCOMMANDANNOTATION to k8up.syn.tool/backupcommand to overwrite the new default.

  • If you directly reference our Go code in your Go code, then you will need to update the imports. The k8up Go module is now called

Our docs are still at Our reference helm chart has moved to and was updated accordingly.

Wrestic Integration

We have integrated the code previously known as wrestic into k8up. This may have several consequences for you:

  • If you reference any vshn/wrestic image in your K8up configuration, then you need to update the reference to or This would usually be done in the configuration for the respective Helm chart. Our reference helm chart was updated accordingly.

  • If you changed the command (or args, respectively) of the vshn/k8up or vshn/wrestic Docker images, then you will need to update them. k8up becomes k8up operator, while wrestic becomes k8up restic.

  • If you relied on the -nonroot images of vshn/wrestic, then you need to update your configuration. Since version 2.0 you’re able to specify a podSecurityContext on the Schedule level as well on each of the actions, like on Backup, Restore and the likes.

Upgrade K8up from 0.x to 1.x

The upgrade is generally done with the following steps:

  1. Prepare new Helm release

  2. Uninstall K8up 0.x

  3. Install K8up 1.x

  4. Verify your backups work


  1. kubectl or oc

  2. helm version 3, version 2 for deinstallation if you’re still using Tiller

  3. yq version 4 (alternatively, any editor works)

You might need to adapt the commands to your needs. This guide does not provide a copy-paste upgrade script, but points you in the right direction. It also assumes that you know basic usage of Helm.

Prepare new Helm release

The Helm Chart comes with a few new and changed properties. Please consult the README.

Most notably, the Chart is targeted to recent Kubernetes versions.

Use helm upgrade --reuse-values only when you know what you’re doing. Some parameters have changed and are backwards incompatible. Make sure you have the new CRDs installed beforehand.

Uninstall 0.x

# Set the namespace
# Shut down and uninstall K8up. This should not delete the CRDs
helm -n ${ns} uninstall k8up

Install 1.x

  1. Make sure to prepare any changed Helm values before installing the release.

  2. Prepare all CRDs for 3-way-merge with kubectl apply

    for crd in; do
      # Get CRD definition in YAML
      kubectl get crd "${crd}" -o yaml > "${crd}.yaml"
      # Remove all metadata properties except ``
      yq -i eval 'del(.status) | del(.metadata) | += "'${crd}'"' "${crd}.yaml"
      # Apply the CRD again (this shouldn't change anything, except adding the annotation "")
      # You will also see some warnings in the output mentioning the annotation.
      # This is expected and actually required.
      kubectl apply -f "${crd}.yaml"
  3. Apply the new CRDs as documented in the Chart README.

  4. Install the Helm Chart version 1.x.

For Kubernetes < 1.15 (OpenShift 3.11), please add --set k8up.enableLeaderElection=false to the helm install command.

Install 2.x and 3.x

Please consult the dedicated README in Helm Chart to install or upgrade Helm charts.

Verify your backups work

# See if the K8up pod came up
kubectl -n ${ns} get pods

# Check for errors in the logs
kubectl -n ${ns} logs -l ""

# Trigger a new backup by creating a new Backup object
kubectl create -f <your-backup-file-spec>