- Shell 59.3%
- Python 40.7%
| docs | ||
| payload | ||
| src | ||
| tests | ||
| tools | ||
| .gitattributes | ||
| .gitignore | ||
| install-ventoy-steamos-usb.sh | ||
| NOTICE.md | ||
| README.md | ||
| SHA256SUMS | ||
| steamos-payload.zip | ||
SteamOS über Debian Live installieren
Ein Ventoy-Stick bootet ein unverändertes Debian Stable Live. Darauf liegt
zusätzlich das unveränderte SteamOS-Recovery-Archiv. Der Launcher entpackt
bei Bedarf dessen rootfs-A und startet den angepassten SteamOS-Installer in
einer Chroot. So wird SteamOS installiert, ohne die grafische Recovery-Umgebung
von Valve booten zu müssen.
Das wurde auf einem x86-64-Zielrechner erfolgreich installiert und gebootet. Es ist keine Zusage, dass SteamOS jede PC-Hardware unterstützt.
Welcher Weg passt?
| Vorbereitung auf | Werkzeug | Anleitung |
|---|---|---|
| macOS | Eigenständiges Shellskript, Python 3.9+, Docker für eine neue Ventoy-Installation | macOS |
| Linux | Dasselbe Shellskript, Python 3.9+, Linux-Systemwerkzeuge; kein Docker nötig | Linux |
| Windows | Offizielles Ventoy-GUI und fertiges Payload-ZIP, Kopieren mit PowerShell | Windows |
Die .sh-Datei ist kein natives Windows-Programm. Windows nutzt denselben
Installer-Payload, aber einen anderen Weg zum Vorbereiten des USB-Sticks.
Danach gilt für alle drei Wege: Debian booten und SteamOS installieren.
1. Projekt herunterladen
Auf der Repositoryseite über Code → ZIP herunterladen das gesamte Projekt holen und entpacken. Alternativ per HTTPS klonen:
git clone https://git.miskam.xyz/mxm/steamos-install.git
cd steamos-install
Das Repository ist öffentlich. Clone und Downloads funktionieren ohne Anmeldung.
Wer nur den Stick vorbereiten möchte, benötigt keinen Build und keine Tests:
- macOS/Linux: install-ventoy-steamos-usb.sh herunterladen, in der Dateiansicht Raw/Download verwenden, nicht die HTML-Seite speichern.
- Windows: steamos-payload.zip herunterladen.
- SHA256SUMS enthält die Prüfsummen dieser beiden Projektdateien.
2. Drei separate Downloads
| Download | Was du auswählst |
|---|---|
| Offizielles SteamOS-Recovery-Archiv | Steam Deck Recovery als .img.bz2; Bedingungen auf der Downloadseite selbst prüfen/akzeptieren. Nicht entpacken. |
| Debian Stable Live | amd64, bevorzugt standard, als Live-ISO. Kein netinst und kein ARM64-ISO, auch bei Vorbereitung auf einem Apple-Silicon-Mac. |
| Ventoy | Für macOS/Linux das Linux-Archiv .tar.gz; für Windows das Windows-ZIP. |
Die Anleitungen verwenden folgende vereinfachte lokale Namen. Du kannst die Downloads unverändert umbenennen oder in den Befehlen ihre echten Namen einsetzen:
downloads/
steamdeck-recovery.img.bz2
debian-live-amd64.iso
ventoy-linux.tar.gz # macOS/Linux
ventoy-windows.zip # Windows
Unterstützt wird das Bzip2-Archiv .img.bz2. Ein ZIP oder bereits entpacktes
Image wird nicht durch bloßes Umbenennen kompatibel.
Verwende die Prüfsummen der Anbieter. Debian liefert auch signierte Prüfsummenlisten: Verifikation. Ein selbst berechneter Hash belegt die unveränderte Kopie, nicht die Echtheit des ursprünglichen Downloads. Es gibt bewusst keinen fest eingebauten SteamOS-Downloadlink oder automatisch akzeptierte Downloadbedingungen.
Voraussetzungen und Datenverlust
- USB-Stick, 32 GB empfohlen, mit Platz für Live-ISO, komprimiertes Archiv und entpackten Rootfs-Cache; derzeit benötigt dieser Cache etwa 5 GiB. Das Skript ermittelt die echte Größe aus dem Archiv statt sie festzuschreiben.
- Ventoys große Datenpartition als exFAT verwenden. FAT32 ist wegen der maximalen Dateigröße für den Rootfs-Cache ungeeignet.
- Zielrechner: x86-64/amd64 mit UEFI, Tastatur und ausreichend großem Zielmedium.
- Downloads und Arbeitsverzeichnis beim erstmaligen Vorbereiten nicht auf dem USB-Ziel speichern.
Zwei getrennte Vorgänge können Daten löschen:
- Eine neue Ventoy-Installation löscht den ausgewählten USB-Stick.
- Später löscht
run-steamos-installer.sh --disk … alldas ausgewählte SteamOS-Ziellaufwerk vollständig.
Die macOS/Linux-Vorbereitung erkennt bestehende Ventoy-Medien und gleicht Bootcode
und Dateien ab. Ein erneuter gleicher Aufruf formatiert deren Datenpartition
nicht neu. Das bedeutet nicht, dass der eigentliche SteamOS-Installationslauf
all eine nichtdestruktive Wiederholung wäre.
Archiv und Skripte aktualisieren
macOS/Linux: Dasselbe Vorbereitungskommando mit dem neuen Archiv und ggf. dem neuen Skript wiederholen. Richtige Dateien werden anhand ihres Inhalts erkannt; unvollständige Kopien werden vervollständigt bzw. ersetzt.
Windows: Neues Payload-ZIP erneut ins Wurzelverzeichnis des Sticks entpacken und die Kopier-/Prüfsummenschritte in der Windows-Anleitung wiederholen. Kein erneutes Install in Ventoy2Disk. Diese manuelle Kopie ist nicht der atomare, zustandsbasierte Kopiermechanismus des macOS/Linux-Skripts.
SteamOS/recovery.img.bz2 bleibt immer das originale komprimierte Archiv.
Ein neuer Archivhash bekommt einen neuen Cache-Dateinamen. Alte Caches bleiben
liegen und können bei Platzbedarf gezielt entfernt werden, wenn kein Installer
läuft. Eine spätere SteamOS-Version kann zusätzliche Anpassungen erfordern.
Entwicklung und Teststatus
- Entwicklung, Build und Tests
- Bekannte Besonderheiten und Fehlerdiagnose
- Herkunft und noch offener Lizenzstatus
Am 18.09.2026 wurde nach Vorbereitung auf macOS die Installation aus Debian Live
und der anschließende Start von SteamOS vom Benutzer bestätigt. Verwendet wurden
Debian Live 13.7.0 amd64 standard, Ventoy 1.1.17 und das Recovery-Archiv
steamdeck-oobe-repair-20260707.10-3.8.14.img.bz2. Diese Namen dokumentieren den
Test, sie sind keine Empfehlung oder Behauptung zur jeweils neuesten Version.
Windows ist als nativer manueller Ablauf dokumentiert, aber noch nicht auf einem
Windows-Rechner end-to-end getestet. Unit-Tests ersetzen keinen Hardwaretest.