network discovery · IPAM · self-hosted

Oblimap

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
Per-site
Probes
ARP
+ ping + mDNS
IPAM
IP address management
Live
Change detection

How it works

Scan, discover, map — continuously

One probe per network site. It runs ARP scans and ping sweeps on a configurable schedule, pushes every new discovery to the central server, and flags any change since the last scan.

Lightweight probe — no agent on hosts

Deploy one probe binary per site on Windows, Linux or macOS. It scans the local network autonomously — no software to install on monitored devices.

WindowsLinuxmacOS

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

MAC addresses are automatically resolved to their manufacturer using the OUI database. Instantly know whether a device is an Apple, Cisco, Dell or unknown — without logging into it.

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.png Vue IPAM · tous les sites · filtres · renommage
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-network-map.png

Probe configuration

One binary, one command

Configure the subnet(s) to scan, the scan interval and the central server endpoint. The probe registers itself, begins scanning and pushes results automatically.

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-config.png

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.

Self-hosted
Docker Compose
PostgreSQL / SQLite
Windows · Linux · macOS probe
MIT 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