Beszel on Raspberry Pi

🔍 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

1. Update your system
   sudo apt update && sudo apt upgrade -y
2. Install Docker
   

   curl -fsSL https://get.docker.com -o get-docker.sh
   sudo sh get-docker.sh

3. Install Docker Compose
   sudo apt install docker-compose-plugin
4. Add your user to the Docker group
   sudo usermod -aG docker $USER
5. Enable Docker at boot
   sudo systemctl enable docker
6. Reboot
   sudo reboot
7. Test Docker
   docker run hello-world

📁 Setup Beszel

mkdir ~/docker
mkdir ~/docker/beszel

🧾 Docker Compose File

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

services:
  beszel-agent:
    image: henrygd/beszel-agent:latest
    container_name: beszel-agent
    restart: unless-stopped
    network_mode: host

    environment:
      LISTEN: "45876"
      KEY: "The key you generate on the Beszel server by clicking Add System"
      TOKEN: "The token you generate on the Beszel server by clicking Add System"
      HUB_URL: "https://192.168.xx.xx:8095" # Use the Beszel Server IP address

    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro
      - /home/home-directory/docker/beszel/beszel_agent_data:/var/lib/beszel-agent:rw
      - /var/lib/beszel/metrics:/var/lib/beszel/metrics:ro

To generate the KEY, browse to your Beszel Hub and click on Add System.

▶️ Start Beszel

From within ~/docker/beszel run:

📜 View Logs

🌐 Access Web Interface

Open your browser and go to "http://<192.168.xx.xx>:8095. You should see your Pi listed.

NOTE: If you don't see Docker Memory Usage being reported, do this:

1. sudo vi /boot/firmware/cmdline.txt
2. Add this to the end of the line: cgroup_enable=cpuset cgroup_enable=memory cgroup_memory=1
3. Reboot: sudo reboot