2.4 KiB
Zebra with Docker
The easiest way to run Zebra is using Docker.
We've embraced Docker in Zebra for most of the solution lifecycle, from development environments to CI (in our pipelines), and deployment to end users.
Quick usage
You can deploy Zebra for a daily use with the images available in Docker Hub or build it locally for testing
Ready to use image
docker run --detach zfnd/zebra:1.0.0-rc.4
Build it locally
git clone --depth 1 --branch v1.0.0-rc.4 https://github.com/ZcashFoundation/zebra.git
docker build --file docker/Dockerfile --target runtime --tag zebra:local
docker run --detach zebra:local
Alternatives
See the Zebra build instructions.
Images
The Zebra team builds multiple images with a single Dockerfile using multistage builds. The test stage adds needed features and tools (like lightwalletd) and the runtime stage just adds the zebrad binary and required zcash-params for Zebra to run correctly.
As a result the Zebra team builds four images:
- zcash-params: built Zcash network parameters
- lightwalletd: a backend service that provides an interface to the Zcash blockchain
- zebrad-test: a zebrad binary with lightwalletd included, and test suites enabled
- zebra: a streamlined version with the zebrad binary and just the needed features needed to run as-is
Registries
The images built by the Zebra team are all publicly hosted. Old image versions meant to be used by our CI pipeline (zebrad-test, lighwalletd) might be deleted on a scheduled basis.
We use Docker Hub for end-user images and Google Artifact Registry to build external tools and test images