Map

Enabling the map

The map is off by default. Turn it on from Settings > Map, where you can also add a MaxMind GeoIP license key and set the thresholds used to flag links as breached. If the map is disabled, the Map page shows a link straight to that settings section.

Basemap tiles

The underlying world map (streets, borders, place names) is served by CARTO and rendered as smooth, zoomable vector tiles, with separate dark and light styles that switch automatically with your chosen Linknesis theme.

An optional Carto API key can be set in Settings > Map. The map works without one, but setting a key is recommended as good practice in case CARTO tightens access to its basemaps in the future.

Probe markers

Each Probe appears as a labeled marker colored by its current status:

• Green - connected
• Gray - disconnected
• Yellow - pending

Click a marker to see its public IP, location, ISP, ASN, and connection details, with a link through to the Probe's own detail page. The map refreshes automatically about once a second, so status changes and new tests appear without reloading the page.

Use the crosshair button next to the zoom controls to re-center and re-zoom the map to fit every positioned Probe - handy after you've panned or zoomed around manually.

Positioning Probes

Probes can be positioned on the map three ways:

• Automatically on connect - turn on Auto positioning of new Probes in Settings > Map (off by default) and every new Probe is geolocated via MaxMind GeoIP the moment it first connects. Probes that were already connected before you turn this on are not retroactively positioned.
• Automatically in bulk - open Settings > Map > Auto positioning to geolocate any number of existing Probes on demand, with filters by OS and current location.
• Manually - a Probe that couldn't be geolocated shows up in the Unpositioned Probes list in the sidebar; click Place next to it, then click anywhere on the map to drop it there.

Any Probe marker, whether it was placed automatically or manually, can be dragged to a new spot at any time; the new position is saved as soon as you drop it. A manually-placed position is never overwritten or expired by GeoIP.

Positions obtained via GeoIP (automatic or bulk) are cached and re-checked periodically - see GeoIP cache expiration in Settings > Map.

Test links

A line is drawn between two Probes for each test running (or recently run) between them. The line and its label are colored blue for a normal link, or red when the test has breached a configured threshold. A label at the midpoint of the line shows the test type and a live summary (throughput and loss for iperf3, latency and loss for MTR) - click it to open the full test results page.

When more than one test is running at the same time between the same pair of Probes, their labels stack vertically instead of hiding one another.

External target tests

Tests aimed at a target outside your Probe fleet (a public IP or hostname rather than another Probe) are shown as a dashed purple line from the source Probe to a globe icon, with the same clickable metrics label as Probe-to-Probe links.

Legend

The sidebar includes a legend for marker and line colors, plus the list of any Probes still waiting to be positioned.