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.

See it in action

Quick install

Debian / Ubuntu / Raspberry Pi OS — auto-detects your architecture:

ARCH=$(dpkg --print-architecture)
curl -fsSL \
  "https://github.com/Mesh-America/supply-drop-bbs/releases/latest/download/supply-drop-bbs_${ARCH}.deb" \
  -o supply-drop-bbs.deb
sudo dpkg -i supply-drop-bbs.deb
sudo supply-drop-bbs setup
sudo systemctl start supply-drop-bbs

Have these on hand before running setup:

Radio type — USB companion device or Pi HAT
HAT model — if using a HAT (ZebraHat, Waveshare, PiMesh, etc.)
Region / frequency — US (910.525 MHz), EU (869.618 MHz), or your local frequency

Full installation guide · Configuration reference