SpeedBird-VM
The always-on SPEEDBIRD station. It installs as a systemd service on a Linux server or virtual machine, serves the web UI over HTTPS, and drives LAN-connected radios.
Why a VM?#
A server or VM stays on. Modems you start are saved and come back after restarts and reboots, so the station keeps listening, relaying mesh traffic and answering Winlink P2P while you are away. Many radios can run at once, each with its own SSID.
The SBP modem needs a radio with an RX audio stream. On a VM that in practice means a LAN-connected rig, such as an Icom over the network (host, port 50001, user, password).
Install#
One line does it all: it detects your system, downloads the latest release, checks its SHA-256 and installs it.
$ curl -fsSL https://speedbird.io/install.sh | sudo bashOr install a downloaded package yourself:
# .deb package
sudo apt install ./speedbird_<version>_all.deb
# or the .tar.gz bundle
tar xzf speedbird-<version>.tar.gz && cd speedbird-<version> && sudo ./install.sh
| install.sh option | .deb environment variable | Effect |
|---|---|---|
--without-pat |
SPEEDBIRD_INSTALL_PAT=0 |
Don't install the bundled Pat Winlink client |
--no-start |
SPEEDBIRD_NO_START=1 |
Install but don't start the service |
--offline-only |
SPEEDBIRD_OFFLINE_ONLY=1 |
Use bundled wheels only, never PyPI |
--skip-geodata |
SPEEDBIRD_SKIP_GEODATA=1 |
Skip geodata |
--prefix DIR, --force |
Install location; force reinstall |
What gets set up#
/opt/SPEEDBIRD/.venv, built from bundled wheels (offline for the listed Python versions and CPUs)- the
speedbirdsystem user and/var/lib/speedbirdfor state /etc/speedbird/speedbird.yaml, created only if absent. Setstation.callsign: nothing transmits asN0CALL.- a self-signed TLS certificate in
/etc/speedbird/tls speedbird.service(HTTPS on port 443), pluspat-speedbird.servicefor Winlink on127.0.0.1:8080
Warning: the web UI has no authentication yet. Keep it on a trusted network, or reach it through a VPN or SSH tunnel.
Run it#
systemctl status speedbird # status
journalctl -u speedbird -f # live logs
sudo apt remove speedbird # remove (purge also deletes /etc/speedbird; /var/lib/speedbird is kept)
Then open https://<host>/, add your radios on the Radios page, and follow the quick start to make your first SBP contact.
Also builds the Windows installer#
A SPEEDBIRD Linux node can build the Windows installer itself: Deploy → Build installers, or make windows. See building for Windows.