🧰 Schritt 11: Anhang / Troubleshooting & Systembefehle
Diese Übersicht fasst nützliche Befehle für Diagnose, Systemanalyse und Fehlersuche auf deinem EndeavourOS ARM / ioBroker-System zusammen.
⚠️ Achtung
ioBroker-Befehle dürfen niemals mit
sudoausgeführt werden!
Das ist eine bewährte Sicherheitspraxis, da ioBroker – wenn korrekt installiert – keine Administratorrechte benötigt, um zu funktionieren.Die Verwendung von
sudosollte auf wirklich notwendige Situationen beschränkt bleiben, z.B. bei der Installation oder bei Linux-Updates, jedoch nicht im regulären täglichen Betrieb.
🧩 1. Systeminformationen
uname -a # Kernelversion & Architektur
hostnamectl # Hostname, Kernel, Architektur, OS
uptime -p # Systemlaufzeit
💾 2. Speicher- & Datenträgerstatus
df -h # Übersicht belegter und freier Speicherplatz
lsblk # Blockgeräte und Partitionen anzeigen
mount | grep sda # Eingehängte Laufwerke (z.B. SSD)
sudo fstrim -av # TRIM-Lauf für SSDs
🧠 3. RAM & CPU
free -h # RAM-Auslastung in human-readable Format
top # Prozesse und Systemlast
htop # Erweiterte Prozessanzeige
lscpu # CPU-Informationen
🌐 4. Netzwerk & Verbindungen
ip addr show # Netzwerkinterfaces und IP-Adressen
ping -c3 8.8.8.8 # Internetverbindung prüfen
ping -c3 192.168.0.1 # Router-Verbindung prüfen
ss -tuln # Offene Ports & laufende Dienste
systemctl status systemd-networkd
systemctl status systemd-resolved
🔍 5. Journal & Logdateien
journalctl -p 3 -xb # Fehler des letzten Systemstarts anzeigen
journalctl -u iobroker # Log des ioBroker-Dienstes
sudo dmesg | tail -30 # Letzte Kernelmeldungen
sudo less /var/log/pacman.log # Paketinstallationen & Updates
🧱 6. Dienste & Status
systemctl list-units --failed # Zeigt fehlerhafte Systemdienste
systemctl status iobroker.service # ioBroker-Dienst prüfen
systemctl restart iobroker # ioBroker neu starten
sudo systemctl daemon-reexec # Systemd neu laden (ohne Reboot)
🧩 7. Pacman & Paketverwaltung
sudo pacman -Syu # Normales Systemupdate
sudo pacman -Syyuu # Vollständige Neu-Synchronisation (spiegelt ggf. auch Downgrades wider)
sudo pacman -Qdtq # Verwaiste Pakete auflisten
sudo pacman -Rsn $(pacman -Qdtq) # Verwaiste Pakete entfernen (inkl. Abhängigkeiten und Konfigdateien)
sudo pacman -Scc # Cache leeren (zweimal bestätigen)
# Wenn du yay nutzt:
yay -Syu # ohne sudo! Führt pacman- und AUR-Updates aus
yay -Sc # alten Paket-Cache (pacman + AUR) bereinigen
yay -v -Scc # pacman- und yay-Cache bereinigen
Hinweis: -Syyuu sollte nur bei Problemen mit Mirrorlisten oder Paketversionen verwendet werden.
🧩 8. ioBroker – Wartung & Kontrolle
iob info # Systeminformationen anzeigen
iob status # Status von ioBroker und Adaptern anzeigen
iob logs # Letzte Logeinträge anzeigen
iob diag # Diagnosebericht erstellen
iob backup # Backup erstellen
iob stop && iob fix # Rechte & Dienste reparieren
iob stop && iob update && iob upgrade self && iob upgrade # ioBroker aktualisieren
iob start # ioBroker starten
sudo reboot # System neu starten
🧩 9. Node.js aktualisieren (z.B. bei neuer LTS)
Nach einem Node.js-Update solltest du einen Rebuild der nativen Module machen, sobald sich die N-API/ABI effektiv geändert hat (typisch bei Node-Major-Updates). Ein Rebuild „schadet“ nicht, er kostet nur Zeit. Dokumentation: Node.js Previous Releases.
iob stop && iob update && iob upgrade self && iob upgrade
sudo pacman -Syu
# Alt-LTS entfernen:
sudo pacman -Rns nodejs-lts-<ALT> npm
# neues LTS installieren (z.B. nodejs-lts-krypton (V24), je nach Stand von Arch):
sudo pacman -S nodejs-lts-<NEU> npm
# Versionen:
command -v node nodejs npm npx && node -v && nodejs -v && npm -v && npx -v
# einmal Fixer (Rechte/Capabilities), ersetzt KEIN rebuild:
iob fix
# alle Adapter mit nativen Modulen neu bauen/neu installieren:
cd /opt/iobroker
iobroker rebuild --install
# neu starten und prüfen:
iob start
iob status
# optional:
sudo reboot
Stand: Juli 2026
| Node.js | Codename | ioBroker |
|---|---|---|
| v26 | - | kommende LTS |
| v24 | Krypton | aktuelle LTS |
| v22 | Jod | ✅ ioBroker-Empfehlung (Stand 2025-August) |
| v20 | Iron | EOL |
| v18 | Hydrogen | EOL |
- Sobald Node.js 26 offiziell in den LTS-Status wechselt, wird der Codename üblicherweise bekanntgegeben.
- Auch wenn eine neue Node.js-Version den LTS-Status erreicht, bedeutet dies nicht automatisch, dass sie bereits für ioBroker empfohlen wird. ioBroker gibt neue Node.js-Versionen in der Regel erst nach erfolgter Prüfung und Freigabe für den produktiven Einsatz frei.
✅ Ende der Installations- und Wartungsanleitung
Du hast jetzt ein voll funktionsfähiges, sauberes und wartbares EndeavourOS ARM-System
mit ioBroker, optimiert für Stabilität, Sicherheit und Headless-Betrieb.