# Install zrepl with Homebrew, apk, Nix

One-stop ZFS backup & replication solution. Version 0.7.0 via Homebrew; verified 2026-06-06.

## Install

```sh
sudo av install brew:zrepl
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install zrepl
```

  Evidence: local Homebrew formula metadata

### Linux

- apk (92%):

```sh
sudo apk add zrepl
```

  Evidence: Alpine Linux edge package indexes: zrepl from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz

- Nix (92%):

```sh
nix profile install nixpkgs#zrepl
```

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

## Package facts

- **Package key:** brew:zrepl
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/zrepl>
- **Version:** 0.7.0
- **Source summary:** One-stop ZFS backup & replication solution
- **Homepage:** <https://zrepl.github.io>
- **Repository:** <https://github.com/zrepl/zrepl>
- **Upstream docs:** <https://zrepl.github.io/>
- **License:** MIT
- **Source archive:** <https://github.com/zrepl/zrepl/archive/refs/tags/v0.7.0.tar.gz>
- **Last updated:** 2026-06-06T11:29:14Z
- **Generated:** 2026-07-08T18:08:21+00:00

## Executables

- zrepl (cli)
- zrepl (alias)

## Build dependencies

- go

## Install behavior

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

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 0.7.0
- Package-manager updated: 2026-06-06
- Local data: ok
- Upstream repository: https://github.com/zrepl/zrepl
- Upstream latest detected: v0.7.0 (current)
## Project history and usage

zrepl is a Go daemon and CLI for ZFS snapshot management, backup, and replication. It wraps ZFS send/receive workflows with configuration, scheduling, pruning, monitoring, status reporting, and transport handling.

### Project history

The public `zrepl/zrepl` repository was created in April 2017, and the documentation copyright identifies Christian Schwarz as the project author. The README and official site describe zrepl as a one-stop ZFS backup and replication solution, with user documentation published through Sphinx at zrepl.github.io.

zrepl developed around the hard parts of reliable ZFS replication rather than around a generic backup format. The documentation lists push and pull replication, TCP, TLS, and SSH transports, retries, resumable send/receive, ZFS holds, bookmarks, raw encrypted sends, properties/compressed/large-block sends, bandwidth limiting, periodic snapshots, pruning rules, structured logging, Prometheus metrics, and `zrepl status` progress reporting.

The changelog shows the project maturing through operational features: Prometheus metrics and receiver-side pruning behavior in early releases, automatic bookmark and hold management, configurable send/receive flags, bandwidth limiting, encrypted-send fixes, and later 0.6 and 0.7 maintenance releases.

### Adoption history

zrepl's audience is narrower than general backup tools because it requires ZFS, but it is significant inside that ecosystem. The official package documentation lists installation paths through GitHub release binaries, FreeBSD packages, Homebrew on macOS, Arch AUR, Fedora/RHEL/openSUSE RPM repositories, Debian/Ubuntu APT repositories, OmniOS, Void Linux, and source builds.

GitHub metadata showed more than 1,100 stars by mid-2026, consistent with an infrastructure tool used by ZFS administrators rather than casual desktop users. Its adoption is also reflected in docs that address distro maintainers, service files, platform tests that exercise ZFS, and package repository operations.

### How it is used

Typical use is to write a YAML configuration at `/etc/zrepl/zrepl.yml`, validate it with `zrepl configcheck`, run zrepl as a daemon, and use `zrepl status` or `zrepl signal wakeup JOBNAME` to monitor or trigger work. The quick-start docs cover continuous server backup, local snapshots with offline external-disk backup, and fan-out replication.

zrepl is most useful when native ZFS snapshots and `zfs send` are already the desired backup primitive, but the operator wants automated policy, pruning, transport, monitoring, and safety checks around them.

### Why package nerds care

zrepl is package-nerd significant because it is not another tar-like backup archive; it is packaging the operational discipline around ZFS itself. It turns a powerful but manual storage primitive into a service with config files, system packages, status UI, metrics, and reproducible deployment patterns.

