Skip to content

Releases: cubeos-app/meshsat

Release list

v0.1.0

Choose a tag to compare

@papadopouloskyriakos papadopouloskyriakos released this 04 Mar 03:45

MeshSat v0.1.0 — First Public Release

MeshSat bridges Meshtastic mesh radios and Iridium SBD satellite modems into a single message bus. Runs as a standalone Docker container on any Linux machine with USB-connected devices.

Quick Start

docker run -d --name meshsat --privileged --network host \
  -e MESHSAT_MODE=direct -e MESHSAT_PORT=6050 -e MESHSAT_DB_PATH=/data/meshsat.db \
  -v meshsat-data:/data -v /dev:/dev -v /sys:/sys:ro \
  --restart unless-stopped ghcr.io/cubeos-app/meshsat:latest

Open http://<your-ip>:6050 for the dashboard.

Highlights

  • Direct serial transport — talks to USB devices without middleware
  • Auto-detection of Meshtastic and Iridium devices via sysfs VID:PID
  • Configurable bridge rules (mesh-to-satellite, satellite-to-mesh, or both)
  • Built-in web dashboard for monitoring and sending messages
  • REST API + Server-Sent Events for integration
  • SQLite persistence for messages, telemetry, and GPS positions
  • Pass-aware smart scheduler for Iridium satellite windows
  • Dead letter queue with priority and automatic retry
  • Multi-arch Docker image (ARM64 + x86_64)

Tested Hardware

Device Role Interface
Lilygo T-Echo (nRF52840) Meshtastic radio /dev/ttyACM0
Iridium 9600 Family SBD Transceiver Satellite modem /dev/ttyUSB0
Raspberry Pi 5 Host ARM64

Docker Image

ghcr.io/cubeos-app/meshsat:v0.1.0
ghcr.io/cubeos-app/meshsat:latest

See README for full setup guide, configuration reference, and API documentation.