Oblimap
network discovery · IPAM · self-hosted

Intelligent network cartography & IPAM.

Deploy a probe on each network site. It scans regularly, discovers every IP and MAC address, detects changes — and keeps a live map of all your equipment, always up to date.

Deploy now View on GitHub How it works ↓

Architecture

Probe
Site A ARP · ping · mDNS
Probe
Site B ARP · ping · mDNS
Probe
Site N + custom schedule
discoveries →
Central
server store · diff · alert
→ IPAM UI
Dashboard
& map
2
Binaries: probe + agent
ARP
+ ping + mDNS
Push
No inbound ports required
Live
IP takeover & instability alerts

How it works

Scan, discover, map — continuously

One probe per network site. Probes are push-based — they initiate all communication outbound to the central server, require no inbound ports, and run ARP scans + ping sweeps on a configurable schedule. Devices are scoped to their site and every change is flagged in real time.

Lightweight probe — no agent on hosts

Deploy one probe binary per site on Windows, Linux or macOS. Push-based: the probe initiates all communication outbound — no inbound ports required on the server side. No software to install on monitored devices. Devices are automatically scoped to their site.

WindowsLinuxmacOSPush-based

Multi-method discovery

ARP scan for local subnet devices, ICMP ping sweep for reachability, mDNS/Bonjour for hostnames. Combines all three for maximum coverage with zero configuration on the target hosts.

ARPPingmDNS

Persistent IPAM database

Every discovered IP and MAC address is stored with its first-seen and last-seen timestamps. Historical data stays intact — you can trace when any device appeared or left the network.

Device renaming & labelling

Assign a meaningful name to any device directly in the IPAM. Labels and custom names persist across scans — an IP may change, but your name for the device stays in the record.

Change detection & alerts

New device on the network? A MAC address moved to a different IP? A device went silent? Oblimap spots it and raises an alert — keeping you informed of every topology change.

MAC vendor lookup & type rules

MAC addresses are resolved to their manufacturer via the OUI database. On top of that, custom vendor-type rules map vendor name patterns to a device type and label — so Cisco MACs become "Router", Raspberry Pi becomes "SBC", etc. — automatically, without logging into anything.

IP takeover detection

When a new MAC address claims an IP already known under a different MAC, Oblimap fires an alert immediately. The old device record is preserved with its full history; a new device entry is created for the incoming MAC — no data is lost.

AlertHistory preserved

IP instability detection

If 3 or more distinct MAC addresses claim the same IP within a 30-minute window, a LiveAlert warning is raised. Catches DHCP conflicts, ARP spoofing attempts and misconfigured static IPs before they cause outages.

LiveAlert3+ MACs / 30 min

Subnet heatmap

A visual /24 occupancy map showing every IP slot in a subnet at a glance — used IPs, reserved IPs and free slots are colour-coded by device type. Instantly spot saturation, fragmentation and gaps in your address space.

/24 gridDevice typesReservations

IP reservations

Admins can reserve an IP address before a device ever appears on the network. Reserved slots are visible in the IPAM and the subnet heatmap, preventing accidental reuse and documenting planned allocations.

Pre-allocationIPAM visible

IPAM Dashboard

Every device, every site, one view

The central dashboard lists all discovered devices across all sites. Filter by site, subnet or status. Rename, label and annotate directly from the table.

Oblimap — IPAM Dashboard
Oblimap dashboard — sites, devices, probes
Name IP address MAC address Vendor Status
gateway-main 192.168.1.1 00:1A:2B:3C:4D:5E Cisco up
srv-web-01 192.168.1.10 B8:27:EB:A1:02:C3 Raspberry Pi up
nas-backup 192.168.1.22 00:11:32:DE:AD:01 Synology up
— unnamed — 192.168.1.87 DC:A6:32:F1:88:2B Unknown new
printer-floor2 192.168.1.45 44:8A:5B:C9:00:12 HP gone

Network map

Visual cartography of your site

A graphical view of every discovered device, laid out by subnet. See relationships, spot unknown devices and drill into any node for its full discovery history.

  • ▸ One map per site, all sites accessible from one dashboard
  • ▸ Colour-coded device status (up / new / gone / unknown)
  • ▸ Click any node — IP, MAC, vendor, name, history
  • ▸ Rename and label directly from the map
Network map · Site A
Oblimap devices — IPs, MACs, vendors, statuses

Probe configuration

One binary, one command

Configure the subnet(s) to scan, the scan interval, the site name and the central server endpoint. The probe registers itself, begins scanning and pushes all discoveries outbound — no firewall rules needed on the server side, no inbound ports to open.

Configurable scheduleMulti-subnet Custom site labelsNo root required
  • ▸ One probe covers one or multiple subnets on the same site
  • ▸ Scan interval configurable per probe (e.g. every 5 min)
  • ▸ Probes push outbound only — no inbound ports on the server
Probe · site config
Oblimap probe settings — scan interval, subnets

Optional system agent

Per-host metrics, beyond discovery

The probe discovers devices passively. For hosts where you want deeper visibility, deploy the optional Go agent — it runs on the host itself and reports system metrics back to the Oblimap server.

  • ▸ CPU, Memory, Disk usage
  • ▸ Network throughput (per interface)
  • ▸ Temperatures — LHM (Windows), NVMe, ASUS ATK
  • ▸ GPU metrics — NVIDIA & AMD
  • ▸ Native Go binary — Windows, Linux, macOS
  • ▸ Completely optional — probe still works without it
WindowsLinuxmacOSGo binary
System agent · host metrics
Oblimap subnet heatmap — IP activity timeline

More features

Sites, probes, vendor rules & multi-tenant

Multi-site management with per-site probes, MAC vendor database for automatic device type detection, and workspace isolation for MSPs.

Sites · per-site stats
Oblimap sites with device counts
Probes · OS & status
Oblimap probes list with OS and status
Vendor rules
Vendor rules — MAC vendor to device type mapping
MAC vendor database
MAC vendor OUI database lookup
Workspaces · multi-tenant
Multi-tenant workspaces

Stack

Built to stay simple

Self-hosted, single Docker Compose stack. No external services required — the central server, database and web UI are all bundled together. Server v2.2.12 · Client v2.2.13.

Self-hosted
Docker Compose
Node.js 24 / TypeScript / Express
React 18 + Vite
PostgreSQL 16
Socket.io real-time
Windows · Linux · macOS probe
ELv2 License

Quick deploy

Up in 60 seconds

One command for the central server. Then drop a probe on each network site with a single line — they auto-register and start scanning.

Central server
$curl -fsSL https://raw.githubusercontent.com/MeeJay/Oblimap/main/install.sh | bash
✓ Oblimap central running on http://localhost:8090
Probe — on each site to map
$curl -fsSL https://raw.githubusercontent.com/MeeJay/Oblimap/main/probe-install.sh | bash -s -- \
  --central https://map.example.com --token YOUR_TOKEN \
  --subnet 192.168.1.0/24 --site "Site A"
✓ Probe registered · scanning 192.168.1.0/24 every 5 min