Your first 15 minutes

This is the short version. Each step links to the full guide.

1. Check your organisation's time zone

In Admin → Organisation, check the time zone. Quiet hours, maintenance windows and the times in alert messages use it.

2. Add a collector

In Admin → Collectors, choose Add collector. Give it a name (for example pop-centurion) and the site where it runs. Root cause measures reachability from there.

The next page shows the install command, with the collector's token in it. The token is shown only once. If you lose it, issue a new one from the same page.

3. Add a read-only user to your routers

On every MikroTik router, in a terminal:

/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. More in Add a MikroTik router.

4. Start the collector

On a Linux machine with Docker inside your network, 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 asks for the router user and its password, and starts the collector. Within a minute the collector shows online on the Collectors page. See Install the collector for the requirements and for installing without the one-line script.

5. Add your sites and devices

Add them in Admin → Sites and Admin → Devices, by hand or from a spreadsheet (how to import):

• a site has a code, a name and its coordinates;
• a device has its site, a name and its management address.

Then open the map. WISPMap suggests links from your routers' neighbour lists: accept the right ones in Links, and add the rest by hand.

6. Choose who gets alerts

The account owner gets email alerts from the start. In Admin → Notifications, add your team or a shared mailbox, and decide what each one gets. See Who gets alerts.