Skip to content
Velero icon
v1.7.0App: vv1.18.4Pinned DigestS3 Backup Ready

Production Helm chart • Apache-2.0 • Zero-Root • Verified on Kubernetes v1.33-v1.36+

Velero Helm Chart

Deploy Velero on Kubernetes for cluster backup, restore, migration, and filesystem backup workflows.

This chart uses the official velero/velero image and is intentionally centered on a clear v1 scope:

  • explicit plugin init containers
  • S3-compatible object storage as the main path
  • optional BackupStorageLocation, VolumeSnapshotLocation, and Schedule resources
  • optional node-agent DaemonSet for filesystem backup

Features

  • Official velero/velero image pinned to the latest stable Velero release
  • Official CRDs included through the chart crds/ directory
  • AWS plugin by default for AWS S3 and S3-compatible providers such as MinIO
  • BackupStorageLocation resources rendered directly from chart values
  • VolumeSnapshotLocation resources rendered when snapshot providers are configured
  • Schedule resources for recurring backups
  • Optional node-agent for filesystem backup workflows
  • Optional ServiceMonitor for Prometheus Operator
  • Restricted server and plugin containers with non-root identities, read-only root filesystems, dropped capabilities, and RuntimeDefault seccomp
  • NetworkPolicy enabled by default for the server metrics endpoint
  • Configurable metrics listener and Service ports connected by a named target port
  • Startup, readiness, and liveness probes against the metrics listener
  • Extra objects support for carefully reviewed provider-specific resources

Installation

HTTPS repository

helm repo add helmforge https://repo.helmforge.dev
helm repo update
helm install velero helmforge/velero -n velero --create-namespace -f values.yaml

OCI registry

helm install velero oci://ghcr.io/helmforgedev/helm/velero -n velero --create-namespace -f values.yaml

S3-Compatible Example

credentials:
  secretContents: |
    [default]
    aws_access_key_id=minioadmin
    aws_secret_access_key=minioadmin123

configuration:
  backupStorageLocations:
    - name: default
      provider: aws
      bucket: velero
      default: true
      config:
        region: minio
        s3Url: http://minio.minio.svc.cluster.local:9000
        s3ForcePathStyle: true
        checksumAlgorithm: ""
        insecureSkipTLSVerify: true

nodeAgent:
  enabled: true

Scheduled Backup Example

schedules:
  - name: daily
    schedule: "0 3 * * *"
    template:
      ttl: 168h
      includedNamespaces:
        - apps
      snapshotVolumes: false
      defaultVolumesToFsBackup: true

For a complete hardened configuration, see examples/production.yaml.

Metrics Port Example

The process listener is independent from the Service port. The Service uses a named target so both values can change safely:

metrics:
  containerPort: 9085
  service:
    port: 9090
Official Schema

Values & Configuration Reference

All schema parameters, types, defaults, and allowed values are extracted directly from the chart repository. Filter and search them in the interactive reference below or customize in Values Studio.

View Values Schema

|-----|---------|-------------| | commonAnnotations | {} | Annotations added to chart-owned resource metadata, excluding pod templates | | image.repository | docker.io/velero/velero | Velero server image | | image.tag | v1.18.4 | Velero server image tag | | plugins.aws.tag | v1.14.0 | Default AWS/S3 plugin image tag | | credentials.useSecret | true | Mount credentials when existingSecret, name, or secretContents is set | | credentials.existingSecret | "" | Existing credentials secret | | configuration.backupStorageLocations | one empty default entry | Backup storage definitions | | configuration.backupStorageLocations[].config.checksumAlgorithm | unset (CRC32 upstream) | S3 checksum algorithm; set "" to disable checksum headers | | configuration.volumeSnapshotLocations | [] | Snapshot storage definitions | | configuration.defaultVolumesToFsBackup | false | Default filesystem backup mode | | nodeAgent.enabled | false | Deploy filesystem backup DaemonSet | | schedules | [] | Schedule resources created by the chart | | metrics.containerPort | 8085 | Port listened on by the Velero process | | metrics.service.port | 8085 | Metrics Service port | | service.ipFamilyPolicy | "" | Optional metrics Service IP family policy | | metrics.serviceMonitor.enabled | false | Create a ServiceMonitor | | networkPolicy.enabled | true | Isolate the Velero server pod | | networkPolicy.allowExternalEgress | true | Allow Kubernetes API and object-storage egress | | extraManifests | [] | Additional manifests rendered with tpl |

