Docs / Router Integration

Router Integration

Push and pull DHCP reservations with preflight checks, dry-run planning, and rollback options.
Quick access: In the desktop app, use File → Help & Guides to open this page directly.

Video Walkthrough

Watch the full router workflow: pull existing reservations, run preflight + dry-run, and push updates safely.

Supported Routers

NetMap Pro connects directly to UniFi, eero, Araknis, and TP-Link Omada. Go to the Router Config tab to access these features.

Router Push Pull Connection Method
UniFi Yes Yes UniFi Controller API (local network)
eero Yes No (push only) eero Cloud API
Araknis Yes Yes Direct web interface
TP-Link Omada No (pull/import only) Yes Omada Open API (client credentials)

Safe Push Workflow

Before any live router change, NetMap Pro can run an automated safety pass. Use this workflow every time:

  1. Run Preflight - catches duplicate reserved IPs and invalid push candidates before writing to the router.
  2. Review Dry-Run Plan - see exactly what NetMap Pro intends to change without applying it yet.
  3. Push Live - apply reservations only after preflight/dry-run results look correct.
  4. Undo if needed - use Undo Last Push for supported routers to roll back the most recent push.

UniFi

NetMap Pro connects to your UniFi Controller (or UniFi OS on UDM/UDM Pro) to push and pull DHCP reservations.

Setup

  1. Enter the controller URL — For UDM / UDM Pro / UDR, use https://192.168.1.1. For software controllers (running on a separate server), use https://controller-ip:8443.
  2. Enter credentials — Use a local admin account created on the controller itself. Cloud-only accounts (ui.com SSO) may not work with the local API. If you only have a cloud account, create a local admin under Settings → Admins on the controller.
  3. Select the site — If your controller manages multiple sites, select the one for this project.

Push Reservations

Click Push to UniFi to write all DHCP reservations from your project to the controller. Run preflight and dry-run first, then push live. Existing reservations for the same MAC are updated - no duplicates.

Pull Reservations

Click Pull from UniFi to import existing DHCP reservations from the controller into your project. This is useful when taking over a site that was already configured — pull the current reservations, then rename and reorganize in NetMap Pro.

How Pull handles conflicts: If a pulled MAC already exists in your project, the reserved IP is updated but your device name, type, and notes are not overwritten. New MACs create new device entries. No duplicates are ever created.
TLS verification: NetMap Pro verifies UniFi TLS certificates by default. If your local controller uses a self-signed cert, enable the app's insecure fallback option for that session.

eero

eero routers are cloud-managed with no local API. NetMap Pro connects through the eero cloud API using your eero account credentials.

Installer note (Insight workflow): NetMap Pro can only access networks visible to the account you authenticate in the app. If the customer network is not yet linked/assigned to that account, it will not appear and push cannot run until linking is complete.

Setup

  1. Enter your eero email - The email address for the account that currently has access to the target network.
  2. Verify with code — eero sends a verification code to your email. Enter it in NetMap Pro to complete authentication.
  3. Select the network — If your eero account manages multiple networks, select the one for this project.

Push Reservations

Pushes project reservations to your selected eero network. The eero app calls these "IP Reservations" under Advanced settings.

eero Plus not required. DHCP reservations work with any eero plan, including the free tier.
Session expiry: eero cloud sessions expire after a period of inactivity. If you see an authentication error, go back to the Router Config tab and re-authenticate with a new verification code. This is normal eero behavior.

Araknis

Araknis routers (AN-110, AN-210, AN-310, AN-510 series, etc.) are accessed directly through their local web interface. NetMap Pro connects to the router's admin panel and automates the process of reading and writing DHCP reservations — the same operations you'd do manually in the router's LAN → DHCP Reservation page, but without the repetitive clicking.

Setup

  1. Enter the router IP — Usually 192.168.1.1. Verify by opening the Araknis web UI in your browser first.
  2. Enter admin credentials — The username and password for the Araknis web interface. Default is usually admin / araknis unless changed by the installer.

Push Reservations

Click Push to Araknis to write all DHCP reservations from your project to the router. Run preflight and dry-run first, then apply live changes. Existing reservations for the same MAC are updated.

Pull Reservations

Click Pull from Araknis to import the router's current DHCP reservations into your project. Same merge behavior as UniFi and Omada - existing devices are updated, new MACs create new entries, no duplicates.

Firmware compatibility: NetMap Pro works with current Araknis firmware. If the push fails on a very old router, try updating the Araknis firmware through OvrC or the local web UI first.

TP-Link Omada (Open API)

Omada support currently focuses on safe pull/import. NetMap Pro reads reservations via the official Omada Open API and imports them into your project.

Setup

  1. Create Open API credentials — in Omada Cloud / SDN Open API, create an application and capture omadacId, client_id, and client_secret.
  2. Enter credentials in Router Config — paste the base URL, controller ID, client ID, and client secret.
  3. Connect and select site — choose the site to pull from, then click Pull from Controller.

Pull Reservations

Use Pull from Controller to import fixed-IP reservations from Omada into your project. Import behavior matches other routers: existing MACs are synced, new MACs are added, and duplicates are not created.

Current scope: Omada push/write is intentionally disabled in this release. Use pull/import to baseline the project, then assign and manage reservations from within NetMap Pro.

Undo Last Push

If a push creates unexpected results, use Undo Last Push from Router Config.

Tips

Always pull before pushing on a site you didn't set up. This imports existing reservations so you don't accidentally overwrite someone else's work.
Assign reserved IPs first. Only devices with both a MAC address and a reserved IP in NetMap Pro will be pushed to the router. Use the Devices tab to set reserved IPs before going to Router Config. See the IP ranges table for recommended ranges by device type.
Save a snapshot before push. Snapshot compare plus router undo gives you both data-level and router-level rollback options.

Troubleshooting

Connection refused or login fails

Preflight blocks the push

If preflight reports duplicate reserved IPs or invalid records, fix those entries in the Devices tab and run preflight again. NetMap Pro blocks the push intentionally to prevent bad writes.

Push partially fails

If some reservations push successfully but others fail, check that the failing devices have valid MAC addresses and IPs that are within the router's DHCP range. The error message will indicate which devices failed.

For more troubleshooting, see the Troubleshooting & FAQ page.

Next Steps

After pushing reservations:

← Back to Documentation