Documentation

Start here

Perch is a command center for your Meshtastic mesh; Coop is the engine that feeds it. These pages cover everything from "which radio do I buy" to the raw REST API. Both are free to use and run entirely on your own machine — the docs assume nothing but curiosity.

Quickstart

Radio → USB → dashboard in about 10 minutes. Start here.

Hardware guide

Boards that work great, cables that lie, antennas that matter.

Channels & keys

Joining a community mesh, PSKs, QR import/export, regions.

The capture database

Where history lives, retention, backups, querying with SQL.

MQTT & community meshes

Hearing the whole city when your radio only hears the block.

Coop API reference

Every REST endpoint and SSE event, with curl examples.

Mesh services

Traceroute, position requests, neighbor topology, waypoints.

Multi-engine setups

Several radios, remote Coops over Tailscale, observers.

Architecture

Why it's two programs and why your capture survives anything.

Troubleshooting

Serial ports, handshakes, and other real-world friction.

Prefer to poke first and read later? The live demo is the whole app running on a captured snapshot of the St. Louis mesh — no radio needed.