Documentation for version v1.5 is no longer actively maintained. The version you are currently viewing is a static snapshot. For up-to-date documentation, see the latest version.
You can run Velero in an on-premises cluster in different ways depending on your requirements.
You must select an object storage backend that Velero can use to store backup data. Supported providers contains information on various options that are supported or have been reported to work by users.
If you do not already have an object storage system, MinIO is an open-source S3-compatible object storage system that can be installed on-premises and is compatible with Velero. The details of configuring it for production usage are out of scope for Velero’s documentation, but an evaluation install guide using MinIO is provided for convenience.
If you need to back up persistent volume data, you must select a volume backup solution. Supported providers contains information on the supported options.
For example, if you use Portworx for persistent storage, you can install their Velero plugin to get native Portworx snapshots as part of your Velero backups.
If there is no native snapshot plugin available for your storage platform, you can use Velero’s restic integration, which provides a platform-agnostic file-level backup solution for volume data.
In an air-gapped deployment, there is no access to the public internet, and therefore no access to public container registries.
In these scenarios, you will need to make sure that you have an internal registry, such as Harbor, installed and the Velero core and plugin images loaded into your internal registry.
Below you will find instructions to downloading the Velero images to your local machine, tagging them, then uploading them to your custom registry.
First, download the Velero image, tag it for the your private registry, then upload it into the registry so that it can be pulled by your cluster.
PRIVATE_REG=<your private registry> VELERO_VERSION=<version of Velero you're targeting, for example v1.4.0> docker pull velero/velero:$VELERO_VERSION docker tag velero/velero:$VELERO_VERSION $PRIVATE_REG/velero:$VELERO_VERSION docker push $PRIVATE_REG/velero:$VELERO_VERSION
Next, repeat these steps for any plugins you may need. This example will use the AWS plugin, but the plugin name should be replaced with the plugins you will need.
PRIVATE_REG=<your private registry> PLUGIN_VERSION=<version of plugin you're targeting, for example v1.0.2> docker pull velero/velero-plugin-for-aws:$PLUGIN_VERSION docker tag velero/velero-plugin-for-aws:$PLUGIN_VERSION $PRIVATE_REG/velero-plugin-for-aws:$PLUGIN_VERSION docker push $PRIVATE_REG/velero-plugin-for-aws:$PLUGIN_VERSION
If you are using restic, you will also need to upload the restic helper image.
PRIVATE_REG=<your private registry> VELERO_VERSION=<version of Velero you're targeting, for example v1.4.0> docker pull velero/velero-restic-restore-helper:$VELERO_VERSION docker tag velero/velero-restic-restore-helper:$VELERO_VERSION $PRIVATE_REG/velero-restic-restore-helper:$VELERO_VERSION docker push $PRIVATE_REG/velero-restic-restore-helper:$VELERO_VERSION
Velero uses Docker manifests for its images, allowing Docker to pull the image needed based on your client machine’s architecture.
If you need to pull a specific image, you should replace the
velero/velero image with the specific architecture image, such as
To see an up-to-date list of architectures, be sure to enable Docker experimental features and use
docker manifest inspect velero/velero (or whichever image you’re interested in), and join the architecture string to the end of the image name with
velero install will use the public
velero/velero image. When using an air-gapped deployment, use your private registry’s image for Velero and your private registry’s images for any plugins.
velero install \ --image=$PRIVATE_REG/velero:$VELERO_VERSION \ --plugins=$PRIVATE_REG/velero-plugin-for-aws:$PLUGIN_VERSION \ <....>