SPEEDBIRD
Linux server / VM

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.

Coming soon Install notes
OSDebian 12+, Ubuntu 22.04+
CPUamd64, arm64
Web UIHTTPS :443
RadiosLAN rigs (Icom :50001)

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.

Linux · Raspberry Pi$ curl -fsSL https://speedbird.io/install.sh | sudo bash

Or 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#

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.