Restore a Backup via CSI

Longhorn can easily restore backups to a volume. For more information on how backups work, refer to the concepts section.

To programmatically restore backups you can use the generic kubernetes csi snapshot mechanism. To learn more about the CSI snapshot mechanism, click here.


CSI snapshot support needs to be enabled on your cluster.

If your Kubernetes distribution does not provide the Kubernetes snapshot controller as well as the snapshot related custom resource definitions, you need to manually deploy them.

For more information, see Enable CSI Snapshot Support.

Restore a Backup via a VolumeSnapshot object

Create a PersistentVolumeClaim object where the dataSource field points to an existing VolumeSnapshot object.

The csi-provisioner will pick this up and instruct the Longhorn CSI driver to provision a new volume with the data from the associated backup.

You can use the same mechanism to restore Longhorn backups that have not been created via the CSI mechanism.

An example PersistentVolumeClaim is below. The dataSource field needs to point to an existing VolumeSnapshot object.

apiVersion: v1
kind: PersistentVolumeClaim
  name: test-restore-snapshot-pvc
  storageClassName: longhorn
    name: test-snapshot-pvc
    kind: VolumeSnapshot
    - ReadWriteOnce
      storage: 2Gi

Restore a Backup that Has No Associated VolumeSnapshot

To restore Longhorn backups that have not been created via the CSI mechanism, you have to first manually create a VolumeSnapshot and VolumeSnapshotContent object for the backup.

Create a VolumeSnapshotContent object with the snapshotHandle field set to bs://backup-volume/backup-name.

The backup-volume and backup-name values can be retrieved from the Backup page in the Longhorn UI.

kind: VolumeSnapshotContent
  name: test-existing-backup
  volumeSnapshotClassName: longhorn
  deletionPolicy: Delete
    # NOTE: change this to point to an existing backup on the backupstore
    snapshotHandle: bs://test-vol/backup-625159fb469e492e
    name: test-snapshot-existing-backup
    namespace: default

Create the associated VolumeSnapshot object with the name field set to test-snapshot-existing-backup, where the source field refers to a VolumeSnapshotContent object via the volumeSnapshotContentName field.

This differs from the creation of a backup, in which case the source field refers to a PerstistentVolumeClaim via the persistentVolumeClaimName field.

Only one type of reference can be set for a VolumeSnapshot object.

kind: VolumeSnapshot
  name: test-snapshot-existing-backup
  volumeSnapshotClassName: longhorn
    volumeSnapshotContentName: test-existing-backup

Now you can create a PerstistantVolumeClaim object that refers to the newly created VolumeSnapshot object.

For an example see Restore a backup via a VolumeSnapshot object above.