xoriin

xoriin / NetMap

Public

NetMap is a self-hosted tool that gives you a proper overview of your home lab or small network. Map out your devices, track IPs, watch for things going down, and dig into firewall logs — all from one place, running on your own hardware.

34
4
100% credibility
Found May 21, 2026 at 34 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
TypeScript
AI Summary

NetMap is a self-hosted network visibility and operations tool designed for home labs and small environments. It provides a visual topology canvas where you can map devices, draw connections, and organize them into VLANs. The tool continuously monitors your devices using background ping and port checks, tracking uptime and alerting you when things change. It includes built-in network tools (ping, traceroute, DNS lookup, subnet calculator) so you don't need to SSH into other machines. NetMap can ingest firewall logs from pfSense, OPNsense, or Unifi, correlating events with your device inventory. It supports role-based access control for multiple users, exports data as PDF reports or CSV files, and stores everything in a single SQLite database. Everything runs in one container with no cloud dependencies.

How It Works

1
🔍 You discover NetMap

You find NetMap while looking for a way to see everything on your home network in one place.

2
📦 You install it in minutes

You download one container and run it alongside your other self-hosted services—no accounts, no subscriptions.

3
🗺️ You draw your network

You add your devices to a visual map, draw connections between them, and group them into your VLANs.

4
You choose how to populate your map
✏️
Add devices by hand

You type in your server, router, and camera details one by one.

🔍
Let it scan your network

NetMap runs a discovery scan and imports every host it finds with their names and open ports.

5
📊 You watch your network breathe

NetMap continuously checks whether your devices are online and shows you a heartbeat strip of recent results.

6
🔔 You set up alerts

When your server goes offline or comes back online, NetMap sends you a message through your preferred channel.

7
🛡️ You connect your firewall logs

You point your firewall at NetMap and watch live traffic events stream into your browser, linked to your device inventory.

✨ You have full visibility

Everything about your network is now in one place—your map, your devices, your logs, and your alerts.

Sign up to see the full architecture

6 more

Sign Up Free

Star Growth

See how this repo grew from 34 to 34 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is NetMap?

NetMap is a self-hosted network visibility dashboard that runs entirely in a single Docker container. It gives you a visual map of your home lab or small network, tracks which devices are online, watches firewall logs from pfSense, OPNsense, or Unifi, and alerts you when things go down. The backend is Python with FastAPI, the frontend is React with TypeScript, and everything persists to SQLite. You point it at your network, and it becomes the single pane of glass for inventory, monitoring, and security log analysis.

Why is it gaining traction?

The all-in-one container approach is the hook. No separate database server, no Node.js build step, no cloud account. You drop it into your existing Compose stack and it just works. The topology canvas with drag-and-drop device placement and persistent layouts fills a real gap for anyone tired of drawing network diagrams in Visio. Built-in ping, traceroute, DNS lookup, and subnet calculation mean you stop SSHing into jump boxes for basic diagnostics. The firewall syslog ingestion from multiple vendors (pfSense, OPNsense, Unifi) with live tailing and IP correlation is genuinely useful for home lab security monitoring.

Who should use this?

Home lab enthusiasts running pfSense, OPNsense, or Unifi who want to correlate firewall events with their device inventory. Network admins managing a handful of subnets who need IP address tracking without spinning up full IPAM suites like NetBox. Anyone tired of checking device status manually and wants uptime graphs, alert notifications to ntfy or Telegram, and one place to see it all.

Verdict

NetMap delivers a coherent feature set for its target audience at a credible level of polish for a 34-star project. The documentation is thorough, the Docker setup is straightforward, and the API is fully documented via Swagger. However, the credibility score of 1.0% signals this is early-stage software with limited community validation. If you want a self-hosted alternative to commercial network monitoring tools, NetMap is worth a weekend evaluation. Just back up your data directory before upgrading and treat it as a personal project rather than mission-critical infrastructure until it gains more traction.

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.