Install SteamOS from an intact recovery archive using Debian Live and Ventoy; macOS, Linux and Windows preparation guides.
  • Shell 59.3%
  • Python 40.7%
Find a file
2026-09-18 11:01:39 +02:00
docs Add portable SteamOS recovery carrier and cross-platform preparation guides 2026-09-18 10:30:13 +02:00
payload Add portable SteamOS recovery carrier and cross-platform preparation guides 2026-09-18 10:30:13 +02:00
src Add portable SteamOS recovery carrier and cross-platform preparation guides 2026-09-18 10:30:13 +02:00
tests Add portable SteamOS recovery carrier and cross-platform preparation guides 2026-09-18 10:30:13 +02:00
tools Add portable SteamOS recovery carrier and cross-platform preparation guides 2026-09-18 10:30:13 +02:00
.gitattributes Add portable SteamOS recovery carrier and cross-platform preparation guides 2026-09-18 10:30:13 +02:00
.gitignore Add portable SteamOS recovery carrier and cross-platform preparation guides 2026-09-18 10:30:13 +02:00
install-ventoy-steamos-usb.sh Add portable SteamOS recovery carrier and cross-platform preparation guides 2026-09-18 10:30:13 +02:00
NOTICE.md Add portable SteamOS recovery carrier and cross-platform preparation guides 2026-09-18 10:30:13 +02:00
README.md Update download guide for public repository access 2026-09-18 11:01:39 +02:00
SHA256SUMS Add portable SteamOS recovery carrier and cross-platform preparation guides 2026-09-18 10:30:13 +02:00
steamos-payload.zip Add portable SteamOS recovery carrier and cross-platform preparation guides 2026-09-18 10:30:13 +02:00

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:

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:

  1. Eine neue Ventoy-Installation löscht den ausgewählten USB-Stick.
  2. Später löscht run-steamos-installer.sh --disk … all das 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

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.