Fleetmesh Documentation

Fleetmesh Logo

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 0.5.0-dev.0. 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. Experimental features lists it all, and each page about one of them says so at the top.

New here? Get started 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:

Software / Package

Description

fleetmesh_core

The normative, cross-platform reference library providing cryptographic primitives, DID/identity handling, wire encoding, accounting, capacity pricing, and conformance vectors.

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.

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.

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.

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.

Specifications & Architecture

Detailed design whitepapers covering compartment boundaries, economic models, transport fallback mechanisms, storage engines, and pluggable protocols.

Documentation Contents

Core Protocol Library

Meshnode Host Daemon

Indices and Tables