From aadc03040766f03af0250629fcbb5205bf594938 Mon Sep 17 00:00:00 2001 From: duffyduck Date: Fri, 17 Jul 2026 00:09:30 +0200 Subject: [PATCH] =?UTF-8?q?docs(readme):=20Installations-Schritt=206=20?= =?UTF-8?q?=E2=80=94=20QEMU-Host-Provisionierung?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit qemu-setup.sh laeuft NICHT ueber docker compose (QEMU sitzt auf dem Host, nicht im Container). Neuer optionaler Schritt 6 im Installations-Abschnitt: einmalig `sudo bash host-provisioning/qemu-setup.sh` fuer den Desktop-Workspace (VM-Bauen/ VNC), plus Hinweis auf den noetigen App-Rebuild (neue native Module). Co-Authored-By: Claude Opus 4.8 --- README.md | 31 +++++++++++++++++++++++++++++++ 1 file changed, 31 insertions(+) diff --git a/README.md b/README.md index 5c69c2d..58a3614 100644 --- a/README.md +++ b/README.md @@ -204,6 +204,37 @@ Die Diagnostic-UI hat sechs Top-Tabs: - **Dateien** — alle Dateien aus `/shared/uploads/` mit Multi-Select, Bulk-Download (ZIP) + Bulk-Delete - **Einstellungen** — Reparatur (Container-Restart), Wipe, Sprachausgabe, Whisper, Sprachmodell, Runtime-Config, App-Onboarding (QR), Komplett-Reset +### 6. (Optional) Desktop-Workspace: QEMU auf dem Host + +Nur noetig, wenn ARIA VMs bauen/testen und du sie live in der Desktop-Kachel der +App bedienen koennen sollst (Code-Projekte, z. B. ein Win-3.11-System). **Wird +NICHT von `docker compose` mitinstalliert** — QEMU laeuft direkt auf dem Host +(172.0.2.33), nicht in einem Container, weil dort KVM sitzt und die VNC binden +kann. Einmalig als root: + +```bash +sudo bash host-provisioning/qemu-setup.sh +``` + +Installiert `qemu-system-*` fuer **alle Architekturen** (x86/ARM/MIPS/PPC/SPARC/ +RISC-V), `qemu-utils`, Firmware, `socat`, `imagemagick` und den Helper +`/usr/local/bin/aria-vm`. KVM-Beschleunigung gibt es nur fuer x86-Gaeste; andere +Architekturen laufen emuliert (TCG). Danach testen: + +```bash +aria-vm list +``` + +ARIA steuert VMs dann per `ssh aria-wohnung aria-vm ...` (create/boot/screenshot/ +list/stop). Der VNC-Desktop wird automatisch als RFB-Bytes durch die Bridge/RVS +in die App getunnelt — **kein** Port am Host oeffnen, **kein** websockify/noVNC +auf dem Host noetig (der noVNC-Client liegt in der App). Ohne diesen Schritt +funktioniert alles andere normal; nur die Desktop-Kachel bleibt leer. + +> **App-Rebuild noetig** fuer den Workspace: die neuen nativen Module +> (gesture-handler, reanimated, webview) brauchen nach `npm install` einmalig +> `npm start --reset-cache` + `./gradlew clean`, dann APK neu bauen. + --- ## Proxy — Wie funktioniert das?