Debian Linux auf macOS — OrbStack-Dokumentation

Stand: März 2026 | System: macOS Andreas (192.168.178.72)

Übersicht

Auf dem Mac läuft via OrbStack eine lokale Debian-VM (Bookworm, ARM64) — dieselbe Distribution wie raspip5. Sie dient als Entwicklungs- und Testumgebung sowie als Brücke zwischen macOS und dem Raspberry Pi.

Installation

brew install --cask orbstack        # OrbStack installieren
orb create debian debian            # Debian Bookworm VM anlegen

OrbStack startet beim Mac-Login automatisch.

VM starten / stoppen

orb start debian      # starten
orb stop debian       # stoppen
orb list              # Status anzeigen

Oder über die OrbStack-App in der macOS Menüleiste.

Verbindung

ssh debian-orb        # SSH in die VM (Key-Auth, kein Passwort)
orb run -m debian bash   # Befehl direkt ausführen

SSH-Konfiguration (~/.ssh/config):

Host debian-orb
  HostName 192.168.139.194
  User ak
  IdentityFile ~/.ssh/id_ed25519

Dateiaustausch

Der Mac-Homeverzeichnis ist automatisch in der VM gemountet:

Pfad auf Mac	Pfad in Debian VM
`/Users/ak/`	`/mnt/mac/Users/ak/`
`/Users/ak/Desktop/`	`/mnt/mac/Users/ak/Desktop/`

Kein scp nötig für lokalen Dateiaustausch — direkt lesen/schreiben.

Zusammenarbeit der drei Systeme

macOS (Andreas, 192.168.178.72)
  │
  ├─ ssh debian-orb ──→ Debian VM (lokal, OrbStack)
  │                        │
  │                        └─ ssh raspip5 ──→ raspip5 (192.168.178.199)
  │
  └─ ssh raspip5 ──────────────────────────→ raspip5 direkt

Dateipfade: - Mac → Debian VM: /mnt/mac/Users/ak/ - Mac/VM → raspip5: scp oder ssh

Typische Use-Cases

Aufgabe	Weg
Script lokal testen vor Deployment	In Debian VM entwickeln, dann auf raspip5 deployen
Linux-Tool ohne macOS-Port nutzen	In Debian VM installieren und nutzen
Doku-Sync zu Bear	`python3 /mnt/mac/Users/ak/bear_sync_doku.py`
Gleiche Umgebung wie raspip5	Debian Bookworm ARM64 = identisch

SSH-Keys

Von → Nach	Methode
Mac → Debian VM	`~/.ssh/id_ed25519`
Mac → raspip5	`~/.ssh/id_ed25519`
Debian VM → raspip5	Mac-Key via `/mnt/mac/Users/ak/.ssh/id_ed25519`

OrbStack-Ressourcen

RAM: dynamisch, teilt sich mit macOS
Disk: 1,2 GB aktuell
IP: 192.168.139.194 (nur Mac-intern)
Hostname: debian.orb.local / debian-orb