wglabz/hnms repository overview

⁠HNMS: Home Network Management System

A professional-grade, web-based network monitoring and security suite for the modern home.

HNMS gives you total visibility over your local network by combining real-time Nmap/Scapy scanning with persistent historical tracking. It features a modern glassmorphism UI, dynamic device classification, and a built-in SSH terminal.

⁠🚀 Quick Start

⁠Docker Compose (Recommended)

To ensure the scanner has full access to your network interface (required for accurate ARP discovery), use network_mode: host on Linux.

version: '3.8'
services:
  hnms:
    image: oksbwn/hnms:latest
    container_name: hnms
    network_mode: "host"
    environment:
      - APP_ENV=production
      - MQTT_ENABLED=true
      - MQTT_HOST=192.168.1.50 # Change to your broker IP
    volumes:
      - ./hnms_data:/app/data
    restart: unless-stopped

⁠Docker Run

docker run -d \
  --name hnms \
  --network host \
  -v $(pwd)/hnms_data:/app/data \
  -e APP_ENV=production \
  oksbwn/hnms:latest

⁠⚙️ Configuration

⁠✨ Key Features

• Dual-Mode Discovery: Parallel Scapy ARP + ICMP Ping sweeps for 100% device parity across Docker & Windows.
• Dynamic Classification: Fully editable rules engine for custom icons and device types.
• Integrated SSH: Direct web-based terminal access to your network devices.
• Home Assistant Integration: Auto-discovery for device presence sensors via MQTT.
• Persistent History: High-performance analytical storage powered by DuckDB.
• Timezone Aware: Automatic synchronization with your local clock (IST/UTC/etc).

⁠⚠️ Important Requirements (Linux)

For full functionality (MAC address resolution/ARP scans), the container must run with network_mode: host. On macOS or Windows, the scanner will automatically fallback to a parallel Ping sweep if host networking is restricted.

Built with ❤️ for the Home Automation Community.