A lightweight Node.js network monitoring dashboard with real-time updates, SQLite storage, and a modern web UI.

BeanPing continuously pings your nodes, stores results, and gives you a live dashboard of latency, packet loss, and jitter. It also includes problem node detection, database backup/restore, and more.

---

🆕 What’s New in v1.2.0

Version 1.2.0 introduces major improvements to networking, automation, and webhooks, along with UI enhancements.

🌐 Networking & Core Improvements

• ✅ IPv6 tested and fully working
• 🔔 Fixed update notification system
• 💾 Automatic database backup scheduling

⚙️ Node Management

• ✏️ Edit node settings directly from the node view page

🔔 Webhooks Enhancements

• ⏱️ Time-stamped webhook events
• ✏️ Edit existing webhooks
• 🌍 Global and per-node webhook configuration
• ⏸️ Pause / resume webhooks

🌸 Yuri v2

• 🧿 New Yuri favicon (thanks to @minoplhy)
• 🖼️ New Yuri logo (thanks to @minoplhy)

---

✨ Features

• 📡 Monitors nodes by pinging them 10 times per minute
• ⏱️ Tracks latency, packet loss, and jitter
• ⚠️ Highlights problem nodes automatically (threshold detection)
• 📊 Dashboard + per-node stats + compare view
• 💾 Local SQLite database (easy backup/restore)
• 🔌 Real-time updates using WebSockets (Socket.IO)
• 🔒 Runs as a systemd service on Linux

---

🚀 Installation

1. Clone the repo into a safe directory

⚠️ Do not clone into /root — the service user cannot access it.

Recommended locations: /srv/beanping, /opt/beanping, or /home/youruser/beanping.

cd /srv
git clone https://github.com/beanman109/beanping.git
cd beanping

2. Run the installer (as root)

chmod +x install.sh
./install.sh

The installer will:

• Create a dedicated service user beanping
• Install dependencies (node, sqlite3, traceroute, mtr)
• Run npm install --production
• Create an empty monitor.db if needed
• Create + enable a systemd service (beanping.service)

---

🖥️ Usage

Once installed, BeanPing will run automatically as a background service.

• Access the dashboard:
  👉 http://localhost:3000

• Manage the systemd service:

systemctl start beanping
systemctl stop beanping
systemctl restart beanping
systemctl status beanping
journalctl -u beanping -f

---

🔄 Updating

To pull updates from GitHub and restart:

cd /srv/beanping
git pull
npm install --production
systemctl restart beanping

---

🔧 Troubleshooting

• Service fails with Permission denied
  → Make sure the repo is not under /root; move it to /srv/beanping or /opt/beanping.

• Missing database error
  → Create one (installer normally does this):

  touch /srv/beanping/monitor.db
  chown beanping:beanping /srv/beanping/monitor.db

• Cannot find module xxx
  → Run npm install --production in the repo folder.

---