# Install velero with Homebrew, chocolatey, Nix, pacman, scoop, zypper

Disaster recovery for Kubernetes resources and persistent volumes. Version 1.18.2 via Homebrew; verified 2026-07-04.

## Install

```sh
sudo av install brew:velero
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install velero
```

  Evidence: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#velero
```

  Evidence: nixpkgs package indexes: pkgs/by-name/ve/velero/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

- pacman (92%):

```sh
sudo pacman -S velero
```

  Evidence: Arch Linux sync databases: velero from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz

- zypper (92%):

```sh
sudo zypper install velero
```

  Evidence: openSUSE Tumbleweed package metadata: velero from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst

### Windows

- Chocolatey (92%):

```sh
choco install velero
```

  Evidence: Chocolatey community package catalog: velero from http://community.chocolatey.org/api/v2/Packages?$filter=IsLatestVersion&$select=Id&$top=1000&$skiptoken='9.8224','qfinderpro'

- Scoop (92%):

```sh
scoop install main/velero
```

  Evidence: Scoop official bucket manifest trees: bucket/velero.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1

## Package facts

- **Package key:** brew:velero
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/velero>
- **Version:** 1.18.2
- **Source summary:** Disaster recovery for Kubernetes resources and persistent volumes
- **Homepage:** <https://velero.io/>
- **Repository:** <https://github.com/velero-io/velero>
- **Upstream docs:** <https://velero.io/docs/v1.18>
- **License:** Apache-2.0
- **Source archive:** <https://github.com/velero-io/velero/archive/refs/tags/v1.18.2.tar.gz>
- **Last updated:** 2026-07-04T16:53:46+09:00
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- velero (cli)
- velero (alias)

## Build dependencies

- go

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 1.18.2
- Package-manager updated: 2026-07-04
- Local data: ok
- Upstream repository: https://github.com/velero-io/velero
- Upstream latest detected: v1.18.2 (current)
## Project history and usage

Velero is a Kubernetes backup, restore, disaster-recovery, and migration system. It runs a server component in the cluster plus a local CLI, stores backup metadata in object storage, and integrates with volume snapshots or file-system backup tools for persistent volume data.

### Project history

Velero began as Heptio Ark, an open-source project from Heptio for backing up Kubernetes objects and persistent volumes. The older Ark documentation described the same core use cases that still define Velero: disaster recovery, pre-operation snapshots, and selective restore by object type, namespace, or labels.

After VMware acquired Heptio, the project was renamed from Heptio Ark to Velero in the v0.11.0 release line in early 2019. The migration guide documents the operational renaming: the CLI moved from `ark` to `velero`, the default namespace and service account changed, CRDs moved to the `velero.io` API group, and image names changed.

Velero has continued as a Kubernetes-native data-protection project under VMware Tanzu and later Broadcom stewardship. In 2026 Broadcom moved the project toward vendor-neutral governance by donating it to the CNCF Sandbox, with CNCF and Broadcom coverage presenting the move as a way to widen community trust and collaboration.

### Adoption history

Velero became one of the default open-source answers for cluster-level Kubernetes backup because it works at the Kubernetes API layer instead of treating etcd or a storage array as the only source of truth. That let platform teams back up resource definitions, restore namespaces, clone environments, and migrate workloads across clusters.

Its ecosystem grew around cloud-provider plugins, object stores, volume snapshot integrations, Restic/Kopia-style file-system backups, and operational guides from cloud vendors. AWS, Harbor, Tanzu, and many Kubernetes tutorials describe Velero as a standard tool for protecting cluster resources and persistent volumes.

The CNCF Sandbox move in 2026 is important historically because Kubernetes backup spans vendors, clouds, and storage systems. Neutral governance makes Velero more plausible as shared infrastructure rather than a VMware/Broadcom-adjacent utility.

### How it is used

Operators install the server into a Kubernetes cluster, configure backup storage and credentials, then use the `velero` CLI to create backups, schedules, restores, and plugin configuration. Common workflows include scheduled namespace backups, ad-hoc snapshots before upgrades, restoring deleted resources, cloning a production namespace into a development cluster, and seeding migrations.

Velero is strongest when users understand the boundary between Kubernetes resources and application data. It captures API resources directly, while persistent volumes depend on snapshot support, file-system backup, or data-mover integrations. That distinction is why serious Velero runbooks also document database-native backup choices and restore testing.

### Why package nerds care

For package users, `velero` is the CLI half of a larger cluster service, but it is the interface people reach for during stressful incidents. Its command surface is part backup tool, part migration tool, and part Kubernetes recovery console.

### Timeline

- 2018: Heptio Ark documentation describes Kubernetes object and persistent-volume backup and restore.
- December 2018: VMware acquires Heptio, bringing Ark into the VMware cloud-native portfolio.
- 2019: Ark is renamed Velero in the v0.11.0 release line.
- 2020s: Velero becomes a common open-source option for Kubernetes backup, migration, and disaster recovery across cloud and on-prem environments.
- 2026: Broadcom donates Velero to the CNCF Sandbox, shifting the project toward vendor-neutral governance.

### Related projects

- Velero sits next to cloud snapshot APIs, CSI VolumeSnapshot, Restic, Kopia, Kasten, Portworx backup products, Trilio, Stash, and storage-native backup systems. Its distinguishing role is Kubernetes API-aware recovery rather than only block-storage replication.

### Sources

- <https://aws.amazon.com/blogs/containers/back-up-and-restore-your-amazon-eks-cluster-resources-using-velero/>
- <https://blogs.vmware.com/tanzu/velero-v0-11-delivers-an-open-source-tool-to-back-up-and-migrate-kubernetes-clusters/>
- <https://github.com/cncf/sandbox/issues/457>
- <https://github.com/vmware-tanzu/velero/blob/main/changelogs/CHANGELOG-0.11.md>
- <https://velero.io/>
- <https://velero.io/docs/v0.7.0/about/>
- <https://velero.io/docs/v1.0.0/migrating-to-velero/>
- <https://www.cncf.io/news/2026/04/02/the-new-stack-why-broadcom-gave-velero-to-the-cncf-sandbox-and-what-it-means-for-kubernetes-data-protection/>


## Security Notes

infrastructure mutation or orchestration signal.

- **Geiger risk:** orange / medium
- infrastructure mutation or orchestration signal


## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: ~/.config/velero/config.json

## Credential files

- Unix: ./credentials-velero
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** velero
- **Version Scheme:** 0
- **Revision:** 0
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** stable

## Other Package-Manager Records

- Nix - velero: normalized package name match | nixpkgs package indexes: pkgs/by-name/ve/velero/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- pacman - velero - 1.18.1-1: normalized package name match | Arch Linux sync databases: velero from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | Backup and migrate Kubernetes applications and their persistent volumes | https://velero.io
- zypper - velero - 1.18.1-1.1: normalized package name match | openSUSE Tumbleweed package metadata: velero from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Backup program with deduplication and encryption | https://velero.io
- zypper - velero-bash-completion - 1.18.1-1.1: normalized package name match | openSUSE Tumbleweed package metadata: velero-bash-completion from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Bash Completion for velero | https://velero.io
- zypper - velero-fish-completion - 1.18.1-1.1: normalized package name match | openSUSE Tumbleweed package metadata: velero-fish-completion from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Fish Completion for velero | https://velero.io
- zypper - velero-zsh-completion - 1.18.1-1.1: normalized package name match | openSUSE Tumbleweed package metadata: velero-zsh-completion from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Zsh Completion for velero | https://velero.io
- Chocolatey - velero: normalized package name match | Chocolatey community package catalog: velero from http://community.chocolatey.org/api/v2/Packages?$filter=IsLatestVersion&$select=Id&$top=1000&$skiptoken='9.8224','qfinderpro'
- Scoop - main/velero: normalized package name match | Scoop official bucket manifest trees: bucket/velero.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1


## Related links

- [Cloud CLI packages](https://www.automicvault.com/pkg/cloud-clis/) - Belongs to a cloud or infrastructure command family.
- [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Archive and compression packages](https://www.automicvault.com/pkg/archive-compression-tools/) - Matched archive or compression metadata.
- [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew.
- [ingress2gateway](https://www.automicvault.com/pkg/brew/ingress2gateway/) - Shares av.db curated category or tags: cli, cloud-infrastructure, kubernetes, migration.
- [cdk8s](https://www.automicvault.com/pkg/brew/cdk8s/) - Shares av.db curated category or tags: cli, cloud-infrastructure, kubernetes.
- [chaoskube](https://www.automicvault.com/pkg/brew/chaoskube/) - Shares av.db curated category or tags: cli, cloud-infrastructure, kubernetes.
- [click](https://www.automicvault.com/pkg/brew/click/) - Shares av.db curated category or tags: cli, cloud-infrastructure, kubernetes.
- [cloud-provider-kind](https://www.automicvault.com/pkg/brew/cloud-provider-kind/) - Shares av.db curated category or tags: cli, cloud-infrastructure, kubernetes.
- [clusterawsadm](https://www.automicvault.com/pkg/brew/clusterawsadm/) - Shares av.db curated category or tags: cli, cloud-infrastructure, kubernetes.
- [clusterctl](https://www.automicvault.com/pkg/brew/clusterctl/) - Shares av.db curated category or tags: cli, cloud-infrastructure, kubernetes.
- [cozyhr](https://www.automicvault.com/pkg/brew/cozyhr/) - Shares av.db curated category or tags: cli, cloud-infrastructure, kubernetes.
- [gwctl](https://www.automicvault.com/pkg/brew/gwctl/) - Local package facts share a topical domain. Shared terms: cli, cloud, cloud-infrastructure, infrastructure, kubernetes.
- [kn](https://www.automicvault.com/pkg/brew/kn/) - Local package facts share a topical domain. Shared terms: cli, cloud, cloud-infrastructure, infrastructure, kubernetes.

## Combined YAML source

View the package source record on GitHub. [combined/velero.yml](https://github.com/automic-vault/db/blob/main/combined/velero.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
