mikkel/homelab
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
homelab/beszel/README.md
Mikkel Georgsen 654e3ffbce Add Beszel server monitoring dashboard 
- Deployed Beszel hub in Dockge (10.5.0.10:8090)
- Installed agents on PVE host and PBS (with Synology mount monitoring)
- Created NPM proxy at dashboard.georgsen.dk
- Created ~/bin/beszel helper script for API management
- Added credentials for Beszel and Dockge
- Updated all documentation

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-14 23:27:01 +00:00

2.2 KiB
Raw Blame History

Beszel - Server Monitoring Dashboard

Overview

Architecture

Hub (Dockge 10.5.0.10:8090)
  ├── core (10.5.0.254:45876) - PVE host
  └── pbs (10.5.0.6:45876) - Backup server + Synology mount

Helper Script

~/bin/beszel list                        # List all systems
~/bin/beszel status                      # Show system metrics
~/bin/beszel add <name> <host> [port]    # Add a system
~/bin/beszel delete <id>                 # Delete a system
~/bin/beszel alerts                      # List alerts

Adding a New System

1. Install Agent

# Download binary
curl -sL "https://github.com/henrygd/beszel/releases/latest/download/beszel-agent_linux_amd64.tar.gz" | tar -xzf - -C /usr/local/bin beszel-agent
chmod +x /usr/local/bin/beszel-agent

# Create systemd service
cat > /etc/systemd/system/beszel-agent.service << 'EOF'
[Unit]
Description=Beszel Agent
After=network.target

[Service]
Environment="KEY=<SSH_KEY_FROM_CREDENTIALS>"
Environment="PORT=45876"
ExecStart=/usr/local/bin/beszel-agent
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target
EOF

# Enable and start
systemctl daemon-reload
systemctl enable beszel-agent
systemctl start beszel-agent

2. Add to Hub

~/bin/beszel add <name> <host>

Monitoring Extra Filesystems

To monitor additional mounts (e.g., NFS, CIFS):

# Add to systemd service
Environment="EXTRA_FILESYSTEMS=/mnt/synology,/mnt/other"

API Access

Beszel uses PocketBase. Python SDK:

from pocketbase import PocketBase

pb = PocketBase('http://10.5.0.10:8090')
pb.admins.auth_with_password(email, password)

# List systems
systems = pb.collection('systems').get_full_list()

# Add system
pb.collection('systems').create({
    'name': 'hostname',
    'host': '10.5.0.x',
    'port': 45876,
    'users': [user_id]
})

References