Beszel on Ugreen NAS

🔍 What Beszel Does

• Hub + Agent Architecture
  • Hub: A web application (built on PocketBase) that provides the dashboard, user management, and API.
  • Agent: A small Go binary or Docker container that runs on each monitored system, reporting stats back to the Hub.
• Metrics Collected
  • CPU, memory, disk, bandwidth, temperature, and system status.
  • Docker/Podman container stats (CPU, memory, network usage).
  • Historical data storage for trend analysis.
• Alerts & Notifications
  • Configurable alerts for resource thresholds (CPU, memory, disk, etc.).
  • Real‑time notifications via email, webhook, or integrated services.
• Multi‑User & Security
  • Each user manages their own systems; admins can share systems.
  • Supports OAuth/OIDC authentication (Google, GitHub, etc.).
  • Password authentication can be disabled for stricter security.
• Lightweight Design
  • Minimal footprint compared to Prometheus/Grafana or Netdata.
  • Hub runs as a single Docker container; agents are tiny binaries.
  • Even with multiple agents, CPU usage stays very low.
• Backup & API
  • Automatic backups to disk or S3‑compatible storage.
  • REST API for integrating monitoring data into scripts or other apps
  • Real-time monitoring: CPU, memory, disk I/O, network usage

🚀 Docker Installation Steps

I have two NVME SSDs installed in my DXP2800, mirrored, that I use to hold apps and docker containers. It's configured as /volume2. All of my docker containers are run from /volume2/docker

1. In the Ugreen NAS app, open the App Center
2. Search for "Docker"
3. Install Docker

📁 Setup Beszel

This guide will setup your Ugreen NAS to run as a Beszel Hub and Agent. You will browse to the Hub and it will see all the agents you have configured.

mkdir /volume2/docker/beszel

🧾 Docker Compose File

In /volume2/docker/beszel create docker-compose.yml

services:
  beszel:
    container_name: beszel
    image: henrygd/beszel:latest
    volumes:
      - /volume1/docker/beszel:/beszel_data:rw
    ports:
      - 8095:8090
    restart: unless-stopped

  beszel-agent:
    image: henrygd/beszel-agent
    container_name: beszel-agent
    network_mode: host
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro
    environment:
      LISTEN: 45876
      KEY: "YOUR-KEY"  # This must match the key you set on the Beszel server
      FILESYSTEM: /dev/sda1
    restart: unless-stopped

To generate the KEY, you'll have to bring up the container, browse to your Beszel Hub and click on Add System. Once you update the compose file with the KEY, restart beszel

▶️ Start Beszel

From within /volume2/docker/beszel run:

📜 View Logs

View logs for the Beszel server:

View logs for the Beszel agent:

🌐 Access Web Interface

Open your browser and go to http://<your-ugreen-NAS>:8095 and start adding clients.