macbook-setup/CLAUDE.md

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.
• Snap: FreeCAD, LibreOffice (wegen "benutzerdefinierte Installation nicht abgeschlossen" Bug bei .deb), Bitwarden
• 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

• iso_layout=1 + de (mit Dead Keys, NICHT nodeadkeys) + lv3:lalt_switch
• nodeadkeys verhindert Akzent-Kombination (´e statt é)
• 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
• /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)

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

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

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)

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)
• CSS nutzt @media (prefers-color-scheme: dark) damit Panel im Light-Mode wieder dem System folgt
• 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

Zsh & Tools

• oh-my-zsh, Powerlevel10k, zsh-syntax-highlighting, MesloLGS NF Font
• PlatformIO via pipx
• h2j (HEIC-Konverter), zoxide, micro
• 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
• gitcheck Alias funktioniert in interaktiver Shell (nicht via zsh -l -c, das ist normal)
• 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)

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