Set up in about 15 minutes

1Create your account

Join the beta. In Admin → Organisation, check your time zone: alerts and maintenance windows use it.

2Add a collector

In Admin → Collectors, choose Add collector. The next page shows the collector's install command with its token in it. It's shown only once; if you lose it, issue a new token from the same page.

3Add a read-only user to every router

/user group add name=wispmon policy=read,api,test
/user add name=wispmon group=wispmon password="<a long random password>"

Use the same user and password on every router. The password only goes into the collector's settings, never into WISPMap.

4Start the collector

On the Linux machine, paste the command from the collector's page. It looks like this:

curl -fsSL https://wispmap.gigahost.co.za/collector/install.sh | sh -s -- <token>

It creates a wispmap-collector folder, asks for the router user's password, and starts the collector. Within a minute it shows online on the Collectors page. You can read the script first, or follow the manual steps in the collector's guide.

5Add your sites and devices

Add them by hand, or import spreadsheets (CSV) on the Admin → Sites and Devices pages: sites with a code, name and coordinates, then devices with their site code, name and management address. Check the map, then accept the link suggestions WISPMap finds from your routers' neighbour lists.

6Choose who gets alerts

The account owner gets email alerts from the start. In Admin → Notifications, add your team, set escalation, and plan maintenance windows for work you know about.

Stuck? Email wispmap@gigahost.co.za. The collector's own guide is on GitHub.