Kennst du das? Du hast ein paar Raspberry Pis, ein NAS und vielleicht noch einen kleinen Server im Keller laufen und hast keine Ahnung, wie stark CPU, RAM oder Speicher gerade ausgelastet sind, bis plötzlich etwas nicht mehr läuft. Genau hier setzt Beszel an. In diesem Beitrag zeige ich dir, wie du Beszel mit Docker/Portainer auf deinem Raspberry Pi installierst, dein erstes System anbindest und die ersten Alerts einrichtest.

Was ist Beszel?
Beszel ist ein Open-Source-Monitoring-Tool für Server, das bewusst schlank gehalten ist. Es besteht aus zwei Teilen:
Ein Hub, die Weboberfläche, in der du alle deine Systeme auf einen Blick siehst. Der Hub läuft standardmäßig auf Port 8090.
Und ein Agent, ein kleines Programm, das auf jedem System läuft, das du überwachen möchtest. Es sammelt die Messwerte und schickt sie an den Hub.
Beszel zeigt dir CPU-, RAM-, Netzwerk- und Festplattennutzung, die Auslastung deiner Docker-Container und historische Daten. Dazu kommen Alerts, mit denen du bei Schwellwertüberschreitungen benachrichtigt wirst.
Voraussetzungen
Für diese Anleitung brauchst du:
- Einen Raspberry Pi mit Raspberry Pi OS
- Docker/Portainer auf dem Raspberry Pi (falls du noch nicht so weit bist, schau dir gerne unseren Beitrag zu Docker auf dem Raspberry Pi an)
- Einen Ordner für die persistenten Daten. In diesem Beitrag verwende ich
/data/beszel.
Hub installieren als Stack in Portainer
Beszel besteht aus zwei Containern: dem Hub (Weboberfläche) und dem Agenten, der auf dem Pi selbst die Werte sammelt. Beide kommen in einen Stack. Den Agenten werden wir im nächsten Schritt noch mit Schlüssel und Token versorgen.
Öffne Portainer, navigiere zu Stacks und klicke auf Add stack. Gib dem Stack einen Namen, z. B. beszel, und füge folgenden Code in den Web-Editor ein:
services:
beszel:
image: henrygd/beszel:latest
container_name: beszel
restart: unless-stopped
environment:
APP_URL: http://192.168.178.50:8090
ports:
- 8090:8090
volumes:
- /data/beszel/beszel_data:/beszel_data
- /data/beszel/beszel_socket:/beszel_socket
beszel-agent:
image: henrygd/beszel-agent:latest
container_name: beszel-agent
restart: unless-stopped
network_mode: host
volumes:
- /data/beszel/agent_data:/var/lib/beszel-agent
- /data/beszel/beszel_socket:/beszel_socket
- /var/run/docker.sock:/var/run/docker.sock:ro
environment:
LISTEN: /beszel_socket/beszel.sock
HUB_URL: http://localhost:8090
TOKEN: "<token>"
KEY: "<key>"
Passe jetzt noch zwei Dinge an:
- APP_URL: Trage hier die IP-Adresse deines Pi mit Port 8090 ein, also z. B.
http://192.168.178.50:8090. - Pfade: Wenn du einen anderen Ordner als
/data/beszelnutzen möchtest, passe die Pfade entsprechend an. Der Pfad vor dem Doppelpunkt ist der Ordner auf dem Pi, der Pfad dahinter ist der Ordner im Container, den du nicht verändern solltest.
Die Werte <token> und <key> lässt du vorerst so stehen. Die bekommst du erst im nächsten Schritt.
Klicke anschließend auf Deploy the stack. Der Agent wird zu diesem Zeitpunkt noch nicht richtig verbinden, das ist normal.
(Wenn du lieber die Befehlszeile nutzt statt Portainer, kannst du den oben gezeigten YAML-Code einfach in eine docker-compose.yml einfügen und den Stack direkt per docker compose up -d auf deinem Pi starten.)

