Arc OS Docs Open in app →

Local Bridge — Configuração no Windows

Guia de instalação específico para Windows. 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: ~60 segundos incluindo a confirmação no SmartScreen. Testado no Windows 10 e 11.

1. Download

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

Você recebe bridge-windows-x64.exe diretamente (sem arquivo compactado — o Windows não tem um sistema de quarentena equivalente ao Gatekeeper).

Tamanho do arquivo: ~55 MB. Baixado para %USERPROFILE%\Downloads\ por padrão.

2. Execute

🎞️ Placeholder de GIF — media/bridge/windows-smartscreen.gif Especificação: gravação de 10 segundos — duplo clique no .exe, diálogo azul Windows protected your PC, clique em More info, clique em Run anyway, Prompt de Comando abre com os prompts do bridge.

  1. Clique duas vezes em bridge-windows-x64.exe na pasta Downloads
  2. O SmartScreen avisa Windows protected your PC → clique em More info → Run anyway

❗ O prompt do SmartScreen aparece apenas no primeiro lançamento. Depois disso, o duplo clique executa diretamente.

Forma avançada (PowerShell)

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

Se o PowerShell bloquear a execução: Set-ExecutionPolicy -Scope Process Bypass para a sessão atual.

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+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)

PowerShell — oculta a janela do console:

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

Ou agende via Agendador de Tarefas → Create Task → gatilho: At log on → ação: Start a program: bridge-windows-x64.exe. Um modo de serviço persistente (Windows Service) está no roadmap — veja a Phase 23.4.

Interferência de antivírus

Alguns antivírus (Windows Defender, Kaspersky, Bitdefender) colocam em quarentena binários sem assinatura. Se o arquivo desaparecer após o download:

  1. Abra Settings → Privacy & security → Windows Security → Virus & threat protection → Protection history
  2. Localize a entrada de quarentena de bridge-windows-x64.exe
  3. Clique em Actions → Allow on device

Máquinas corporativas gerenciadas por MDM podem bloquear isso — fale com o TI ou use uma máquina pessoal durante o beta.

O que fazer a seguir