Architecture Guides

Resources Generated

Resource Condition
ServiceAccount serviceAccount.server.create
ClusterRoleBinding rbac.create and rbac.clusterAdministrator
Secret credentials.useSecret and no credentials.existingSecret
Deployment Always
DaemonSet node-agent nodeAgent.enabled
Service metrics.enabled
ServiceMonitor metrics.serviceMonitor.enabled
NetworkPolicy networkPolicy.enabled
BackupStorageLocation one per configuration.backupStorageLocations entry
VolumeSnapshotLocation one per configuration.volumeSnapshotLocations entry
Schedule one per schedules entry
Extra manifests one per extraManifests entry

Notes

  • this v1 chart is intentionally focused on clear install and configuration flows, not on abstracting every Velero provider combination
  • for S3-compatible storage, use the AWS plugin with explicit s3Url and s3ForcePathStyle settings when required by the provider
  • if you enable nodeAgent, validate hostPath and Pod Security expectations in your cluster before relying on filesystem backups
  • the server and default AWS plugin run as non-root with restricted security contexts; the optional node-agent runs as UID 0 because filesystem backup requires kubelet host-path access
  • NetworkPolicy egress is open by default because the Kubernetes API and object-storage endpoints are installation-specific; set networkPolicy.allowExternalEgress=false before adding a restrictive environment-specific policy, because NetworkPolicy rules are additive
  • when the node-agent uses Kopia, the chart mounts ephemeral writable /home/cnb/udmrepo and /home/cnb/.cache paths in the server and node-agent while keeping their root filesystems read-only

Velero v1.18.4 fixes a backup queue that could remain stuck when a dequeued backup completed during its status patch. Review the upstream release before upgrading production recovery infrastructure.

Troubleshooting

If the Deployment is not ready, inspect the server logs and the status of the configured backup storage locations:

kubectl logs deployment/velero -n velero --all-containers
kubectl get backupstoragelocations.velero.io -n velero -o yaml

An unavailable backup storage location normally indicates invalid provider credentials, an unreachable endpoint, a missing bucket, or an incompatible plugin. If probes fail after changing ports, confirm metrics.containerPort matches the --metrics-address argument in the pod; metrics.service.port affects only the Service-facing port. See the operations guide for recovery checks and upgrade notes.

Security Scan

Security Scan: velero

Framework Score
MITRE + NSA + SOC2 77.27273%

Security posture acceptable.

More Information

System Architecture

DESIGN.md Synced

Verified architecture contract rendered dynamically from GitHub DESIGN.md

flowchart TD
  values[Helm values] --> deploy[Velero Deployment]
  values --> bsl[BackupStorageLocation]
  values --> vsl[VolumeSnapshotLocation]
  values --> schedules[Schedule resources]
  values --> metrics[Metrics Service]
  values --> nodeAgent[Node-agent DaemonSet]
  credentials[Credentials Secret] --> deploy
  credentials --> nodeAgent
  plugins[Provider plugin init containers] --> deploy
  deploy --> objectStore[S3 or S3-compatible object storage]
  nodeAgent --> podVolumes[Pod volume host paths]
  schedules --> backups[Velero Backup resources]
  backups --> objectStore
Official Contractvalues.schema.json

Velero Values Schema Reference

Official schema parameters, default values, and types extracted directly from the chart repository.

139 parametersValues Studio

Global(1)

ParameterTypeDefaultDescription
globalobject-Global settings shared by the chart.

Name Override(1)

ParameterTypeDefaultDescription
nameOverridestring-Override the chart name used in resource names

Fullname Override(1)

ParameterTypeDefaultDescription
fullnameOverridestring-Override the full release name used in resource names

