Voraussetzungen vor der Installation überprüfen
Persönlich
- Administrationsrechte auf dem Gerät.
- Keine Berührungsängste mit einer Installation, die nicht nur ein paar Klicks benötigt, sondern mehrere Programme benötigt. Die Programm müssen teilweise über die Kommandozeile installiert und konfiguriert werden (Eingabeaufforderung, PowerShell).
Laptop oder PC
- Virtualisierung ist im BIOS/UEFI aktiviert (Intel VT-x oder AMD-V); Anleitung zur Überprüfung im Abschnitt unten.
- Mindestens 8 GB RAM (Arbeitsspeicher), empfohlen 16 GB (es kommt Docker Desktop + WSL2 + OpenHands-Sandbox zum Einsatz) 1
- Mindestens 15 GB freier Speicherplatz auf der Festplatte (C:/Windows), empfohlen 20 GB 2
- Administratorrechte für die Installation (einmalig, für die Installation)
- Internetverbindung mit etwas Bandbreite für die Downloads.
- Mistral-API-Key, siehe separate Anleitung Mistral-Account und API-Key.
Überprüfung ob Virtualisierung im BIOS/UEFI aktiviert ist (Intel VT-x oder AMD-V)
WSL2 (und damit Docker Desktop) braucht Hardware-Virtualisierung. Auf den meisten Laptops ist sie ab Werk aktiv; manche Geräte (besonders mit vorinstalliertem Windows) liefern sie deaktiviert aus.
- Aktivieren im BIOS/UEFI: Beim Start die BIOS-Taste des Herstellers drücken (meist
F2,F10,EntfoderEsc), dann die Option Intel VT-x / Intel Virtualization Technology bzw. AMD-V / SVM Mode unter „Advanced”, „CPU Configuration” o. ä. aktivieren. - In Windows prüfen: Task-Manager öffnen (
Strg+Umschalt+Esc) → Reiter Leistung → CPU: rechts muss „Virtualisierung: Aktiviert” stehen.
Windows
- Gerät/Windows muss während Installation neu gestartet werden.
- Windows 11 (alle Editionen außer S-Mode, siehe unten).
- Funktioniert vermutlich auch mit Windows 10 64-bit (Vorsicht: Für Windows 10 bereits jetzt oder demnächst keine Updates mehr; siehe Abschnitt „Windows-Version” unten).
Info zu Windows S-Mode
Der S-Mode („S-Modus”) ist ein eingeschränkter Windows-Modus, der nur Apps aus dem Microsoft Store zulässt — Docker Desktop lässt sich darin nicht installieren. Er ist auf einigen günstigen Laptops vorinstalliert. Der Modus lässt sich unter Einstellungen → System → Aktivierung einmalig und kostenlos verlassen („Beim Verlassen des S-Modus speichern”); das Windows selbst bleibt, nur die Store-Beschränkung fällt. Danach gilt die Anleitung wie für jedes andere Windows.
Wofür der Speicherplatz gebraucht wird
Die Installation besteht aus mehreren Komponenten, die sich auf der Windows-Festplatte (C:) verteilen (Messwerte einer Testinstallation):
| Komponente | Belegung | Anmerkung |
|---|---|---|
| Docker Desktop (Programm) | ca. 3,3 GB | inkl. Docker-CLI, Compose, Backend |
| WSL2-System (Kernel, Integration) | < 0,1 GB | |
| Ubuntu (WSL-Distro) | ca. 2,3 GB | wächst mit installierten Updates und Paketen |
| OpenHands/Agent-Canvas-Container-Image | ca. 6,1 GB | der größte Einzelposten; Download ca. 1,6 GB (komprimiert) |
Arbeitsordner (~/agent, State-Ordner) | < 10 MB | wächst mit Nutzung (Sessions, Konfiguration) |
| Summe nach Installation | ca. 12 GB |
Hinweis zum Docker-Speicherplatz
Der Docker-Speicher ist eine virtuelle Festplatte, die nur wächst und gelöschte Inhalte nicht automatisch an Windows zurückgibt. Bei jedem Update des Container-Images (neue OpenHands-Version) wird kurzzeitig zusätzlich Platz für das neue Image benötigt. Die genannten 15 GB Minimum berücksichtigen diesen Puffer; mit 20 GB bleibt genug Luft für Updates und normale Nutzung. Freien Platz prüfen: Einstellungen → System → Speicher oder im Explorer → Dieser PC. Siehe weiter unten, wie auch hier nicht mehr benötigter Speicherplatz wieder freigegeben werden kann.
Speicherplatz über Docker Desktop wieder freigeben
Wenn Docker-Speicher voller Image-Reste wieder freigegeben werden soll, geht das über die mitgelieferte Bereinigungsfunktion. Klickstrecke:
- Docker Desktop öffnen (Symbol in der Taskleiste, neben der Uhr).
- Oben rechts auf das Käfersymbol für die Problembehandlung („Troubleshoot”) klicken.
- „Clean / Purge data” auswählen und bestätigen — das entfernt alle Container und Images aus dem Docker-Speicher. Docker Desktop startet danach neu.
- OpenHands anschließend mit dem
docker run-Befehl aus Schritt 3 der Anleitung OpenHands auf Windows-Laptop neu starten; das Image wird dabei automatisch neu heruntergeladen (ca. 1,6 GB).
Die eigenen Daten bleiben dabei unangetastet: Die Ordner agent und agent-openhands-state liegen außerhalb von Docker auf der Windows-Festplatte — Einstellungen, API-Key und die Sitzungsdaten (Chats) gehen nicht verloren. Nur das heruntergeladene Container-Image selbst muss neu geladen werden.
Wer nur ein einzelnes, nicht mehr benötigtes Image entfernen will, ohne alles zu bereinigen: in Docker Desktop in der Seitenleiste Images öffnen → am betreffenden Image das Papierkorb-Symbol klicken. Der so frei gegebene Platz wird von Docker intern wiederverwendet (z. B. beim nächsten Image-Download); die Größe der Docker-Festplattendatei auf C: ändert sich dabei nicht sofort.
Footnotes
-
Bzgl. Windows: Docker Desktop stellt WSL2 standardmäßig ca. 50 % des Arbeitsspeichers zur Verfügung; OpenHands selbst bringt den App-Server und pro Session einen weiteren Container unter. Mit 8 GB läuft der Stack grundsätzlich, kann aber beim Parallelbetrieb mehrerer Sessions oder großen Projekten eng werden. 16 GB sind entspannt. ↩
-
Gemessen auf der Referenz-Installation des Seminars (Windows 11-VM, Stand Oktober 2026); individuelle Abweichungen je nach Windows-Version und Updates sind möglich. ↩