Arc OS Docs Open in app →

Local Bridge — Встановлення на Windows

Інструкція з налаштування для Windows. Загальний огляд, чек-лист, помилки, безпека та діагностика — на сторінці Local Bridge — головний гайд.

Загальний час: ~60 секунд із підтвердженням SmartScreen. Перевірено на Windows 10 і 11.

1. Завантаж

У CRM: Settings → Integrations → Bridge Setup → 🪟 Windows (x64).

Отримаєш bridge-windows-x64.exe напряму (без архіву — Windows не має карантину типу Gatekeeper).

Розмір файлу: ~55 МБ. Зберігається в %USERPROFILE%\Downloads\ за замовчуванням.

2. Запусти

🎞️ Місце для GIF — media/bridge/windows-smartscreen.gif Специфікація кадру: 10-секундний запис — подвійний клік на .exe, синій діалог Windows protected your PC, клік More info, клік Run anyway, відкривається Command Prompt із запитаннями bridge.

  1. Подвійний клік на bridge-windows-x64.exe у Downloads
  2. SmartScreen видасть попередження Windows protected your PC → тисни More info → Run anyway

❗ SmartScreen з'являється лише під час першого запуску. Далі подвійний клік запускає bridge напряму.

Для досвідчених (PowerShell)

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

Якщо PowerShell блокує виконання: Set-ExecutionPolicy -Scope Process Bypass для поточної сесії.

3. Підключайся

Перед запуском візьми дві речі з CRM:

Що Де
Токен Settings → Integrations → Bridge Setup → клікни Copy (JWT, TTL 24 год)
Технічна назва проєкту Бічна панель → твій проєкт → URL-слаг (в нижньому регістрі з дефісами, не відображувана назва)

Далі bridge запитає три значення:

Token (paste from CRM):  Ctrl+V
Project name:             <project>
Server URL [enter for default]:  тисни ⏎

Q: Навіщо назва проєкту, якщо в мене їх декілька? Один інстанс bridge приєднаний до одного проєкту — воркери цього проєкту читають файли тільки з тієї директорії, з якої ти запустив bridge (sandboxed). Якщо працюєш з кількома проєктами — запускай по одному bridge на проєкт із його власної директорії.

Q: Навіщо Server URL? Просто тисни Enter. Дефолт указує на production-релей Arc OS. Кастомна URL потрібна тільки для self-hosted інсталяцій; чіпати не треба.

Якщо бачиш ✓ Connected, готово. Перейди в CRM → Bridge Setup і переконайся, що горить зелена крапка.

Запуск у фоні (daemon)

PowerShell — ховає вікно консолі:

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

Або через Task Scheduler → Create Task → тригер: At log on → дія: Start a program: bridge-windows-x64.exe. Постійний сервіс-режим (Windows Service) у дорожній карті — див. Phase 23.4.

Втручання антивіруса

Деякі AV (Windows Defender, Kaspersky, Bitdefender) карантують непідписані бінарники. Якщо файл зник після завантаження:

  1. Відкрий Settings → Privacy & security → Windows Security → Virus & threat protection → Protection history
  2. Знайди карантинний запис bridge-windows-x64.exe
  3. Тисни Actions → Allow on device

Корпоративні машини під MDM можуть це блокувати — звернися до IT або використай особистий ПК для бета-тесту.

Куди далі