macbook-setup/INSTALL.md
rene 6f8ae5263d Add INSTALL.md: Schritt-für-Schritt von ISO bis fertiges System
Abdeckt: Ventoy, Booten, automatische Installation, erster Login,
manuelle Post-Install-Schritte (WireGuard, Synology Drive, Thunderbird,
Brave Sync), MBP 13/16 Unterschiede, Troubleshooting.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-07 21:44:42 +01:00

3.9 KiB

Installation

1. ISO auf Ventoy-Stick kopieren

cp ubuntu-macbook-autoinstall.iso /Volumes/Ventoy/

Falls kein Ventoy-Stick vorhanden: 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 renesetup-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:

cat /tmp/setup-desktop.log

Manuell erneut starten:

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).

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 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:

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

sudo apt install bcmwl-kernel-source
sudo modprobe wl

Bildschirm flackert / kein Bild (MBP 16")

Nvidia Optimus-Problem. Intel als GPU erzwingen:

sudo prime-select intel
sudo reboot

Falls das nicht hilft, Nvidia komplett blacklisten:

sudo cp /tmp/blacklist-nvidia.conf /etc/modprobe.d/
sudo update-initramfs -u
sudo reboot

Lüfter drehen nicht hoch / MacBook wird zu heiß

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

cat ~/.config/autostart/macbook-setup-desktop.desktop

Oder direkt ausführen:

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