# Velero Plugin for CSI

Velero Plugin for CSI is a Velero plugin that snapshots Container Storage Interface (CSI)-backed persistent volumes in Kubernetes, enabling cluster operators to include those volumes in Velero backup and restore jobs. It is open source and self-hosted, installable on Docker Hub.

Canonical page: https://ourlocalhost.com/app/5932/velero-plugin-for-csi

## Description

Velero Plugin for CSI is a Velero plugin that snapshots Container Storage Interface (CSI)-backed persistent volumes in Kubernetes, enabling cluster operators to include those volumes in Velero backup and restore jobs. The upstream repository is archived and no longer actively developed, but a Docker Hub image keeps builds available.

## Platform availability

Available on 0 of 10 platforms.

## Health score

29/100 (Low), based on 5 of 5 factors.
- Maintained: 0 (GitHub repository is archived)
- Popular: 42 (119 GitHub stars)
- Easy to install: 25 (0 install platforms, install notes, Docker image)
- Light to run: 100 (128 MB minimum RAM, runs on ARM)
- Security check: 20 (1 serious finding, 4 minor, CI, tests, OpenSSF Scorecard 4.2/10)

## Security check

1 serious finding: Uses google.golang.org/grpc v1.58.3, which has a known critical vulnerability.
Automated checks on commit e8f7af4, 9 Nov 2026. Not an audit.

## Links

- GitHub: https://github.com/vmware-tanzu/velero-plugin-for-csi
- Docker Hub: https://hub.docker.com/r/cleanstart/velero-plugin-for-csi

## Common questions

### What Velero feature and plugin are required for CSI snapshot support?

The Velero server must be running with the EnableCSI feature flag. The Velero CSI plugin is necessary to integrate with the CSI volume snapshot APIs.

### Which backup storage values should be set during velero install?

Set the storage provider, backup bucket, and credentials file. If these are wrong, Velero may start but backups will fail or go to the wrong place.

### How can snapshot settings cause PV data to be missed?

Use the snapshot-location-config and volume snapshot settings that match your provider. If snapshot settings are wrong or disabled, data inside persistent volumes may not be backed up.

### Does the CSI plugin work the same with every storage vendor?

It uses the CSI beta snapshot APIs to snapshot CSI-backed PVCs. The actual snapshot implementation varies by storage vendor.

### Can it be used with Ceph in a homelab?

A homelab example installed Velero on a bare-metal Kubernetes cluster and used rook-ceph's CSI snapshotter to back up 700+ volumes and 12TB.

---
Source: Our Local Host (https://ourlocalhost.com/app/5932/velero-plugin-for-csi), the self-hosted and open-source app directory.
