Supply Drop BBSA BBS for LoRa mesh networks, written in Rust

Works with MeshCore and Meshtastic out of the box. Runs on a Pi. Add other transports (APRS, Telnet, IRC, whatever) by writing a plugin.

Get Started

View on GitHub

📻

MeshCore and Meshtastic

Ships with bridges for MeshCore and Meshtastic LoRa networks. Tested on RAK WisBlock and Heltec hardware over serial and USB.

🔀

Run multiple transports at once

MeshCore radio, the CLI socket, the web admin, and any custom transport all run in the same process and share one user database and message store. APRS, Telnet, IRC, Matrix are all possible.

🥧

Simple to run

One binary, one TOML config file, one systemd unit. Intended to sit on a Pi and be ignored for months at a time.

⚡

Built in Rust

Fast startup, low memory, no GC pauses. Useful when you're running on a solar-charged Pi 3.

🔌

Plugin API

New transports and behaviors are Rust crates gated behind Cargo features. If you don't compile it in, it isn't there.

Quick start

curl -fsSL https://raw.githubusercontent.com/Mesh-America/supply-drop-bbs/main/install.sh | sudo bash

The script downloads a pre-built binary for your architecture, runs a setup wizard, and configures a systemd service. Takes under a minute on a Pi 4. Older hardware or unusual architectures fall back to building from source (5–15 minutes).

Before you run it, have these on hand:

Radio type: USB companion device or Pi HAT
HAT model (if using a HAT)
Your region/frequency

Full installation guide · Configuration reference