Arc OS Docs Open in app →

Local Bridge — macOS-Setup

macOS-spezifische Installationsanleitung. Allgemeinen Überblick, Voraussetzungen, Fehler, Sicherheitsmodell und Diagnose findest du im Local Bridge — Setup Guide.

Gesamtdauer: ~60 Sekunden – vorausgesetzt, der Token wurde bereits kopiert.

Wähle zuerst deinen Chip

Dein Mac Klick diesen Button im CRM Diese Datei erhältst du
Apple Silicon (M1 / M2 / M3 / M4 / M5) macOS (Apple Silicon) bridge-darwin-arm64.tar.gz (~50 MB)
Intel (Mac vor 2020) macOS (Intel) bridge-darwin-x64.tar.gz (~50 MB)

Nicht sicher, welchen Chip du hast? Klicke auf das 🍎-Logo (oben links) → Über diesen Mac → suche nach „Chip: Apple M1/M2/M3/M4/M5" (Apple Silicon) oder „Prozessor: Intel Core …" (Intel). Im Zweifel: Apple Silicon – jeder Mac, der seit November 2020 verkauft wurde.

Die folgenden Schritte sind für beide Chips identisch. Ersetze einfach arm64 ↔ x64 in Ordner- und Binärnamen.

1. Herunterladen

Im CRM: Einstellungen → Integrationen → Bridge Setup → 🍎 macOS (Apple Silicon) (oder 🍏 für Intel).

Safari lädt bridge-darwin-arm64.tar.gz herunter und entpackt es automatisch nach ~/Downloads/bridge-darwin-arm64/.

🎞️ GIF-Platzhalter — media/bridge/macos-download.gif Aufnahme-Spezifikation: 8-Sekunden-Bildschirmaufnahme – Cursor klickt auf 🍎-Button → Safari-Fortschrittsbalken füllt sich → Ordner erscheint im Finder.

Der Ordner enthält:

bridge-darwin-arm64/
├── bridge-darwin-arm64    ← the binary
├── install.sh             ← shell script (terminal-friendly)
└── install.command        ← Finder-friendly launcher

2. Installer ausführen

Einfacher Weg (Finder, kein Terminal)

🎞️ GIF-Platzhalter — media/bridge/macos-rightclick-open.gif Aufnahme-Spezifikation: 12-Sekunden-Aufnahme – Finder geöffnet bei ~/Downloads/bridge-darwin-arm64/, Rechtsklick auf install.command, „Öffnen" aus dem Menü wählen, Dialog „Entwickler kann nicht verifiziert werden" erscheint, auf „Öffnen" klicken, Terminal startet mit laufendem Installer.

  1. Öffne ~/Downloads/bridge-darwin-arm64/ im Finder
  2. Rechtsklick auf install.command → Öffnen
  3. Klicke auf Öffnen im Dialog „Entwickler kann nicht verifiziert werden"
  4. Terminal startet und führt den Installer automatisch aus

❗ Rechtsklick → Öffnen ist beim ersten Start zwingend erforderlich. Ein normaler Doppelklick löst Gatekeepers harte Blockierung aus. Nach dem ersten erfolgreichen Start funktioniert der Doppelklick dauerhaft.

Für Fortgeschrittene (Terminal)

cd ~/Downloads/bridge-darwin-arm64
bash install.sh

3. Verbinden

Bevor du startest, benötigst du zwei Werte aus dem CRM:

Was Wo
Token Einstellungen → Integrationen → Bridge Setup → Kopieren klicken (JWT, 24h TTL)
Technischer Projektname Seitenleiste → dein Projekt → URL-Slug (z. B. der kleingeschriebene mit Bindestrichen, nicht der Anzeigename)

Die Bridge fragt dann nach drei Werten:

Token (paste from CRM):  ⌘+V
Project name:             <project>
Server URL [enter for default]:  press ⏎

🖼️ Screenshot-Platzhalter — media/bridge/macos-connected.png Aufnahme-Spezifikation: Terminal-Fenster nach der Verbindung. Sichtbare Zeilen: ✓ Token validated · ✓ Connected to ws://…/ws/local-bridge · Watching <abs-path>. Fenstertitel zeigt Terminal — install.command.

F: Warum ein Projektname, wenn ich mehrere habe? Eine Bridge-Instanz bindet sich an ein Projekt – die Worker dieses Projekts lesen Dateien nur aus dem Verzeichnis, aus dem du die Bridge gestartet hast (Sandbox). Um mit mehreren Projekten zu arbeiten, starte eine Bridge pro Projekt in einem eigenen Verzeichnis.

F: Warum eine Server-URL? Drücke einfach Enter. Der Standardwert verweist auf das Arc OS-Produktions-Relay. Die benutzerdefinierte URL ist für selbst gehostete Setups – du musst sie nicht anfassen.

Wenn du ✓ Connected siehst, bist du fertig. Wechsle zum CRM → Bridge Setup und bestätige den grünen Punkt.

❌ Drei Dinge, die du auf macOS NICHT tun solltest

🖼️ Screenshot-Platzhalter — media/bridge/macos-damaged-error.png Aufnahme-Spezifikation: macOS-Dialog "bridge-darwin-arm64" ist beschädigt und kann nicht geöffnet werden. mit den Buttons In den Papierkorb legen / Abbrechen. Anmerkung: rotes X über In den Papierkorb legen, grünes Häkchen über Abbrechen.

Nicht tun Warum Stattdessen
bridge-darwin-arm64 direkt doppelklicken Gatekeeper markiert es als „beschädigt" – verwirrend, aber bei unsignierten Binärdateien erwartet Zuerst install.command ausführen – es entfernt das Quarantäne-Attribut
Im Beschädigungsdialog „In den Papierkorb legen" klicken Verlust der heruntergeladenen Binärdatei Abbrechen klicken und install.command verwenden
Ordner in Programme ziehen Die Bridge muss von dem Ort ausgeführt werden, von dem sie gestartet wurde (Sandbox-Root) Direkt aus ~/Downloads/bridge-darwin-arm64/ ausführen

Im Hintergrund ausführen (daemonisieren)

nohup ./bridge-darwin-arm64 > bridge.log 2>&1 &

Ein persistenter Service-Modus (launchd) ist auf der Roadmap – siehe Phase 23.4.

Wie geht es weiter