Fathom support
Fathom: Network & VLAN Map · Mac (macOS 14 or later), iPhone and iPad (iOS 17 or later)
Fathom shows your network the way it really is — every port, VLAN and device — and tells you what to tighten up. Here is how to connect it, and what to check when something doesn't work.
Connecting a MikroTik router or switch
- Make sure the Mac, iPhone or iPad can reach the router: the same network, or a VPN into it.
- On the router, turn on the API: in WinBox or WebFig open IP → Services and enable api (port 8728). For an encrypted connection use api-ssl (port 8729), which needs a certificate assigned on the router.
- In Fathom, choose Add your router, pick RouterOS API, and enter the router's address, the port, and a username and password. A read-only user is enough to see everything; applying changes from the Lab needs a user that can write.
Connecting another switch (SNMP)
- Turn on SNMP v2c on the switch with a read-only community name, listening on UDP port 161.
- In Fathom, choose SNMP, and enter the switch's address and the community name.
SNMP is read-only. It shows ports, their labels and link state, which device is on which port, addresses and neighbouring switches. Some devices don't publish their VLANs over standard SNMP — MikroTik is one — so for MikroTik gear use the RouterOS API instead.
If it won't connect
- Timed out, or connection refused. Check that the device can reach the router's address, the api service is enabled, its Available From list is empty or includes your address, and no firewall rule blocks the port.
- Invalid user name or password. Check the username and password, and that the user's group allows API access.
- Can't connect with TLS. api-ssl needs a certificate assigned to it on the router. Over your own network or a VPN, plain api (8728) is fine.
- Nothing on iPhone or iPad. Settings → Privacy & Security → Local Network → allow Fathom.
- SNMP shows no VLANs. The device doesn't publish VLANs over standard SNMP. Use the RouterOS API for MikroTik.
- "Connection lost". Fathom keeps the last map on screen and reconnects by itself when the router answers again. If the router answers but refuses the login, it stops and says so instead of retrying.
Is it safe to point at a live network?
Fathom only reads until you ask it to change something. Changes happen in the Lab: you see the exact commands first, you can try them on a spare lab router, and when you apply to the real one, Fathom saves a backup and a configuration export on the router before it sends anything. It stops at the first error.
Contact
Email info@corecapitalinvestments.net with your device (Mac, iPhone or iPad), the router or switch model, and what you see. We usually reply within two business days.
Fathom collects no data — see the Fathom privacy policy.