> ## Content Index > Fetch the complete content index at: https://blog.rgb-schnitzel.de/llms.txt > Use this file to discover other available public pages before exploring further. # Stupix: Hardwarediagnosen direkt vom Live-System - URL: https://blog.rgb-schnitzel.de/stupix-hardwarediagnosen-direkt-vom-live-system/ - Published: 2026-11-10T18:06:42.000Z - Updated: 2026-11-10T18:06:42.000Z - Author: Max Sander - Tags: Betriebssysteme, Software-Projekte Wenn ein Server Probleme macht, beginnt die Suche oft mit vielen einzelnen Werkzeugen: Welche Laufwerke sind eingebaut? Was meldet SMART? Ist der BMC erreichbar? Wie sehen Netzwerk, RAM und PCI-Geräte aus? **Stupix** bündelt solche Prüfungen in einem Debian-basierten Live-System, das direkt von USB, ISO oder virtueller Medien startet. Das Projekt besteht aus zwei Teilen: [stupix](https://github.com/Maxsander123/stupix?ref=blog.rgb-schnitzel.de) enthält das Diagnose-Skript, während [stupix-build](https://github.com/Maxsander123/stupix-build?ref=blog.rgb-schnitzel.de) die Live-System-Images baut und veröffentlicht. ## Starten, prüfen, Logs auswerten Stupix ist für Serverdiagnosen gedacht und läuft vollständig aus dem Arbeitsspeicher. Das System mountet sein Image schreibgeschützt und verwendet ein RAM-Overlay. Es soll dadurch unabhängig vom installierten Betriebssystem und den internen Laufwerken starten. Beim Booten erhält das System per DHCP eine Netzwerkadresse. Anschließend klont es das Skript-Repository nach `/opt/stupix` und führt `auto.sh` aus. Die Diagnosen schreiben ihre Ergebnisse getrennt nach `/var/log/stupix/`. Dazu zählen unter anderem: - Netzwerk, IP-Adressen, Routing und DNS - System-, BIOS-, CPU- und RAM-Informationen - Laufwerke, NVMe, SCSI, RAID und SMART-Daten - PCI- und USB-Geräte - IPMI/BMC-Informationen, Sensoren und Ereignisprotokolle - vollständige Hardwareinventare sowie weitere Diagnose- und Testlogs Die Build-Dokumentation nennt zusätzlich strukturierte Ausgaben wie `inventory.json`, Laufwerksleistungswerte, NIC-Link-Informationen und Kernel-Fehlerprotokolle. Das Ergebnis lässt sich per SSH abrufen oder direkt über die Konsole prüfen. ## Für verschiedene Plattformen Die veröffentlichten Images gibt es für: | Image | Plattform | Boot | | ------------------------ | ------------------------------------------- | -------------------- | | stupix-linux-amd64.iso | x86-64-PCs und Server | Legacy BIOS und UEFI | | stupix-linux-arm64.iso | ARM64, etwa Raspberry Pi 4/5 und ARM-Server | UEFI | | stupix-linux-riscv64.iso | RISC-V 64 Systeme | UEFI | Für Raspberry Pi 4/5 wird laut Projekt UEFI-Firmware auf der SD-Karte benötigt. Auch für RISC-V ist UEFI erforderlich; außerdem muss die Hardware vom generischen Debian-Kernel unterstützt werden. Die genauen Voraussetzungen unterscheiden sich daher je nach Architektur und Board. Nach dem Boot können die Diagnose-Logs lokal gelesen werden. Das Build-README beschreibt außerdem SSH-Zugriff auf das Live-System. Vor einem produktiven Einsatz sollte man die Hinweise zu Zugangsdaten und Netzwerksicherheit beachten. ## Images herunterladen und starten Die aktuellen ISO-Dateien und Hinweise stehen auf der [Releases-Seite von stupix-build](https://github.com/Maxsander123/stupix-build/releases/latest?ref=blog.rgb-schnitzel.de). Das Image kann auf USB geschrieben, als virtuelle CD eingebunden oder über BMC Virtual Media gestartet werden. Beispiel für Linux: ```bash # sdX unbedingt durch das zuvor identifizierte USB-Gerät ersetzen lsblk sudo dd if=stupix-linux-amd64.iso of=/dev/sdX bs=4M status=progress sync ``` **Achtung:** Der Befehl überschreibt das angegebene Gerät vollständig. Vor dem Ausführen muss geprüft werden, dass `/dev/sdX` tatsächlich der USB-Stick und nicht ein Systemlaufwerk ist. Für einen schnellen Blick ist der Image-Weg gedacht; wer das System anpassen oder selbst bauen möchte, findet im Build-Repository eine Anleitung mit `live-build`. Builds für ARM64 und RISC-V laufen dort über Cross-Build-Unterstützung auf einem amd64-Host. ## Das Skript lässt sich erweitern Das Diagnose-Skript ist separat gehalten. Eigene Skripte können laut README im [stupix-Repository](https://github.com/Maxsander123/stupix?ref=blog.rgb-schnitzel.de) ergänzt und über `auto.sh` aufgerufen oder nach dem Boot manuell gestartet werden. Das Build-Repository enthält die Konfiguration für installierte Pakete, Bootmenü, Init-Dienst und CI-Boot-Tests. Auch die Quelle des Skript-Repositories lässt sich beim Build anpassen. Das ist nützlich, wenn ein Team eine eigene, kontrollierte Kopie des Diagnose-Codes verwenden möchte. Dabei sollte man berücksichtigen, dass Zugangsdaten für private Repository-Quellen laut Dokumentation in die ISO-Konfiguration übernommen werden können. ## Wichtige Sicherheits- und Datenschutzpunkte Stupix ist ein Diagnosewerkzeug mit weitreichendem Einblick in die Hardware. Das Projekt dokumentiert standardmäßig aktiviertes Root-SSH mit dem Passwort `stupix`. **Dieses Standardpasswort muss vor jeder Erreichbarkeit über ein nicht vertrauenswürdiges Netzwerk geändert oder der SSH-Zugang passend abgesichert werden.** Die Diagnose lädt beim Start außerdem Skripte aus dem konfigurierten Repository nach und führt sie aus; verwende daher nur eine Quelle, der du vertraust. Die Logs können Seriennummern, Hardwareinventar, Netzwerkdetails und BMC-Informationen enthalten. Bevor sie geteilt oder in Tickets hochgeladen werden, sollten sensible Werte geprüft und bei Bedarf entfernt werden. Für den Download und den Einsatz in produktiven Umgebungen lohnt außerdem ein Blick auf die aktuelle Dokumentation und Release-Hinweise. ## Fazit Stupix macht eine Reihe gängiger Hardwareprüfungen über ein startbares Live-System zugänglich und hält die Ergebnisse in übersichtlichen Dateien fest. Die Trennung zwischen Live-System-Build und Diagnose-Skripten erleichtert Anpassungen; die Unterstützung für x86-64, ARM64 und RISC-V macht das Projekt auch für unterschiedliche Server- und Boardtypen interessant. **Projekt und Downloads:** - [Stupix Diagnose-Skripte](https://github.com/Maxsander123/stupix?ref=blog.rgb-schnitzel.de) - [Build-System, Dokumentation und Releases](https://github.com/Maxsander123/stupix-build?ref=blog.rgb-schnitzel.de)