It is also a good example of a small infrastructure package whose real value is coordination: snapshots, bookmarks, holds, pruning, send/receive flags, daemon supervision, and distro defaults all have to line up or backups quietly become unsafe.

### Timeline

- 2017-04-13: The public `zrepl/zrepl` repository is created.
- 2020-08-21: zrepl 0.3.0 is published on GitHub.
- 2021-04-18: zrepl 0.4.0 is published.
- 2022-01-09: zrepl 0.5.0 is published, with changelog entries including bandwidth limiting and send/receive-related fixes.
- 2022-11-01: zrepl 0.6.0 is published.
- 2026-02-15: zrepl 0.7.0 is published.

### Related projects

- OpenZFS is the underlying filesystem and send/receive substrate.
- syncoid and sanoid are adjacent ZFS snapshot and replication tools in the same administrator niche.
- Prometheus is relevant because zrepl exposes metrics for monitoring replication health.

### Sources

- <https://api.github.com/repos/zrepl/zrepl>
- <https://github.com/zrepl/zrepl>
- <https://zrepl.github.io/>
- <https://zrepl.github.io/changelog.html>
- <https://zrepl.github.io/installation/packages.html>
- <https://zrepl.github.io/quickstart.html>


## Security Notes

formula declares a Homebrew service. generalized runtime or code generation signal.

- **Geiger risk:** orange / medium
- formula declares a Homebrew service
- generalized runtime or code generation 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: /etc/zrepl/zrepl.yml, /usr/local/etc/zrepl/zrepl.yml
## Source Database Details

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

## Other Package-Manager Records

- Nix - zrepl: normalized package name match | nixpkgs package indexes: pkgs/by-name/zr/zrepl/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- apk - zrepl - 0.6.1-r21: normalized package name match | Alpine Linux edge package indexes: zrepl from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | one-stop, integrated solution for ZFS replication | https://zrepl.github.io/
- apk - zrepl-bash-completion - 0.6.1-r21: normalized package name match | Alpine Linux edge package indexes: zrepl-bash-completion from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | Bash completions for zrepl | https://zrepl.github.io/
- apk - zrepl-openrc - 0.6.1-r21: normalized package name match | Alpine Linux edge package indexes: zrepl-openrc from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | one-stop, integrated solution for ZFS replication (OpenRC init scripts) | https://zrepl.github.io/
- apk - zrepl-zsh-completion - 0.6.1-r21: normalized package name match | Alpine Linux edge package indexes: zrepl-zsh-completion from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | Zsh completions for zrepl | https://zrepl.github.io/


## Related links

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control 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.
- [snapraid](https://www.automicvault.com/pkg/brew/snapraid/) - Shares av.db curated category or tags: backup, cli, storage, system.
- [httm](https://www.automicvault.com/pkg/brew/httm/) - Shares av.db curated category or tags: backup, cli, snapshots, system, zfs.
- [znapzend](https://www.automicvault.com/pkg/brew/znapzend/) - Shares av.db curated category or tags: backup, cli, snapshots, system, zfs.
- [kopia](https://www.automicvault.com/pkg/brew/kopia/) - Shares av.db curated category or tags: backup, cli, snapshots, system.
- [restic](https://www.automicvault.com/pkg/brew/restic/) - Shares av.db curated category or tags: backup, cli, storage, system.
- [rsnapshot](https://www.automicvault.com/pkg/brew/rsnapshot/) - Shares av.db curated category or tags: backup, cli, snapshots, system.
- [afio](https://www.automicvault.com/pkg/brew/afio/) - Shares av.db curated category or tags: backup, cli, system.
- [bacula-fd](https://www.automicvault.com/pkg/brew/bacula-fd/) - Shares av.db curated category or tags: backup, cli, system.

## Combined YAML source

View the package source record on GitHub. [combined/zrepl.yml](https://github.com/automic-vault/db/blob/main/combined/zrepl.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
