Fleetmesh Documentation ======================= .. image:: _static/logo-fleetmesh.svg :align: center :alt: Fleetmesh Logo :width: 420px \ Fleetmesh is a zero-trust peer-to-peer mesh built on Nostr. Every node has its own keys and a signed descriptor, talks to the world through Nostr relays, answers to an operator key, and carries end-to-end encrypted mail for the nodes and browser leaves it mediates. These are the docs for |release|. Some of what the reference pages describe - other transports such as Iroh and FIPS, compute, the bridges - is in the code but experimental: off unless a config switches it on, and not supported in the alpha. :doc:`experimental` lists it all, and each page about one of them says so at the top. New here? :doc:`get-started/index` installs the tools and walks through your first fleet and a browser leaf app, each in a few minutes on one machine. System Architecture ------------------- The Fleetmesh ecosystem comprises a suite of interoperable software offerings, libraries, and canonical schema definitions: .. list-table:: :widths: 25 75 :header-rows: 1 * - Software / Package - Description * - :doc:`fleetmesh_core ` - The normative, cross-platform reference library providing cryptographic primitives, DID/identity handling, wire encoding, accounting, capacity pricing, and conformance vectors. * - :doc:`node (meshnode) ` - The high-performance host daemon implementing the 6 architectural planes, 29 decoupled compartments, transport ladder (WebSocket; Iroh QUIC and FIPS experimental), and pluggable sidecars. * - :doc:`meshctl CLI ` - Declarative fleet management CLI written in Rust. Provides non-destructive hot-reconciliation (``apply``), manifest diffing, multi-target compilation (k8s, quadlet, systemd, compose), fleet observation (``watch``), and an independent Rust conformance engine. * - :doc:`fleetmesh-strfry ` - High-throughput relay bridge interfacing nodes with the C++/LMDB strfry Nostr relay. Supports in-process compartment operation, write-policy filtering, bilateral grant enforcement, and bulk JSONL data piping. * - :doc:`fleetmesh_schema ` - Canonical machine-readable schemas, event kind registries (11801–31803), DIDComm wire definitions, Kubernetes-style CRD manifests, JSON Schema Draft 2020-12 specifications, and the authoritative protocol digest. * - :doc:`Specifications & Architecture ` - Detailed design whitepapers covering compartment boundaries, economic models, transport fallback mechanisms, storage engines, and pluggable protocols. Documentation Contents ---------------------- .. toctree:: :maxdepth: 1 :caption: Get started get-started/index experimental .. toctree:: :maxdepth: 2 :caption: Core Protocol Library :numbered: core/index core/crypto core/identity core/peering core/accounting core/storage core/services core/wire core/conformance .. toctree:: :maxdepth: 2 :caption: Meshnode Host Daemon :numbered: meshnode/index meshnode/app meshnode/planes/index meshnode/transport meshnode/storage meshnode/protocols meshnode/nostr meshnode/commands meshnode/compartments meshnode/config meshnode/channels_metrics meshnode/keystore meshnode/interfaces meshnode/cli .. toctree:: :maxdepth: 2 :caption: meshctl CLI & Orchestration :numbered: meshctl/index meshctl/cli meshctl/reconciliation meshctl/deployment meshctl/watching meshctl/conform .. toctree:: :maxdepth: 2 :caption: Strfry Relay Bridge :numbered: strfry/index strfry/modes strfry/policy strfry/pipe strfry/api .. toctree:: :maxdepth: 2 :caption: Canonical Schemas & Protocols :numbered: schema/index schema/kinds schema/messages schema/manifests schema/digest schema/json_schemas schema/api .. toctree:: :maxdepth: 2 :caption: Architecture & Specs :numbered: architecture/index Indices and Tables ------------------ * :ref:`genindex` * :ref:`modindex` * :ref:`search`