Reference
Troubleshooting
Quick fixes for radios, silent audio, blank windows, drops, tokens, and recordings.
On this page
First step: click Check hardware on an empty Device node, or run sdrmm --doctor.
Page does not open or token fails
- Check
SDRmm readylog port; desktop app is loopback-only (sdrmm --bind 0.0.0.0:8080for LAN). - Non-loopback binds serve
https://(accept self-signed warning once). Behind a reverse proxy, mount at/(no path prefix). Host not allowed: open servers restrictHostnames; connect by IP or set a token. API callers sendAuthorization: Bearer <token>.
Blank window or missing waterfall
Disable hardware WebGL2 if a graphics driver breaks rendering:
sdrmm-app --disable-gpu # Linux
open -a SDRmm --args --disable-gpu # macOS
Fallback: run the portable server on 127.0.0.1:8080 in a regular browser.
A radio is missing
- Verify OS detection (
lsusb/ System Information / Device Manager) and close other SDR apps. - Run
sdrmm --doctorfor missing libraries or Linux udev/plugdevpermissions (Docker:group_add). - SoapySDR: run
SoapySDRUtil --findand match core 0.8/0.9. - SDRplay: install API 3.15+ and run
sdrplay_apiService. Aaronia: close RTSA-Suite PRO; runsetup_udev.shon Linux. - Stays disconnected: press Open radio, Start (if stopped), or Forget radio to bind a different unit.
Spectrum works, but audio is silent
- Wire channel
audio→ Speaker, press Play, and click Resume audio if shown. - Drag squelch far left, confirm the channel sits inside the Device span, and check Speaker Out / OS mute.
- Audio stuttering on plain
http://LAN fixes itself overhttps://orlocalhost.
Decoder shows nothing, drops, or missing recordings
- No decodes: verify signal in Scope, wiring (
Decoder log/Readout/Map), gain/clipping, and Catalog verification status. - Drops: lower sample rate, close unused views, use
--release, wire Ethernet for network radios, put 20 MS/s HackRF on its own USB bus. On Linux, add@audio - nice -10to/etc/security/limits.confand joinaudio. - Missing recordings: check
--recordings-dirwrite permissions (Docker/data/recordings), press Stop to finalize metadata, and verify.sigmf-meta+.sigmf-datapairs.