zrepl/docs/content/_index.md

+++ title = "zrepl - ZFS replication" +++

zrepl - ZFS replication

{{% notice info %}} zrepl as well as this documentation is still under active development. Use & test at your own risk ;) {{% /notice %}}

Getting started

The [5 minute tutorial setup]({{< relref "tutorial/_index.md" >}}) gives you a first impression.

Main Features

• Filesystem Replication
  • Local & Remote
  • Pull mode
  • Push mode
  • Access control checks when pulling datasets
  • [Flexible mapping]({{< ref "configuration/map_filter_syntax.md" >}}) rules
  • Bookmarks support
  • Feature-negotiation for
    • Resumable send & receive
    • Compressed send & receive
    • Raw encrypted send & receive (as soon as it is available)
• Automatic snapshot creation
  • Ensure fixed time interval between snapshots
• Automatic snapshot pruning
  • [Retention Grid]({{< ref "configuration/prune.md#retention-grid" >}})
• Maintainable implementation in Go
  • Cross platform
  • Type safe & testable code
• Flexible, detailed & structured [logging]({{< ref "configuration/logging.md" >}})

Contributing

zrepl is usable but nowhere near a stable release right now - we are happy about contributors!

• Explore the codebase
  • These docs live in the docs/ subdirectory
• Document any non-obvious / confusing / plain broken behavior you encounter when setting up zrepl for the first time
• Check the Issues and Projects sections for things to do

{{% panel header=" Getting your code merged"%}} The GitHub repository is where all development happens. Open your issue / PR there. {{% /panel %}}