IPMG

IP Management & Ping Monitoring Tool
Know what changed on your network since the last scan.

Website  ·  Live demo  ·  Command builder  ·  Docs

IPMG sweeps IPs, CIDR blocks, and ranges in parallel, remembers every scan, and tells you what changed since the last one: hosts that went down or appeared, a new MAC address or hostname behind an address, slower replies, a web service that started failing. Only the changes that matter reach Slack, Teams, a webhook, or email, or fail your cron job or CI step.

Features

• Fast, without root. IPv4 and IPv6, CIDR blocks, ranges, and target files (text, CSV, Excel, JSON), many hosts at a time, using your system's own ping.
• Finds hosts that block ping with TCP probes (--probe icmp,tcp), and checks web services (--http-check: status, response time, TLS, certificate expiry).
• Names every device by reverse DNS and, on your LAN, by MAC address and vendor (--mac). Wakes them with Wake-on-LAN (ipmg wake).
• Tells you what changed since the last scan, with a severity for each change, and alerts Slack, Teams, webhooks, or email.
• Made for automation: exit codes for cron and CI, a GitHub Action, --json for scripts, systemd and launchd templates, Prometheus metrics.
• IPMG Web, a local dashboard: live scans, history, changes, inventory, and scheduled scans.
• Reports in Excel, CSV, JSON, JSON Lines, and Markdown, written as the scan runs, so an interrupted scan keeps its results.

How IPMG compares with nmap, fping, and Uptime Kuma.

Install

# Linux and macOS, no Python needed
curl -sSL https://raw.githubusercontent.com/sameeralam3127/ipmg/main/install.sh | bash

# Windows, no administrator rights
irm https://raw.githubusercontent.com/sameeralam3127/ipmg/main/install.ps1 | iex

Or from PyPI, with Python 3.10 or newer:

# With pip, in a virtual environment
pip install ipmg            # the command line
pip install "ipmg[web]"     # the command line and IPMG Web, the browser dashboard

# With pipx
pipx install "ipmg[web]"

# With uv, which fetches Python 3.10+ if you need it
uv tool install --python ">=3.10" "ipmg[web]"

Also on:

• Homebrew: brew install sameeralam3127/tap/ipmg
• Docker: docker run --rm sameeralam3127/ipmg --input 10.0.0.0/24, or from GHCR: ghcr.io/sameeralam3127/ipmg

Tip: [web] adds IPMG Web; pip install ipmg alone is the command line. Where the system Python is older than 3.10 (RHEL 9, Ubuntu 20.04, SLES 15), pip and pipx quietly install an older IPMG: use the installer or uv there. The install guide covers version pinning, upgrading from 3.x, and tab completion.

Quick start

ipmg --discover             # scan the network you are on, right now
ipmg --discover --compare   # later: scan again and see what changed
ipmg web --lan              # open the dashboard from any machine on your network

Every scan is saved to a local history (~/.ipmg/dashboard.db), so --compare always has the previous scan to compare with.

  ipmg X.Y.Z  ·  scan
  ICMP probes only — scan only networks you are authorized to scan.

  Source   192.168.1.0/24
  Targets  254 hosts
  Config   50 threads · 2s timeout · 1 ping

  Results
  ● Active    12  ━───────────────────────   4.7%
  ● Timeout  242  ━━━━━━━━━━━━━━━━━━━━━━━━  95.3%

  254 hosts · 4.7% active · 3.1 ms avg · 5.21s · 2026-10-18 09:15:02

  Saved    results_20261018_091502.xlsx

Note: only scan networks you are authorized to scan. Unauthorized scanning may violate your organization's policies or the law.

Common tasks

IPMG Web

ipmg web          # this machine: opens http://127.0.0.1:8080 in your browser
ipmg web --lan    # any machine on your network: prints the link to open

With --lan, IPMG Web prints the link with this machine's address and access token, checks the firewall, and tells you the exact command that opens the port if it is blocked (sudo ipmg web --open-firewall opens it only while IPMG Web runs). Every request needs the token in that link.

Dashboard, live monitor, history, changes, inventory with Wake-on-LAN, and scheduled scans; see the IPMG Web guide, or try it first in the live demo.

Documentation

Security

IPMG runs ping as a direct process call with no shell, validates every target first, and needs no root. IPMG Web listens on 127.0.0.1 unless you pass --lan, serves everything locally, and requires its access token on every request, behind a strict Content-Security-Policy. The only outbound requests IPMG makes are the notifications and HTTP checks you ask for. Found a vulnerability? See SECURITY.md.

Contributing

Contributions are welcome. CONTRIBUTING.md covers the development setup, the tests, and the commit format that drives releases, and ARCHITECTURE.md explains the code. Everyone taking part is expected to follow the Code of Conduct.

If IPMG saves you time, a star on GitHub helps other people find it.

License

MIT — free for commercial and personal use.