Arc OS Docs Open in app →

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

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

Загальний час: ~45 секунд — без тертя з Gatekeeper.

Обери архітектуру

Твоя машина Тисни в CRM Отримаєш файл
Більшість ноутбуків, ПК, VM, x86-сервери Linux (x64) bridge-linux-x64.tar.gz (~50 МБ)
Raspberry Pi, AWS Graviton, ARM-сервери Linux (arm64) bridge-linux-arm64.tar.gz (~50 МБ)

Не знаєш? Запусти uname -m у терміналі. x86_64 → бери x64. aarch64 чи arm64 → бери arm64.

Кроки нижче ідентичні для обох. Заміни arm64 ↔ x64 у назвах папок/бінарників.

1. Завантаж

У CRM: Settings → Integrations → Bridge Setup → 🐧 Linux (x64) (або arm64).

Отримаєш bridge-linux-<arch>.tar.gz у ~/Downloads/.

2. Розпакуй та запусти

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

Деякі браузери (Firefox, GNOME Web) розпаковують автоматично при завантаженні. Якщо папка вже є, пропусти рядок з tar.

🎞️ Місце для GIF — media/bridge/linux-install.gif Специфікація кадру: 15-секундний запис терміналу (експорт з asciinema у GIF) — tar -xzf … → cd → bash install.sh → запитання інсталятора → ✓ Connected.

Інсталятор сам викличе chmod +x за тебе.

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

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

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

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

Token (paste from CRM):  Ctrl+Shift+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)

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

Постійний сервіс-режим (systemd unit) у дорожній карті — див. Phase 23.4.

ripgrep — рекомендовано

Інструмент search_files робить повільне нативне сканування, якщо ripgrep не встановлено. Для миттєвого пошуку:

# Debian / Ubuntu
sudo apt install ripgrep

# Fedora / RHEL
sudo dnf install ripgrep

# Arch
sudo pacman -S ripgrep

Куди далі