Admin-Account anlegen und System hinzufügen
Rufe jetzt im Browser die Weboberfläche auf (http://<IP-deines-Pi>:8090).
Beim ersten Aufruf wirst du aufgefordert, einen Admin-Account anzulegen. Vergib eine E-Mail-Adresse und ein starkes Passwort. Mit diesem Account verwaltest du später den Hub und seine Einstellungen.

Danach klickst du oben rechts auf System hinzufügen. Es öffnet sich ein Dialog mit den Angaben, die dein Agent braucht:
- Name: Frei wählbar, z. B.
Raspberry Pi - Host / IP: Hier trägst du für das lokale System den Socket-Pfad ein:
/beszel_socket/beszel.sock - Public Key (KEY) und Token (TOKEN): Diese Werte generiert der Hub für dich.

Kopiere den Public Key und den Token aus dem Dialog. Wechsle dann in Portainer in deinen Stack beszel, öffne den Editor und ersetze <token> und <key> durch die kopierten Werte. Achte darauf, dass du die Anführungszeichen stehen lässt und keine Leerzeichen zu viel einfügst, sonst schlägt die Authentifizierung fehl.
Klicke dann auf Update the stack. Portainer startet den Agenten neu. Danach klickst du im Beszel-Dialog auf System hinzufügen.
Nach kurzer Zeit sollte dein System in der Tabelle auftauchen und grün werden. Dann funktioniert alles. Wird es rot, schau in die Logs des Containers beszel-agent in Portainer, meistens steckt ein falsch kopierter Key oder Token dahinter.

Weitere Server anbinden
Der Hub kann beliebig viele Systeme überwachen. Für jeden weiteren Server (einen anderen Pi, einen Mini-PC, einen VPS) gehst du so vor:
- Klicke im Hub auf System hinzufügen.
- Wähle ganz oben im Dialog aus, wie du den Agenten installieren möchtest: entweder über Docker oder direkt als Binärdatei.
- Trage den Namen, die IP-Adresse und den Port des neuen Servers ein. Der öffentliche Schlüssel und Token werden direkt automatisch befüllt.
- Klicke unten links auf den Button – je nach gewählter Methode steht dort zum Beispiel Docker compose kopieren, Docker run kopieren oder der passende Befehl für dein Betriebssystem (wie Linux-Befehl kopieren).
- Füge den kopierten Befehl oder Code auf deinem neuen Server ein (bzw. lege damit den Stack an) und starte den Agenten.
- Klicke im Hub auf System hinzufügen – das neue System sollte nach wenigen Augenblicken grün werden.
Ein Hinweis zur Sicherheit: Der Agent-Port sollte nicht offen im Internet hängen. Am besten erreicht nur dein Hub den Port, z. B. über die Firewall, ein VPN wie Tailscale oder ein privates Netzwerk.
Alerts einrichten
Ein Monitoring bringt erst dann richtig etwas, wenn du bei Problemen auch benachrichtigt wirst. Dafür legst du zuerst einen Benachrichtigungskanal an, wir nutzen dazu E-Mails per SMTP. Die Einrichtung findest du in den Einstellungen des Hubs unter den Benachrichtigungen.

Danach legst du für dein System fest, ab welchen Werten ein Alert ausgelöst werden soll, zum Beispiel:
- CPU-Auslastung über 90 % für mehrere Minuten
- RAM-Auslastung über 85 %
- Festplatte fast voll
Gerade beim Pi lohnt sich ein Alert auf die Speicherauslastung, weil die SD-Karte oder der SSD-Speicher sonst schnell vollläuft.

Fazit
Beszel ist für mich eine der schlanksten und einfachsten Lösungen, um die eigenen Server im Blick zu behalten. Die Installation mit Docker und Portainer ist in wenigen Minuten erledigt, und mit dem Agenten auf jedem System bekommst du einen schnellen Überblick über deine gesamte Infrastruktur. Sichere am besten regelmäßig den Ordner /data/beszel/beszel_data, dort liegen alle Einstellungen und historischen Daten.
Viel Spaß beim Monitoring deines Homelabs!
Passende Produkte für dein Homelab-Monitoring
Auf BerryBase.de findest du passende Produkte für diesen Artikel, zum Beispiel:



































