Logan
1a9c92b6db
Includes edge-node (FastAPI/MQTT/Discord voice), op25-container (SDR decoder), and icecast (audio streaming).
2.5 KiB
2.5 KiB
DRB Client (Edge Node)
The client-side stack for the Discord Radio Bot system. Runs on the SDR hardware machine. Decodes radio with OP25, streams audio via Icecast, and connects to the C2 server over MQTT.
Services
| Service | Description |
|---|---|
op25 |
OP25 SDR decoder — tunes to radio systems and streams decoded audio |
icecast |
Audio streaming server — receives audio from OP25 and serves it over HTTP |
edge-node |
FastAPI node agent — bridges OP25 metadata, MQTT C2 commands, and Discord voice |
All services run with network_mode: host so they share the host network and can reach each other on localhost.
Prerequisites
- Docker + Docker Compose
- An RTL-SDR or compatible SDR dongle connected to the host
- Network access to the DRB server (C2 server)
Setup
# 1. Copy env file
cp .env.example .env
# 2. Fill in .env
# At minimum: NODE_ID, MQTT_BROKER (IP of the C2 server)
# 3. Build and start
docker compose build
docker compose up -d
Environment Variables (.env)
| Variable | Description | Default |
|---|---|---|
NODE_ID |
Unique identifier for this node | required |
NODE_NAME |
Human-readable name shown in the UI | My Radio Node |
NODE_LAT / NODE_LON |
GPS coordinates for the map view | 0.0 |
MQTT_BROKER |
IP or hostname of the C2 server | localhost |
MQTT_PORT |
MQTT broker port | 1883 |
C2_URL |
C2 server HTTP API URL (for audio uploads) | — |
ICECAST_HOST |
Icecast hostname (leave as localhost) | localhost |
ICECAST_PORT |
Icecast port | 8000 |
ICECAST_MOUNT |
Icecast mount point | /radio |
Node Provisioning Flow
- Start the client stack — the edge node connects to MQTT and sends a checkin
- The C2 server registers the node as pending approval
- An admin approves the node in the web UI
- The admin assigns a radio system to the node via the UI
- The C2 server pushes the system config over MQTT
- The edge node writes the config and starts OP25
- OP25 begins decoding and streaming audio to Icecast
After a restart, OP25 resumes automatically if the node was already configured.
Discord Voice
When a user runs /join in Discord (or clicks "Join Discord" in the UI), the C2 server sends a discord_join command to this node over MQTT. The edge node spins up a Discord bot using a token from the server's token pool and connects it to the requested voice channel, streaming live audio from Icecast.
Logs
docker compose logs -f edge-node
docker compose logs -f op25
docker compose logs -f icecast