WISPMapbeta

Docs / Adding devices

Other makes over SNMP

Ubiquiti and Cambium radios, UPSs, and any switch or router with SNMP: what WISPMap reads, and how to add one.

Updated 10 November 2026

Devices that don't run RouterOS can be read over SNMP, with SNMP v2c or v3. This needs collector 0.8 or newer.

What WISPMap reads

Device What you get
Any device with SNMP Uptime, name, interfaces with their state and traffic, CPU where the device reports it
Ubiquiti airMAX (airOS 6 and 8) The radio, and every station's signal, SNR, CCQ, rates and connected time
Ubiquiti airFiber (AF5, AF11, AF24…), LTU, AF60 Signal at both ends of the link, its capacity
Cambium ePMP The radio, and every subscriber's signal and SNR in both directions, and its quality
UPSs: APC, CyberPower, or any UPS with the standard UPS-MIB On battery or mains, charge, the runtime it reports, battery voltage, load, and whether the battery needs replacing

WISPMap works out which kind of device it is by itself: you only choose SNMP as the kind.

Radios get the same treatment as MikroTik radios: the wireless card on their page, the weaker signal and low SNR alerts, and customers matched to their access point by their radio's MAC. A UPS can be a site's power device: see UPSs over SNMP.

1. Turn on SNMP on the device

Every make does this in its own place: see Ubiquiti, Cambium ePMP and UPSs. Read-only access is all WISPMap needs. Allow it from the collector's address only, if the device lets you.

2. Put the credentials in the collector's .env

For SNMP v2c:

SNMP_COMMUNITY='<the read-only community>'

or, better, SNMP v3:

SNMP_V3_USER=wispmap
SNMP_V3_AUTH_PROTO=SHA
SNMP_V3_AUTH_KEY='<auth password>'
SNMP_V3_PRIV_PROTO=AES
SNMP_V3_PRIV_KEY='<privacy password>'

then restart the collector: cd wispmap-collector && docker compose up -d. Different credentials for different devices? Use a credential profile.

3. Add the device in WISPMap

In Admin → Devices, choose Add device, and set Kind to SNMP (other makes). The port becomes 161. Set the credential profile if it isn't default.

4. Check it

Within a minute the device's page shows SNMP ok, with the make, model and firmware the device reports. If it says something else:

Says Means
timeout No SNMP answer: SNMP is off, the device doesn't allow the collector's address, or the community is wrong (with v2c a wrong community gets no answer at all).
auth_failed SNMP v3: the user, a key or a protocol doesn't match the device's.
error, with "no SNMP credentials for profile" The device's credential profile isn't in the collector's .env. The message names the setting to add.

Not on the list?

Any device with SNMP gets uptime and traffic. If you have gear you'd like read in more depth, the collector can record what a device answers, with names, addresses and serial numbers replaced, so we can add it:

cd wispmap-collector
docker compose run --rm collector wispmap-collector --capture-snmp 10.0.0.30 > device.snmprec

Send us the file.