2026-03-14 08:15:31 +01:00
# macbook-setup - Projektkontext fuer Claude Code
## Projekt-Uebersicht
Setup-Skripte fuer Ubuntu 24.04 auf alten MacBook Pros (Xubuntu-Desktop).
Repo liegt auf Gitea: git.motocamp.de/rene/macbook-setup
## Hardware
| Bezeichnung | Modell | CPU | GPU | Display | Besonderheiten |
|---|---|---|---|---|---|
| m16 | MBP 15" Mid 2014 | i7-4980HQ | Intel HD 5200 + AMD Radeon R9 M370X | Retina (2x) | AMD muss geblockt werden (amdgpu blacklist) |
| m13 | MBP 13" Late 2013 | - | nur Intel | Retina (2x) | - |
- WLAN: Broadcom BCM4360 (kein Treiber im Ubuntu-Installer!)
- m16 erreichbar per `ssh rene@m16.local` , sudo ohne Passwort konfiguriert
## Netzwerk
- Subnetz: 10.47.11.0/24
- Fritz!Box: 10.47.11.1
- Synology: 10.47.11.10 (dsm.motocamp.de)
## Installations-Workflow (WICHTIG)
1. **Stock Ubuntu 24.04 Server ISO** auf USB-Stick (dd) - **NICHT** das custom ISO (build-iso.sh)!
2. Interaktiv installieren: Sprache, Tastatur, **WLAN im Installer einrichten** , User `rene` , LVM
3. Neustarten, einloggen als rene
4. `curl -fsSL https://git.motocamp.de/rene/macbook-setup/raw/branch/main/setup-base.sh | sudo bash -s -- 16`
5. Neustarten, in XFCE einloggen
6. `curl -fsSL https://git.motocamp.de/rene/macbook-setup/raw/branch/main/setup-desktop.sh | bash`
**Warum kein custom ISO:** Broadcom-WLAN hat keinen Treiber in der Live-Umgebung.
Der interaktive Installer hat einen eingebauten WLAN-Schritt. Ohne Netzwerk koennen
die Setup-Skripte nicht heruntergeladen werden.
## Arbeitsweise
- Rene verbindet sich per SSH auf das MacBook und fuehrt Befehle dort aus
- Wenn Befehle auf dem MacBook noetig sind: per `ssh rene@<ip>` verbinden und dort ausfuehren (statt den User bitten, Befehle abzutippen)
## Paketquellen-Zuordnung
- **apt:** System-Pakete, xubuntu-desktop, Thunderbird, KeePassXC, default-jre etc.
2026-03-14 09:49:54 +01:00
- **Snap:** FreeCAD, LibreOffice (wegen "benutzerdefinierte Installation nicht abgeschlossen" Bug bei .deb), Bitwarden
2026-03-14 08:15:31 +01:00
- **Flatpak:** Brave Browser (wegen SIGTRAP/int3 Crash bei .deb auf aelterer HW), PrusaSlicer
- flatpak muss in setup-base.sh (root) installiert werden, nicht in setup-desktop.sh (user)
## Geloeste Probleme (Lessons Learned)
### Brave Browser
- .deb Version crasht mit SIGTRAP (int3) auf aelterer Hardware
- AppArmor `apparmor_restrict_unprivileged_userns=1` war NICHT die Ursache
- Loesung: Flatpak verwenden
### LibreOffice
- .deb Version zeigt "benutzerdefinierte Installation nicht abgeschlossen"
- Loesung: Snap verwenden
- default-jre Paket noetig (behebt "javaldx failed" in Writer)
### HiDPI / Retina Display
- GDK WindowScalingFactor=2 + DPI=96 (NICHT 128!)
- Cursor-Groesse: 48
- xfwm4: Default-xhdpi Theme
- XFCE Compositor deaktivieren
- xfce4-display-settings deaktivieren (verursacht Endlosschleife)
### Tastatur
2026-03-14 10:52:27 +01:00
- iso_layout=1 + de (mit Dead Keys, NICHT nodeadkeys) + lv3:lalt_switch
- nodeadkeys verhindert Akzent-Kombination (´
2026-03-14 08:15:31 +01:00
- XFCE Keyboard-Override deaktivieren (XkbDisable)
### Netzwerk & WLAN
- NetworkManager statt netplan fuer WLAN
- WLAN-Config beim netplan-zu-NM Umstieg erhalten
- systemd-networkd-wait-online deaktivieren
- cloud-init deaktivieren nach Installation
2026-03-15 09:36:48 +01:00
- /etc/hosts: dsm.motocamp.de → 10.47.11.10 (Synology direkt), git.motocamp.de → 10.47.11.23 (NPM/macvlan, da Gitea hinter Reverse Proxy)
2026-03-14 08:15:31 +01:00
### WireGuard VPN
- Konfiguration via NetworkManager .nmconnection (nicht wg-quick)
- DNS + dns-search direkt im NM-Profil
- **Key-Verwechslung:** m16/m13 hatten eigenen PublicKey als Peer-PublicKey eingetragen. NM zeigt keinen Fehler, wg show zeigt einfach keine Peers. Immer pruefen: local public key darf NICHT gleich dem Peer-PublicKey sein.
- Server-PublicKey gegen funktionierende Clients verifizieren
### WireGuard Server-Referenz
- Server: 24.134.39.137:443 (VPS, Interface ens3)
- Server-PublicKey: mp0YKEjsUbnld3aTAnF6cSzTfixhZETQCoKiFHIcF30=
- Peer-IPs: .2=iPhoneR, .3=iPhoneM, .4=iPadR, .5=iPadM, .6=m1, .7=m16, .8=m13
- DNS im VPN: 10.47.11.20 (Fritz!Box), 10.47.11.1 (Gateway)
- Server macht NAT/Masquerade ueber ens3
2026-03-15 09:50:05 +01:00
### EFI / Boot
- auto-boot EFI-Variable auf false setzen: verhindert automatischen Start beim Anstecken des Netzteils
- Variable: /sys/firmware/efi/efivars/auto-boot-7c436110-ab2a-4bbb-a880-fe41995c9f82
2026-03-14 08:15:31 +01:00
### Setup-Skripte
- macOS-Installer hinterlaesst macOS-sudoers: setup-base.sh ersetzt sie durch Linux-Standard
- setup-desktop.sh: set -e entfernt, Unicode durch ASCII ersetzt
- setup-desktop.sh Autostart braucht Terminal-Fenster (xfce4-terminal) fuer interaktive Eingaben
- setup.sh: read von /dev/tty bei curl|bash
- Sleep/Suspend waehrend Installation verhindern
- DPMS gestaffelt: 5/6/7 Min (Blank/Sleep/Off)
2026-03-15 16:34:45 +01:00
### GNOME 48 Panel hell trotz Dark-Mode (Asahi)
- Panel bleibt hell, egal ob color-scheme auf prefer-dark steht (sowohl native Top-Bar als auch Dash to Panel)
- Dash-to-Panel custom-bg macht Panel dunkel, aber Schrift auch dunkel (unlesbar)
- Loesung: user-theme Extension + minimales DarkPanel Shell-Theme (~/.local/share/themes/DarkPanel/gnome-shell/gnome-shell.css)
- **Stolperstein:** Extension muss explizit aktiviert werden (`gnome-extensions enable user-theme@...` ) — gsettings allein reicht nicht
- gnome-shell-extension-user-theme muss per dnf installiert sein
2026-03-14 08:15:31 +01:00
### Zsh & Tools
- oh-my-zsh, Powerlevel10k, zsh-syntax-highlighting, MesloLGS NF Font
- PlatformIO via pipx
- h2j (HEIC-Konverter), zoxide, micro
2026-03-15 11:31:24 +01:00
- Terminal-Tools (apt): bat, eza, fd-find, fzf, ripgrep, tldr, ncdu, duf
- Ubuntu: fd heisst `fdfind` , bat heisst `batcat` — Aliases in .zshrc gesetzt
- `tools` Alias zeigt Cheat-Sheet mit allen Befehlen, Aliases und Skripten
2026-03-14 08:15:31 +01:00
- gitcheck Alias funktioniert in interaktiver Shell (nicht via `zsh -l -c` , das ist normal)
2026-03-15 11:31:24 +01:00
- Powerlevel10k Instant Prompt: `POWERLEVEL9K_INSTANT_PROMPT=quiet` muss VOR dem source stehen, nicht in .p10k.zsh (wird sonst ueberschrieben)
### asciiquarium
- benoetigt Perl-Modul Term::Animation (nicht in apt verfuegbar)
- Abhaengigkeiten: libcurses-perl (apt) + Term::Animation (CPAN)
2026-03-14 08:15:31 +01:00
## Autoinstall (archiviert, nicht mehr verwendet)
- YAML-Heredocs brechen den Parser: printf mit \n verwenden
- Kernel-Parameter-Syntax fuer autoinstall dokumentiert
- Wurde verworfen wegen fehlendem WLAN-Treiber im Live-System
