chamroeunlikefree/hermes repository overview

⁠Hermes Network Monitor

Hermes is a lightweight, self-hosted, full-stack network interface monitoring and alert engine. I build this sh*t up for home network monitor purpose. it easy to install and easy to use it does not have so many fancy features like Zabbix counterpart but it enough for general network monitoring with Graph, Telegram integration and alerts. I was really made it for myself but it would be crime to not share with our fellow open-source community so enjoy the free stuff.

Powered by Go, SQLite and Vue.js

📝 Update Notes Keep track of what's new and what's been fixed.

v1.2.0 Patched: Fixed interface-summing calculation errors that occurred during high traffic spikes.

Patched: Resolved the SQLite database locking issue when triggering multiple simultaneous alerts.

Added: Full support for SNMP V3 polling (see the trick below for setup).

Improved: Smoother UI rendering for historical graph data.

--

⁠🚀 Key Features

• Real-Time Bandwidth Tracking: Lightweight background engine that fetches high-accuracy active network metrics from your hosts.
• Smart Interface-Summing Alerts: Create conditions based on threshold and duration. Supports multi-interface tracking (e.g., sum wan1 + wan2 to monitor total multi-WAN pipeline saturation).
• Zero-Bloat Architecture: No external database clusters or heavy agents required. Everything runs inside a single, tightly optimized container.
• Modern UI/UX: A clean, intuitive dashboard to manage hosts, track interfaces, and configure global alert rules seamlessly.
• Role-Based Access: Basic built-in access levels to securely share your dashboard view with others.

⁠🛠️ Quick Start (Docker Compose)

I try to make it as easy as possible because I hate complicated process. just make sure you have docker compose installed on your machine, if not go search how to install it google or whatever then come back.

services:
  hermes-monitor:
    image: chamroeunlikefree/hermes:latest
    container_name: hermes
    ports:
      - "8014:8014"
    volumes:
      - ./hermes-data:/app/data
    restart: unless-stopped

⁠🏃‍♂️ Running the container

Once your file is ready, spin up the application by running:

docker compose up -d

Open your browser and navigate to http://localhost:8014 to access the dashboard.

💡 The SNMP V3 Trick SNMP V3 is much more secure than V2c, but it requires a bit more setup. When adding an SNMP V3 host in Hermes, make sure you configure your router/switch with authPriv (Authentication and Privacy) for the best security.

Here is the trick to getting it right the first time:

Security Name: This is just your SNMP username.

Auth Protocol & Password: Set this to SHA (avoid MD5 as it's outdated) and create a strong password.

Priv Protocol & Password: Set this to AES (avoid DES) and set a different strong password for privacy/encryption.

Ensure your firewall allows UDP port 161 from the Hermes container IP. Match these exact credentials in the Hermes "Add Host" menu, and it will pull data flawlessly.

Ex: community string: v3:yourcommunitystring

--

⁠🔐 Default Credentials

When accessing the dashboard for the first time, use the following default admin credentials:

• Username: admin
• Password: Hermes

(Note: It is highly recommended to change your password or create a new admin user immediately after your first login.)

⁠💾 Persistent Storage

Hermes utilizes an embedded SQLite database to record historical metrics, host setups, and alert rules. To ensure your history is never lost when modifying or upgrading the container, always make sure the ./hermes-data:/app/data volume mount is specified.

⁠☕ Project Status & Support

This is an independent open-source hobby project. I am just a dude living pay check to pay check and mostly broke all the time but anything I can share I will. if you encounter any bugs or find something that need to be fix you can DM me.

If you find Hermes useful for your homelab or network layout, drop a star!