Arc OS Docs Open in app →

Local Bridge — Configuração no Linux

Guia de instalação específico para Linux (x64 e arm64). Para a visão geral, checklist de pré-voo, erros, modelo de segurança e diagnósticos, veja Local Bridge — Guia de Configuração.

Tempo total: ~45 segundos — sem complicações de Gatekeeper.

Identifique sua arquitetura

Seu computador Clique neste botão no CRM Arquivo baixado
A maioria dos laptops, desktops, VMs, servidores x86 Linux (x64) bridge-linux-x64.tar.gz (~50 MB)
Raspberry Pi, AWS Graviton, servidores ARM Linux (arm64) bridge-linux-arm64.tar.gz (~50 MB)

Não tem certeza? Execute uname -m no terminal. x86_64 → escolha x64. aarch64 ou arm64 → escolha arm64.

Os passos abaixo são idênticos para ambos. Substitua arm64 ↔ x64 nos nomes de pastas e binários.

1. Download

No CRM: Settings → Integrations → Bridge Setup → 🐧 Linux (x64) (ou arm64).

Você receberá bridge-linux-<arch>.tar.gz em ~/Downloads/.

2. Extraia e execute

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

Alguns navegadores (Firefox, GNOME Web) extraem automaticamente ao baixar. Se você já tiver uma pasta, pule a linha tar.

🎞️ Placeholder de GIF — media/bridge/linux-install.gif Especificação: gravação de terminal de 15 segundos (exportada do asciinema para GIF) — tar -xzf … → cd → bash install.sh → prompts do instalador → ✓ Connected.

O instalador executa chmod +x no binário automaticamente.

3. Conecte

Antes de iniciar, obtenha dois valores no CRM:

O que Onde
Token Settings → Integrations → Bridge Setup → clique em Copy (JWT, TTL de 24h)
Nome técnico do projeto Barra lateral → seu projeto → slug da URL (ex.: o que está em minúsculas com hífens, não o nome de exibição)

O bridge solicitará três valores:

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

P: Por que informar o nome do projeto se tenho vários? Uma instância do bridge se vincula a um único projeto — os workers daquele projeto leem arquivos apenas do diretório onde você iniciou o bridge (sandbox). Para trabalhar com múltiplos projetos, execute um bridge por projeto em seu próprio diretório.

P: Por que uma URL de servidor? Basta pressionar Enter. O padrão aponta para o relay de produção do Arc OS. A URL customizada é para configurações self-hosted; você não precisa alterá-la.

Se você vir ✓ Connected, está pronto. Vá para o CRM → Bridge Setup e confirme o ponto verde.

Executar em segundo plano (daemonizar)

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

Um modo de serviço persistente (unidade systemd) está no roadmap — veja a Phase 23.4.

ripgrep — recomendado

A ferramenta search_files recorre a uma varredura nativa lenta se o ripgrep não estiver instalado. Para buscas instantâneas:

# Debian / Ubuntu
sudo apt install ripgrep

# Fedora / RHEL
sudo dnf install ripgrep

# Arch
sudo pacman -S ripgrep

O que fazer a seguir