Overview

This section introduces barrel_p2p: what it is, why it exists, and how to start using it. Read it in order if you are new to the project.

In this section

• What is barrel_p2p? — the project in one page, with the architecture diagram and the load-bearing ideas.
• Benefits and trade-offs — why pick barrel_p2p, and what you give up by doing so.
• Introduction — a longer narrative that walks through every layer in plain language.
• Getting started — install, configure, and bring up a two-node cluster.

After the overview

Once you have a cluster running:

• Core concepts explain each subsystem (membership, registry, gossip, dist channel, authentication, streams, migration, hybrid logical clocks) on its own page.
• Tutorials walk through building a real application end to end.
• How-to guides are task-focused recipes for operating a cluster (production, observability, troubleshooting, rotation, relays, testing).
• Reference is the API surface, the full configuration list, the architecture deep dive, and the comparison with Partisan.