NetAlertX

A network device scanner and alert system. Monitors your local network for new or disconnected devices, tracks IP and MAC addresses, and sends customizable notifications.

Note: Network device scanning requires host network mode for ARP/ping scanning, which is not available in containerized cloud environments. The web UI, device management, and history features will function, but live scanning of your local network requires running on bare metal or a VM with host networking.

What You Can Do After Deployment

1. Visit your domain — open the dashboard to view detected devices
2. Configure scanning — set up network scanning parameters in the settings page
3. Set up notifications — configure email, webhook, Pushover, NTFY, or other notification channels
4. Review device history — track when devices connect and disconnect from your network
5. Manage devices — assign names, groups, and notes to discovered devices
6. Use the API — access device data programmatically via the built-in REST API

Key Features

• Network device discovery via ARP, ping, and other methods
• New device and disconnection alerts
• Multi-channel notifications (email, webhook, Pushover, NTFY, and more)
• Device history and presence tracking
• Web-based dashboard with search and filtering
• REST API for programmatic access
• SQLite storage (no external database needed)

License

GPL-3.0 — GitHub