Common Labels(1)

ParameterTypeDefaultDescription
commonLabelsobject-Labels added to every resource created by this chart

Common Annotations(1)

ParameterTypeDefaultDescription
commonAnnotationsobject-Annotations added to chart-owned resource metadata, excluding pod templates

Image(3)

ParameterTypeDefaultDescription
image.repositorystring-Velero server image repository
image.tagstring-Velero server image tag (defaults to appVersion when empty)
image.pullPolicystring-Image pull policy
Allowed:AlwaysIfNotPresentNever

Image Pull Secrets(1)

ParameterTypeDefaultDescription
imagePullSecretsarray-Image pull secrets for private registries

Plugins(12)

ParameterTypeDefaultDescription
plugins.enabledboolean-Enable the default AWS/S3-compatible plugin init container
plugins.aws.namestring-Init container name for the AWS plugin
plugins.aws.repositorystring-AWS plugin image repository
plugins.aws.tagstring-AWS plugin image tag
plugins.aws.pullPolicystring-AWS plugin image pull policy
Allowed:AlwaysIfNotPresentNever
plugins.aws.securityContext.allowPrivilegeEscalationboolean-Chart configuration parameter
plugins.aws.securityContext.readOnlyRootFilesystemboolean-Chart configuration parameter
plugins.aws.securityContext.runAsNonRootboolean-Chart configuration parameter
plugins.aws.securityContext.runAsUserinteger-Chart configuration parameter
plugins.aws.securityContext.runAsGroupinteger-Chart configuration parameter
plugins.aws.securityContext.capabilities.droparray-Chart configuration parameter
plugins.extraarray-Extra plugin init containers appended after the default AWS plugin

Credentials(7)

ParameterTypeDefaultDescription
credentials.useSecretboolean-Mount a credentials secret into the Velero pods
credentials.existingSecretstring-Existing secret containing the credentials file
credentials.namestring-Secret name to create when existingSecret is empty
credentials.keystring-Key used inside the credentials secret
credentials.secretContentsstring-Full credentials file content used when creating the secret inline
credentials.extraEnvVarsobject-Extra environment variables loaded from the credentials secret
credentials.extraSecretRefstring-Existing secret reference loaded through envFrom

Service Account(5)

ParameterTypeDefaultDescription
serviceAccount.server.createboolean-Create the Velero service account
serviceAccount.server.namestring-Existing service account name
serviceAccount.server.annotationsobject-Annotations added to the service account
serviceAccount.server.labelsobject-Labels added to the service account
serviceAccount.server.automountServiceAccountTokenboolean-Automount the API token into the pod

Rbac(3)

ParameterTypeDefaultDescription
rbac.createboolean-Create a ClusterRoleBinding for the Velero service account
rbac.clusterAdministratorboolean-Bind the service account to cluster-admin
rbac.clusterAdministratorNamestring-ClusterRole name bound when clusterAdministrator is true

Configuration(15)

ParameterTypeDefaultDescription
configuration.namespacestring-Kubernetes namespace watched by the Velero server (defaults to release namespace)
configuration.uploaderTypestring-Uploader type used by Velero
Allowed:kopiarestic
configuration.defaultBackupTTLstring-Default backup TTL applied by the server
configuration.defaultItemOperationTimeoutstring-Default item operation timeout
configuration.storeValidationFrequencystring-Default storage validation frequency
configuration.metricsAddressstring-Deprecated pre-1.6 metrics listener; prefer metrics.containerPort
configuration.logLevelstring-Server log level
Allowed:tracedebuginfowarningerrorfatalpanic
configuration.logFormatstring-Server log format
Allowed:textjson
configuration.restoreOnlyModeboolean-Start the server in restore-only mode
configuration.defaultVolumesToFsBackupboolean-Enable filesystem backup by default for pod volumes
configuration.featuresstring-Comma-separated Velero feature flags
configuration.extraArgsarray-Additional server arguments
configuration.extraEnvVarsarray-Additional environment variables for the Velero server and node-agent
configuration.backupStorageLocationsarray-Backup storage location definitions
configuration.volumeSnapshotLocationsarray-Volume snapshot location definitions

