Everything in order: flash Raspberry Pi OS onto the card, install Airwave Scan with one command, then pair your iPhone by scanning a QR code. Plan on about half an hour, most of it waiting.
Download Raspberry Pi Imager from raspberrypi.com/software, put the SD card in your computer and open Imager. It walks you through a tab at a time; choose Next after each:
Next comes the Customisation tab. Fill it in rather than skipping it, so the Pi joins your network and accepts logins on first boot:
airwave — you'll reach the Pi as airwave.localThen write the card. Imager erases it, writes the OS and checks it, which takes a few minutes. (Older versions of Imager keep the same settings behind Edit settings, offered just before writing.)
Put the card in the Pi, plug in your dongle (or the powered hub with your dongles), connect the antenna, then plug in the power. Give the first boot two or three minutes: it expands the file system and joins your Wi-Fi.
On your computer, open a terminal (Terminal on a Mac, PowerShell on Windows) and log in. Replace you with the username you chose:
ssh you@airwave.localType yes to trust the Pi the first time, then your password. Your prompt changes to you@airwave once you're in.
airwave.local? Look up the Pi's IP address in your router's list of connected devices and use that instead, for example ssh you@192.168.1.50.Bring the fresh image up to date, then restart:
sudo apt update && sudo apt full-upgrade -y
sudo rebootWait about a minute, then log in again with the same ssh command.
One command downloads Airwave Scan and installs it with everything it depends on:
curl -fsSL https://cdn.airwavescan.com/edge/bootstrap.sh | sudo bashIt takes a few minutes. Along the way it:
rtl-sdr, SoapySDR and rtl_433 — and Python.rfscanner account with USB access to the dongles./opt/rfscanner, with its settings in /etc/rfscanner/edge.env.rfscanner-edge service now and at every boot, and caps its logs so they can't fill the card.rfscanner-pair command you'll use to pair your phone.Check that it's running:
systemctl status rfscanner-edgeLook for active (running) in green, then press q.
The core install listens, scans and pairs. The decoders that turn signals into aircraft on the map, ship positions, packets and weak-signal spots are built from source by a second script. Download the full package and run it:
curl -fsSL https://cdn.airwavescan.com/edge/rfscanner-edge.tar.gz | tar -xz
sudo bash edge/install/setup-pi.shThe default set is ADS-B (aircraft on the map), ACARS and VDL2 (aircraft messages), AIS (ships), APRS, SAME weather alerts, FT8 and WSPR (HF propagation), and utility meters. The builds take a while, so let it run. It finishes by checking every piece it installed.
# everything, including DMR digital voice and JS8:
sudo bash edge/install/setup-pi.sh --all
# or just the ones you want:
sudo bash edge/install/setup-pi.sh --with adsb,ft8
# re-run the checks any time:
sudo bash edge/install/setup-pi.sh verifyA quick self-test proves the dongle, the antenna and the audio path work, with no phone needed. It tunes NOAA Weather Radio for a few seconds and prints PASS or FAIL with the signal level:
sudo systemctl stop rfscanner-edge
sudo -u rfscanner /opt/rfscanner/venv/bin/python -m rfscanner_edge.server --selftest --wav /tmp/wx.wav
sudo systemctl start rfscanner-edgeOutside the US, test with a station you can hear instead: add --freq 98100000 --mode wfm (an FM broadcast station, in Hz) to the middle command. A FAIL says what to check.
Airwave Scan for iPhone is in private beta on TestFlight. Request access, then install TestFlight from the App Store and open your invite on the iPhone to install Airwave Scan.
Pairing gives your phone the Pi's key and the Pi your phone's, so only your phone can connect. The phone and the Pi need to be on the same network.
sudo rfscanner-pairsudo rfscanner-pair again for a fresh one.The rest happens in the app:
In the car. With no home Wi-Fi, the Pi can make its own Wi-Fi network for your phone to join. Run these from your home directory, where step 5 put the edge folder, over Ethernet or a keyboard and screen, because turning Wi-Fi into a hotspot drops an SSH session that's using Wi-Fi:
sudo bash edge/install/car-ap.sh install # asks for a Wi-Fi password
sudo bash edge/install/car-ap.sh up # try it now
sudo bash edge/install/car-ap.sh enable-boot # keep it on after restartsJoin the Wi-Fi network named RFScanner from your iPhone and pair once more. Back home, sudo bash edge/install/car-ap.sh disable-boot returns the Pi to your home Wi-Fi.
SDRplay radios. An RSP needs SDRplay's own driver. This script installs it, along with the bridge Airwave Scan uses, and asks you to accept SDRplay's license:
sudo bash edge/install/setup-sdrplay.shUpdating. Run the install command from step 4 again. Your settings and paired phones are kept.
Uninstalling. This keeps the Pi's identity and paired phones; add --purge to remove everything:
sudo bash edge/install/uninstall.shairwave.local.journalctl -u rfscanner-edge -n 50. After fixing the cause, start it with sudo systemctl start rfscanner-edge.systemctl status rfscanner-edge on the Pi, and if in doubt pair again with sudo rfscanner-pair.lsusb should list a Realtek RTL2838 device. If it doesn't, unplug the dongle and plug it back in. Use the official power supply: low voltage makes dongles drop off the USB bus.These steps are for Raspberry Pi OS (64-bit), Bookworm or newer, and were tested on the current Debian 13 (Trixie) release.