Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Running Zebra

You can run Zebra as a backend for [lightwalletd][lwd], or a [mining][mining] pool.

[lwd]: https://zebra.zfnd.org/user/lightwalletd.html, [mining]: https://zebra.zfnd.org/user/mining.html.

For Kubernetes and load balancer integrations, Zebra provides simple HTTP health endpoints.

Optional Configs & Features

Zebra supports a variety of optional features which you can enable and configure manually.

Initializing Configuration File

The command below generates a zebrad.toml config file at the default location for config files on GNU/Linux. The locations for other operating systems are documented here.

zebrad generate -o ~/.config/zebrad.toml

The generated config file contains Zebra's default options, which take place if no config is present. The contents of the config file is a TOML encoding of the internal config structure. All config options are documented here.

Configuring Progress Bars

Configure tracing.progress_bar in your zebrad.toml to show key metrics in the terminal using progress bars. When progress bars are active, Zebra automatically sends logs to a file. Note that there is a known issue where progress bar estimates become extremely large. In future releases, the progress_bar = "summary" config will show a few key metrics, and the detailed config will show all available metrics. Please let us know which metrics are important to you!

Custom Build Features

You can build Zebra with additional Cargo features:

You can combine multiple features by listing them as parameters of the --features flag:

cargo install --features="<feature1> <feature2> ..." ...

The full list of all features is in the API documentation. Some debugging and monitoring features are disabled in release builds to increase performance.

Return Codes

  • 0: Application exited successfully
  • 1: Application exited unsuccessfully
  • 2: Application crashed
  • zebrad may also return platform-dependent codes.