macbook-setup/INSTALL.md

# 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

Die Autoinstall installiert Ubuntu 24.04 Server (LVM, User `rene`). Je nach Netzwerk und Mirrors dauert das 10-30 Minuten.

Nach Abschluss erscheint cloud-init-Output mit SSH Host Key Fingerprints und der Login-Prompt:
```
Cloud-init v. ... finished ... Datasource DataSourceNone.
m16 login:
```

**Enter drücken**, dann als `rene` anmelden.

## 4. Prüfen ob setup-base.sh gelaufen ist

`setup-base.sh` sollte in den Autoinstall `late-commands` gelaufen sein. Prüfen:

```bash
dpkg -l | grep xubuntu-desktop
```

### Fall A: xubuntu-desktop ist installiert

Desktop starten:
```bash
sudo systemctl start lightdm
```
Weiter mit **Schritt 5**.

### Fall B: xubuntu-desktop fehlt

`setup-base.sh` manuell ausführen (MBP 13" oder 16"):
```bash
curl -fsSL https://git.motocamp.de/rene/macbook-setup/raw/branch/main/setup-base.sh | sudo bash -s -- 16
```
**Dauer:** ca. 20-40 Minuten (Xubuntu-Desktop, Brave, Treiber, etc.)

Danach neu starten:
```bash
sudo reboot
```

## 5. Erster Desktop-Login

Nach Reboot erscheint LightDM. Anmelden als `rene`.

`setup-desktop.sh` startet automatisch via Autostart 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.

**Falls setup-desktop.sh nicht automatisch startet**, manuell ausführen:
```bash
curl -fsSL https://git.motocamp.de/rene/macbook-setup/raw/branch/main/setup-desktop.sh | bash
```

**Log prüfen:**
```bash
cat /tmp/setup-desktop.log
```

## 6. 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

## 7. 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" (Mid 2014, Intel + AMD Radeon R9 M370X) bekommt zusätzlich:
- AMD Radeon geblockt (`blacklist-radeon.conf`) — nur Intel i915 nutzen
- XFCE Compositor deaktiviert (keine GPU-Beschleunigung)
- Display-Skalierung 2x / DPI 168 (Retina)
- `xfce4-display-settings` deaktiviert (öffnet sich sonst in Endlosschleife)
- Aggressivere Lüftersteuerung (`mbpfan-16.conf`)

## 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
```

### WLAN "Device not managed"

NetworkManager verwaltet das WLAN nicht, weil netplan/cloud-init es konfiguriert:
```bash
# Prüfen
cat /etc/netplan/*.yaml
cat /etc/NetworkManager/NetworkManager.conf

# Fix: NetworkManager als Renderer setzen
echo -e "network:\n  version: 2\n  renderer: NetworkManager" | sudo tee /etc/netplan/01-network-manager.yaml
sudo rm -f /etc/netplan/50-cloud-init.yaml
sudo netplan apply
```

### Bildschirm flackert / Grafikartefakte (MBP 16")

Das MBP 16" hat eine AMD Radeon R9 M370X die Probleme macht. AMD-GPU komplett blacklisten:
```bash
echo -e "blacklist radeon\nblacklist amdgpu" | sudo tee /etc/modprobe.d/blacklist-radeon.conf
sudo update-initramfs -u
sudo reboot
```

Falls `xfce4-display-settings` sich in Endlosschleife öffnet:
```bash
sudo mv /usr/bin/xfce4-display-settings /usr/bin/xfce4-display-settings.bak
```

### 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
```

### Boot hängt (wartet auf Netzwerk)

```bash
sudo systemctl disable systemd-networkd-wait-online.service
sudo reboot
```

### setup-desktop.sh manuell ausführen

```bash
curl -fsSL https://git.motocamp.de/rene/macbook-setup/raw/branch/main/setup-desktop.sh | bash
```