How good is the Wi-Fi
at your sites, really?
Each site gets a small Linux box, like a Raspberry Pi or a NanoPi. It connects to your Wi-Fi networks on a schedule, takes measurements along the way and scans what’s around. The dashboard shows you how things are going everywhere and lets you know when something’s off.
Connection tests
The probe joins the network like any other device and times association, 802.1X, DHCP and ping. It gets through captive portals with a login page on its own.
Throughput with iperf3
Upload and download for each SSID, plus a wired test. You also see how busy the channel was while the test ran.
Alerting
If an SSID goes down, logins get sluggish or a probe stops reporting, you get an e-mail or a Telegram message. Already using Zabbix? It can discover all probes as hosts automatically.
Spectrum & roaming
The scans show which networks use which channel, how strong they are and which AP a device could roam to.
See what went wrong
When a test fails, the probe keeps a capture: pcap, adapter events and the wpa_supplicant log. Open it straight in Wireshark.
OmniVista Cirrus
Optionally, the dashboard reads your APs from Cirrus: AP names for every BSSID, channel, utilization and transmit power. So you can tell whether a bad test was down to the radio side.
What about the passwords?
If you keep Wi-Fi credentials in one place, you have to look after them properly. Here’s how wlanmon does it.
Encrypted at rest
Wi-Fi passwords, 802.1X and portal logins, the SMTP password and the bot token are encrypted with libsodium as soon as you set a key. The key isn’t stored in the database, so a stolen dump or backup is useless on its own.
Encrypted in transit
The probes fetch their configuration over HTTPS and check the certificate, against your own CA if you like. The Docker stack already includes a TLS proxy.
Never shown again
Once a password is saved, it never shows up in a form again. The change log only notes that it was changed. Probe API keys are kept as hashes, nothing more.
Roles and sites
There are admins, users and viewers, and you can limit people to specific sites. The change log shows who changed what on devices, users and alerts.
Quick start
# 1. Start the dashboard with Docker (instructions in dashboard/README.md)
# 2. Add a device in the dashboard, note its device ID and API key
# 3. On the probe (the setup wizard then asks for everything):
git clone https://github.com/dgawin/wlanmon.git ~/wlanmon
cd ~/wlanmon/probe
sudo ./setup_wlanmon_probe.sh
Which hardware and Wi-Fi adapters work, and everything you can configure, is in the README.