Claude-Pi (Raspberry Pi 4B)

Headless Dev-Workstation auf einem Raspberry Pi 4B. Das Gerät dient als primäre Entwicklungsmaschine im Heimnetz und läuft Claude Code dauerhaft in tmux-Sessions.

Hardware

Komponente	Details
Board	Raspberry Pi 4 Model B, 4 GB RAM
Gehäuse	Argon Case (aktive Kühlung, konfiguriert via argon-config)
Storage	USB-SSD am blauen USB-3.0-Port — keine SD-Karte
OS	Raspberry Pi OS Lite 64-bit (Debian Trixie)
Betrieb	Headless (SSH only)
Netzwerk	UniFi (UDM Pro), statische IP im LAN
IP	10.10.10.X (LAN) + Tailscale VPN

Die Entscheidung für Pi OS Lite statt DietPi fiel, weil bei SSD-Boot der RamLog-Vorteil von DietPi irrelevant ist und die maximale ARM64-Kompatibilität wichtiger ist als minimaler Footprint.

Repository

github.com/SWATPeaceKeeper/claude-pi

Das Repo enthält alle Dotfiles, Konfigurationsdateien und das Bootstrap-Skript. Es ist der einzige Weg, ein neues System in den gleichen Zustand zu versetzen.

claude-pi/
├── bootstrap.sh            # Symlinkt alles an die richtigen Stellen
├── bin/update-devtools     # Aktualisiert kubectl, helm, terraform, tofu
├── claude/                 # Claude Code Konfiguration
├── git/gitconfig           # Git-User + Credential-Helper
├── tmux/tmux.conf          # Headless-optimierte tmux-Defaults
├── bash/bashrc_custom.sh   # PATH-Exports (gesourced von .bashrc)
├── boot/config-additions.txt   # Referenz: /boot/firmware/config.txt
├── ssh/sshd_hardening.conf     # Referenz: SSH-Härtung
└── cron/update-devtools.cron   # Referenz: Wöchentlicher Cronjob

Das bootstrap.sh-Skript ist idempotent — es kann beliebig oft ausgeführt werden, ohne Seiteneffekte. Bestehende Dateien werden als .bak gesichert.

Einbindung ins Homelab

Der Pi ist per LAN und Tailscale VPN mit dem Homeserver verbunden und hat direkten Zugriff auf alle internen Dienste. Er teilt keine Netzwerkverbindung mit homelab-external, ist aber über Tailscale erreichbar.

Inhalt

Seite	Beschreibung
Setup	OS-Installation, SSH-Härtung, Netzwerk, Bootstrap
Dev-Tools	Installierte Tools, Versionsmanager, update-devtools
Claude Code	Claude Code Konfiguration, Plugins, Statusline