From 8e9e6b4d3615547973702f5fd78524d15416f547 Mon Sep 17 00:00:00 2001 From: Scott Seago Date: Thu, 16 Apr 2026 14:42:48 -0400 Subject: [PATCH] added parallel backup configuration to install docs (#9729) * added parallel backup configuration to install docs Signed-off-by: Scott Seago * Update site/content/docs/main/customize-installation.md Co-authored-by: Tiger Kaovilai Signed-off-by: Scott Seago --------- Signed-off-by: Scott Seago Co-authored-by: Tiger Kaovilai --- site/content/docs/main/customize-installation.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/site/content/docs/main/customize-installation.md b/site/content/docs/main/customize-installation.md index c73142fdf..7774565f1 100644 --- a/site/content/docs/main/customize-installation.md +++ b/site/content/docs/main/customize-installation.md @@ -342,6 +342,12 @@ If you are installing Velero in Kubernetes 1.14.x or earlier, you need to use `k If you intend to use Velero with a storage provider that is secured by a self-signed certificate, you may need to instruct Velero to trust that certificate. See [use Velero with a storage provider secured by a self-signed certificate][9] for details. +## Enabling parallel/concurrent backup processing + +By default, only one backup is processed in the `InProgress` phase at a time. The install flag `concurrent-backups`, which takes an integer argument, configures Velero to process multiple backups at the same time, up to a max of `concurrent-backups`. The other restriction on parallel backup processing is that two backups which have any included namespaces in common may not run at the same time. For example, if `concurrent-backups` is set to 2 and two backups for "namespace1" are submitted at the same time, only one of those will be processed at the same time. On the other hand, if a backup for "namespace1" and another for "namespace2" are submitted, then both can be processed in parallel. Note that a whole-cluster backup (one which does not restrict to a set list of namespaces) includes all namespaces, and therefore it will not run in parallel with any other backup. + +Enabling parallel backups can provide a significant performance benefit for backups which contain a large number of Kubernetes resources or ones which contain a large number of smaller volumes. Backups dominated by large volumes will not see as much benefit, since the majority of time for those backups is spent waiting for the async phase to complete. A larger `concurrent-backups` configuration may require additional memory and CPU resources for the velero container. + ## Additional options Run `velero install --help` or see the [Helm chart documentation](https://vmware-tanzu.github.io/helm-charts/) for the full set of installation options.