Zebra 6.2.0 - 2026-07-17
Zebra 6.2.0 adds an experimental migration path for exchanges and custodial services that still depend on the zcashd wallet and RPC interfaces. Zebra handles Zcash networking and consensus while a constrained zcashd sidecar retains the existing wallet, RPC, and ZMQ surface. Existing Zebra deployments are unchanged unless zcashd-compat mode is enabled.
Update Priority
| User Type | Priority | Reason |
|---|---|---|
Exchanges and custodial services evaluating migration from zcashd
| Medium | Adds the experimental zcashd-compat mode and migration tooling |
| General operators | Low | No required migration; existing node operation is unchanged |
Added
- New experimental zcashd-compat mode (
zebrad start --zcashd-compator the[zcashd_compat]configuration section). Zebra faces the Zcash network while a hard-lockedzcashdwallet runs as a sidecar connected only to the local Zebra node. Zebra can optionally download, supervise, and restart the SHA256-pinned sidecar. The release also includes an interactive installer with binary, Docker, and source-build modes, plus operational documentation and sync-check tooling (#10952). Credits to the Zakura authors for the major part of this implementation. - New Regtest-only
generatetoaddressRPC that mines blocks paying the coinbase to a caller-specified address. This allows test harnesses to fund multiple wallets from one Zebra node (#10952).
Fixed
- The installer's
docker-supervisedmode now configures the embedded sidecar source, so its generated command works with the published Zebra image (#11008).
How to Upgrade
Upgrading from Zebra 6.1.0 does not require a state migration or resync.
Docker
docker pull zfnd/zebra:6.2.0
# or update your compose file and:
docker compose pull && docker compose up -dBinary
- Stop
zebrad(systemctl stop zebradorCtrl+C) and wait for a clean shutdown. - Replace the binary with
zebrad-6.2.0-<arch>-unknown-linux-gnu.tar.gzfrom this release's assets, or runcargo binstall zebrad. - Start
zebradagain.
Source
git fetch && git checkout v6.2.0
cargo build --releaseSource builds require Rust 1.91 or newer, protoc, a C++ compiler, and libclang.
For installation and safety guidance, see zcashd-compat mode.
Compatibility
| Component | Supported |
|---|---|
| Operating systems | Linux (prebuilt binaries: x86_64 and aarch64, glibc 2.34+); macOS and Windows via source build
|
| Zcash protocol | All network upgrades through NU6.3 (Ironwood) |
| State database | Format 28.0.0; unchanged from Zebra 6.1.0, no resync required |
| Minimum Rust for source builds | 1.91 |
| zcashd compatibility | Experimental constrained-sidecar mode; review the safety guidance before production use |
| End of support | Block 3,537,960, approximately 105 days after release |
Contributors
Thank you to everyone who contributed to this release. We couldn't make Zebra without you:
@arya2 and @gustavovalverde.