From e6b1365422622163aef86c64aed4ece33b99da0c Mon Sep 17 00:00:00 2001
From: rene <mail@motocamp.de>
Date: Sat, 7 Mar 2026 21:44:42 +0100
Subject: [PATCH] =?UTF-8?q?Add=20INSTALL.md:=20Schritt-f=C3=BCr-Schritt=20?=
 =?UTF-8?q?von=20ISO=20bis=20fertiges=20System?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Abdeckt: Ventoy, Booten, automatische Installation, erster Login,
manuelle Post-Install-Schritte (WireGuard, Synology Drive, Thunderbird,
Brave Sync), MBP 13/16 Unterschiede, Troubleshooting.
---
 INSTALL.md | 149 +++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 149 insertions(+)
 create mode 100644 INSTALL.md

diff --git a/INSTALL.md b/INSTALL.md
new file mode 100644
index 0000000..54ddac5
--- /dev/null
+++ b/INSTALL.md
@@ -0,0 +1,149 @@
+# Installation
+
+## 1. ISO auf Ventoy-Stick kopieren
+
+```bash
+cp ubuntu-macbook-autoinstall.iso /Volumes/Ventoy/
+```
+
+Falls kein Ventoy-Stick vorhanden: [ventoy.net](https://www.ventoy.net/) — beliebigen USB-Stick mit Ventoy formatieren, dann ISO einfach draufkopieren.
+
+## 2. MacBook booten
+
+1. USB-Stick einstecken
+2. MacBook einschalten, **Alt-Taste (⌥)** gedrückt halten
+3. "EFI Boot" auswählen
+4. Im Ventoy-Menü die `ubuntu-macbook-autoinstall.iso` wählen
+5. GRUB zeigt "Ubuntu MacBook AutoInstall" — startet nach 10 Sekunden automatisch
+
+## 3. Automatische Installation
+
+Ab hier läuft alles ohne Eingreifen:
+
+- Ubuntu 24.04 Server wird installiert (LVM, User `rene`)
+- Pakete werden installiert (Xubuntu-Desktop, Brave, Treiber, Tools)
+- `setup-base.sh` konfiguriert Tastatur, Lüfter, Nvidia, Locale, Services
+- Ein Autostart-Eintrag für `setup-desktop.sh` wird angelegt
+
+**Dauer:** ca. 30-60 Minuten je nach Internetgeschwindigkeit.
+
+Nach Abschluss startet das MacBook automatisch neu.
+
+## 4. Erster Desktop-Login
+
+Anmelden als `rene` — `setup-desktop.sh` startet automatisch und installiert:
+
+| Was | Details |
+|-----|---------|
+| oh-my-zsh | Inkl. zsh als Standard-Shell |
+| Claude Code | via npm global |
+| PrusaSlicer | AppImage nach ~/Applications |
+| Dotfiles | nvim, micro, oh-my-zsh custom, heic-scripts |
+| XFCE Energie | AC: Bildschirm bleibt an / Akku: aus nach 10 Min |
+
+Der Autostart-Eintrag entfernt sich nach erfolgreichem Durchlauf selbst.
+
+**Log prüfen:** Falls etwas fehlschlägt:
+```bash
+cat /tmp/setup-desktop.log
+```
+
+**Manuell erneut starten:**
+```bash
+curl -fsSL https://git.motocamp.de/rene/macbook-setup/raw/branch/main/setup-desktop.sh | bash
+```
+
+## 5. Manuelle Schritte
+
+### WireGuard
+
+Config-Datei muss separat vorliegen (nicht im Repo).
+
+```bash
+sudo cp wg0.conf /etc/wireguard/
+sudo systemctl enable --now wg-quick@wg0
+```
+
+Danach ist das Heimnetz erreichbar (10.47.11.0/24 via 10.13.13.x).
+
+### Synology Drive Client
+
+1. `.deb` von [synology.com](https://www.synology.com/de-de/dsm/feature/drive) herunterladen
+2. `sudo dpkg -i synology-drive-client-*.deb`
+3. Starten, mit DiskStation verbinden (10.47.11.10 oder dsm.motocamp.de)
+
+### Thunderbird
+
+1. Thunderbird starten
+2. Profil aus Synology Drive einbinden (vorheriges Backup)
+3. IMAP: 10.47.11.10 (nach WireGuard-Verbindung)
+
+### Brave Browser
+
+1. Brave starten
+2. Einstellungen → Brave Sync → Sync-Kette beitreten
+
+## 6. Modell: MBP 13" vs 16"
+
+Die `user-data` ist standardmäßig auf **MBP 13"** eingestellt. Für **MBP 16"** vor dem ISO-Bau in `user-data` ändern:
+
+```yaml
+# Zeile in late-commands:
+- curtin in-target --target=/target -- bash -c '... setup-base.sh | bash -s -- 16'
+#                                                  hier: 13 → 16 ^^^
+```
+
+MBP 16" bekommt zusätzlich:
+- `nvidia-driver-535` + `prime-select intel`
+- Aggressivere Lüftersteuerung (`mbpfan-16.conf`)
+- `blacklist-nvidia.conf` in `/tmp` (optional aktivieren)
+
+## Troubleshooting
+
+### WLAN geht nicht nach Installation
+
+Broadcom BCM4360 braucht den proprietären Treiber. Falls er nicht installiert wurde:
+```bash
+sudo apt install bcmwl-kernel-source
+sudo modprobe wl
+```
+
+### Bildschirm flackert / kein Bild (MBP 16")
+
+Nvidia Optimus-Problem. Intel als GPU erzwingen:
+```bash
+sudo prime-select intel
+sudo reboot
+```
+
+Falls das nicht hilft, Nvidia komplett blacklisten:
+```bash
+sudo cp /tmp/blacklist-nvidia.conf /etc/modprobe.d/
+sudo update-initramfs -u
+sudo reboot
+```
+
+### Lüfter drehen nicht hoch / MacBook wird zu heiß
+
+```bash
+# mbpfan läuft?
+sudo systemctl status mbpfan
+
+# Temperaturen prüfen
+sensors
+
+# temp-watch.sh manuell starten
+sudo /usr/local/bin/temp-watch.sh
+```
+
+### setup-desktop.sh startet nicht beim Login
+
+Autostart-Eintrag manuell prüfen/anlegen:
+```bash
+cat ~/.config/autostart/macbook-setup-desktop.desktop
+```
+
+Oder direkt ausführen:
+```bash
+curl -fsSL https://git.motocamp.de/rene/macbook-setup/raw/branch/main/setup-desktop.sh | bash
+```