Arc OS Docs Open in app →

Local Bridge — Windows-Setup

Windows-spezifischer Installationsleitfaden. Für die allgemeine Übersicht, Pre-Flight-Checkliste, Fehler, Sicherheitsmodell und Diagnose siehe Local Bridge — Setup Guide.

Gesamtdauer: ~60 Sekunden einschließlich SmartScreen-Bestätigung. Getestet auf Windows 10 und 11.

1. Herunterladen

Im CRM: Einstellungen → Integrationen → Bridge Setup → 🪟 Windows (x64).

Du erhältst bridge-windows-x64.exe direkt (kein Archiv — Windows hat kein Quarantäne-System wie Gatekeeper).

Dateigröße: ~55 MB. Wird standardmäßig in %USERPROFILE%\Downloads\ gespeichert.

2. Starten

🎞️ GIF-Platzhalter — media/bridge/windows-smartscreen.gif Aufnahme-Spezifikation: 10-Sekunden-Aufnahme — Doppelklick auf .exe, blauer Dialog Windows hat deinen PC geschützt, Klick auf Weitere Informationen, Klick auf Trotzdem ausführen, Eingabeaufforderung öffnet sich mit Bridge-Prompts.

  1. Doppelklick auf bridge-windows-x64.exe in Downloads
  2. SmartScreen warnt Windows hat deinen PC geschützt → klicke auf Weitere Informationen → Trotzdem ausführen

❗ Der SmartScreen-Prompt erscheint nur beim ersten Start. Danach startet ein Doppelklick die Anwendung direkt.

Power-User-Methode (PowerShell)

cd $HOME\Downloads
.\bridge-windows-x64.exe

Falls PowerShell die Ausführung blockiert: Set-ExecutionPolicy -Scope Process Bypass für die aktuelle Sitzung.

3. Verbinden

Vor dem Start holst du dir 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 Kleinbuchstaben-Name mit Bindestrichen, nicht der Anzeigename)

Die Bridge fragt dann nach drei Werten:

Token (paste from CRM):  Ctrl+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 aus diesem Projekt lesen Dateien nur aus dem Verzeichnis, in 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? Einfach Enter drücken. Der Standard verweist auf den Arc OS Produktions-Relay. Eine eigene URL ist für Self-Hosted-Setups gedacht; du musst das nicht anfassen.

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

Im Hintergrund ausführen (Daemonisieren)

PowerShell — blendet das Konsolenfenster aus:

Start-Process .\bridge-windows-x64.exe -WindowStyle Hidden

Oder planen via Aufgabenplanung → Aufgabe erstellen → Auslöser: Bei Anmeldung → Aktion: Programm starten: bridge-windows-x64.exe. Ein dauerhafter Dienstmodus (Windows Service) ist in der Roadmap vorgesehen — siehe Phase 23.4.

Antivireninterferenzen

Einige AV-Produkte (Windows Defender, Kaspersky, Bitdefender) quarantänisieren unsignierte Binärdateien. Falls die Datei nach dem Download verschwindet:

  1. Öffne Einstellungen → Datenschutz & Sicherheit → Windows-Sicherheit → Viren- & Bedrohungsschutz → Schutzverlauf
  2. Finde den Quarantäneeintrag für bridge-windows-x64.exe
  3. Klicke auf Aktionen → Auf Gerät zulassen

Auf Firmenrechnern unter MDM kann das blockiert sein — wende dich an die IT oder nutze für die Beta ein persönliches Gerät.

Nächste Schritte