Arc OS Docs Open in app →

Local Bridge — Linux-Setup

Linux-spezifischer Installationsleitfaden (x64 und arm64). Allgemeine Übersicht, Pre-Flight-Checkliste, Fehler, Sicherheitsmodell und Diagnose findest du unter Local Bridge — Setup Guide.

Gesamtdauer: ~45 Sekunden — kein Gatekeeper-Aufwand.

Wähle deine Architektur

Dein Gerät Klicke diesen Button im CRM Diese Datei erhältst du
Die meisten Laptops, Desktops, VMs, x86-Server Linux (x64) bridge-linux-x64.tar.gz (~50 MB)
Raspberry Pi, AWS Graviton, ARM-Server Linux (arm64) bridge-linux-arm64.tar.gz (~50 MB)

Nicht sicher? Führe uname -m in deinem Terminal aus. x86_64 → wähle x64. aarch64 oder arm64 → wähle arm64.

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

1. Herunterladen

Im CRM: Einstellungen → Integrationen → Bridge Setup → 🐧 Linux (x64) (oder arm64).

Du erhältst bridge-linux-<arch>.tar.gz in ~/Downloads/.

2. Entpacken und ausführen

cd ~/Downloads
tar -xzf bridge-linux-x64.tar.gz
cd bridge-linux-x64
bash install.sh

Manche Browser (Firefox, GNOME Web) entpacken beim Download automatisch. Wenn du bereits einen Ordner hast, überspringe die tar-Zeile.

🎞️ GIF-Platzhalter — media/bridge/linux-install.gif Shot-Spec: 15-sekündige Terminal-Aufnahme (asciinema-Export als GIF) — tar -xzf … → cd → bash install.sh → Installer-Eingabeaufforderungen → ✓ Connected.

Der Installer führt chmod +x automatisch für die Binärdatei aus.

3. Verbinden

Vor dem Start benötigst du zwei Werte aus dem CRM:

Was Wo
Token Einstellungen → Integrationen → Bridge Setup → klicke auf Kopieren (JWT, 24h TTL)
Technischer Projektname Sidebar → dein Projekt → URL-Slug (z. B. die Kleinschreibung mit Bindestrichen, nicht der Anzeigename)

Die Bridge fragt dann nach drei Werten:

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

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

F: Wozu eine Server-URL? Drücke einfach Enter. Die Standardadresse verweist auf das Arc OS-Produktions-Relay. Eine benutzerdefinierte URL ist für self-hosted-Setups gedacht — du musst sie nicht anpassen.

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

Im Hintergrund ausführen (daemonisieren)

nohup ./bridge-linux-x64 > bridge.log 2>&1 &

Ein persistenter Dienstmodus (systemd-Unit) ist in der Roadmap vorgesehen — siehe Phase 23.4.

ripgrep — empfohlen

Das search_files-Tool fällt auf einen langsamen nativen Scan zurück, wenn ripgrep nicht installiert ist. Für sofortige Suchen:

# Debian / Ubuntu
sudo apt install ripgrep

# Fedora / RHEL
sudo dnf install ripgrep

# Arch
sudo pacman -S ripgrep

Nächste Schritte