Arc OS Docs Open in app →

Local Bridge — Configuración en Windows

Guía de instalación específica para Windows. Para el resumen general, la lista de verificación previa, errores, modelo de seguridad y diagnósticos, consulta Local Bridge — Guía de configuración.

Tiempo total: ~60 segundos incluyendo el reconocimiento de SmartScreen. Probado en Windows 10 y 11.

1. Descarga

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

Obtienes bridge-windows-x64.exe directamente (sin archivo comprimido — Windows no tiene un sistema de cuarentena similar al Gatekeeper).

Tamaño del archivo: ~55 MB. Se descarga en %USERPROFILE%\Downloads\ por defecto.

2. Ejecuta

🎞️ GIF placeholder — media/bridge/windows-smartscreen.gif Especificación: grabación de 10 segundos — doble clic en .exe, diálogo azul Windows protected your PC, clic en More info, clic en Run anyway, se abre el Símbolo del sistema con los prompts del bridge.

  1. Doble clic en bridge-windows-x64.exe en Downloads
  2. SmartScreen avisa Windows protected your PC → haz clic en More info → Run anyway

❗ El aviso de SmartScreen solo aparece en el primer inicio. Después, el doble clic lo ejecuta directamente.

Forma avanzada (PowerShell)

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

Si PowerShell bloquea la ejecución: Set-ExecutionPolicy -Scope Process Bypass para la sesión actual.

3. Conéctate

Antes de lanzar, obtén dos valores del CRM:

Qué Dónde
Token Settings → Integrations → Bridge Setup → clic en Copy (JWT, TTL 24h)
Nombre técnico del proyecto Sidebar → tu proyecto → slug de URL (por ejemplo, el de minúsculas con guiones, no el nombre visible)

El bridge te pedirá entonces tres valores:

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

P: ¿Por qué un nombre de proyecto si tengo varios? Una instancia de bridge se asocia a un proyecto — los workers de ese proyecto solo leen archivos del directorio desde donde lanzaste el bridge (en sandbox). Para trabajar con varios proyectos, ejecuta un bridge por proyecto en su propio directorio.

P: ¿Para qué sirve la URL del servidor? Simplemente pulsa Enter. La URL por defecto apunta al relay de producción de Arc OS. La URL personalizada es para configuraciones autoalojadas; no necesitas tocarla.

Si ves ✓ Connected, ya terminaste. Cambia al CRM → Bridge Setup y confirma el punto verde.

Ejecutar en segundo plano (daemonizar)

PowerShell — oculta la ventana de consola:

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

O prográmalo con el Programador de tareas → Create Task → activador: At log on → acción: Start a program: bridge-windows-x64.exe. Un modo de servicio persistente (Windows Service) está en el roadmap — ver Phase 23.4.

Interferencia del antivirus

Algunos productos AV (Windows Defender, Kaspersky, Bitdefender) ponen en cuarentena los binarios sin firma. Si el archivo desaparece después de la descarga:

  1. Abre Settings → Privacy & security → Windows Security → Virus & threat protection → Protection history
  2. Localiza la entrada de cuarentena de bridge-windows-x64.exe
  3. Haz clic en Actions → Allow on device

Las máquinas corporativas bajo MDM pueden bloquearlo — habla con el equipo de IT o usa una máquina personal para la beta.

Qué sigue