Schedules(1)

ParameterTypeDefaultDescription
schedulesarray-Velero backup schedule definitions

Pod Annotations(1)

ParameterTypeDefaultDescription
podAnnotationsobject-Extra annotations for pods

Pod Labels(1)

ParameterTypeDefaultDescription
podLabelsobject-Extra labels for pods

Pod Security(5)

ParameterTypeDefaultDescription
podSecurityContext.runAsNonRootboolean-Chart configuration parameter
podSecurityContext.runAsUserinteger-Chart configuration parameter
podSecurityContext.runAsGroupinteger-Chart configuration parameter
podSecurityContext.fsGroupinteger-Chart configuration parameter
podSecurityContext.seccompProfile.typestring-Chart configuration parameter

Container Security Context(7)

ParameterTypeDefaultDescription
containerSecurityContext.allowPrivilegeEscalationboolean-Chart configuration parameter
containerSecurityContext.runAsNonRootboolean-Chart configuration parameter
containerSecurityContext.runAsUserinteger-Chart configuration parameter
containerSecurityContext.runAsGroupinteger-Chart configuration parameter
containerSecurityContext.capabilities.droparray-Chart configuration parameter
containerSecurityContext.privilegedboolean-Chart configuration parameter
containerSecurityContext.readOnlyRootFilesystemboolean-Chart configuration parameter

Resources(1)

ParameterTypeDefaultDescription
resourcesobject-Resource requests and limits for the Velero server

Priority Class Name(1)

ParameterTypeDefaultDescription
priorityClassNamestring-Priority class name for pods

Runtime Class Name(1)

ParameterTypeDefaultDescription
runtimeClassNamestring-Runtime class name for pods

Termination Grace Period Seconds(1)

ParameterTypeDefaultDescription
terminationGracePeriodSecondsinteger-Termination grace period in seconds

Node Selector(1)

ParameterTypeDefaultDescription
nodeSelectorobject-Node selector for pod scheduling

Tolerations(1)

ParameterTypeDefaultDescription
tolerationsarray-Tolerations for pod scheduling

Affinity(1)

ParameterTypeDefaultDescription
affinityobject-Affinity rules for pod scheduling

Dns Policy(1)

ParameterTypeDefaultDescription
dnsPolicystring-DNS policy for pods

Dns Config(1)

ParameterTypeDefaultDescription
dnsConfigobject-DNS configuration for pods

Host Aliases(1)

ParameterTypeDefaultDescription
hostAliasesarray-Host aliases for pods

Extra Volumes(1)

ParameterTypeDefaultDescription
extraVolumesarray-Extra volumes for pods

Extra Volume Mounts(1)

ParameterTypeDefaultDescription
extraVolumeMountsarray-Extra volume mounts for containers

Node Agent(28)

ParameterTypeDefaultDescription
nodeAgent.enabledboolean-Deploy the Velero node-agent DaemonSet for filesystem backup
nodeAgent.disableHostPathboolean-Disable hostPath mounts in the node-agent
nodeAgent.podVolumePathstring-Host path to pod volumes
nodeAgent.pluginVolumePathstring-Host path to kubelet plugins
nodeAgent.useScratchEmptyDirboolean-Mount an emptyDir scratch volume into the node-agent
nodeAgent.podSecurityContext.seccompProfile.typestring-Chart configuration parameter
nodeAgent.containerSecurityContext.allowPrivilegeEscalationboolean-Chart configuration parameter
nodeAgent.containerSecurityContext.capabilities.droparray-Chart configuration parameter
nodeAgent.containerSecurityContext.privilegedboolean-Chart configuration parameter
nodeAgent.containerSecurityContext.readOnlyRootFilesystemboolean-Chart configuration parameter
nodeAgent.containerSecurityContext.runAsUserinteger-Chart configuration parameter
nodeAgent.resourcesobject-Resource requests and limits for node-agent
nodeAgent.updateStrategyobject-DaemonSet update strategy
nodeAgent.priorityClassNamestring-Priority class name for node-agent pods
nodeAgent.runtimeClassNamestring-Runtime class name for node-agent pods
nodeAgent.nodeSelectorobject-Node selector for node-agent pods
nodeAgent.tolerationsarray-Tolerations for node-agent pods
nodeAgent.affinityobject-Affinity rules for node-agent pods
nodeAgent.dnsPolicystring-DNS policy for node-agent pods
nodeAgent.dnsConfigobject-DNS configuration for node-agent pods
nodeAgent.hostAliasesarray-Host aliases for node-agent pods
nodeAgent.annotationsobject-Annotations for the node-agent DaemonSet
nodeAgent.labelsobject-Labels for the node-agent DaemonSet
nodeAgent.podLabelsobject-Extra labels for node-agent pods
nodeAgent.extraArgsarray-Extra arguments for node-agent
nodeAgent.extraEnvVarsarray-Extra environment variables for node-agent
nodeAgent.extraVolumesarray-Extra volumes for node-agent pods
nodeAgent.extraVolumeMountsarray-Extra volume mounts for node-agent containers

Metrics & Observability(12)

ParameterTypeDefaultDescription
metrics.enabledboolean-Expose Velero metrics on a Service
metrics.containerPortinteger-Port listened on by the Velero metrics server
metrics.service.annotationsobject-Service annotations for Velero metrics
metrics.service.labelsobject-Service labels for Velero metrics
metrics.service.typestring-Service type
Allowed:ClusterIPNodePortLoadBalancer
metrics.service.portinteger-Metrics port
metrics.serviceMonitor.enabledboolean-Create a ServiceMonitor for Prometheus Operator
metrics.serviceMonitor.annotationsobject-ServiceMonitor annotations
metrics.serviceMonitor.additionalLabelsobject-Additional ServiceMonitor labels
metrics.serviceMonitor.namespacestring-ServiceMonitor namespace (defaults to release namespace)
metrics.serviceMonitor.intervalstring-Metrics scrape interval
metrics.serviceMonitor.scrapeTimeoutstring-Metrics scrape timeout

Liveness Probe(5)

ParameterTypeDefaultDescription
livenessProbe.enabledboolean-Chart configuration parameter
livenessProbe.initialDelaySecondsinteger-Chart configuration parameter
livenessProbe.periodSecondsinteger-Chart configuration parameter
livenessProbe.timeoutSecondsinteger-Chart configuration parameter
livenessProbe.failureThresholdinteger-Chart configuration parameter

Readiness Probe(5)

ParameterTypeDefaultDescription
readinessProbe.enabledboolean-Chart configuration parameter
readinessProbe.initialDelaySecondsinteger-Chart configuration parameter
readinessProbe.periodSecondsinteger-Chart configuration parameter
readinessProbe.timeoutSecondsinteger-Chart configuration parameter
readinessProbe.failureThresholdinteger-Chart configuration parameter

Startup Probe(5)

ParameterTypeDefaultDescription
startupProbe.enabledboolean-Chart configuration parameter
startupProbe.initialDelaySecondsinteger-Chart configuration parameter
startupProbe.periodSecondsinteger-Chart configuration parameter
startupProbe.timeoutSecondsinteger-Chart configuration parameter
startupProbe.failureThresholdinteger-Chart configuration parameter

Network Policy(2)

ParameterTypeDefaultDescription
networkPolicy.enabledboolean-Chart configuration parameter
networkPolicy.allowExternalEgressboolean-Chart configuration parameter

Service & Networking(2)

ParameterTypeDefaultDescription
service.ipFamilyPolicystring-Service IP family policy
Allowed:SingleStackPreferDualStackRequireDualStack
service.ipFamiliesarray-Ordered Service IP families

Extra Manifests(1)

ParameterTypeDefaultDescription
extraManifestsarray-Additional manifests rendered with tpl

Extra Objects(1)

ParameterTypeDefaultDescription
extraObjectsarray-Deprecated pre-1.6 alias for extraManifests