Arc OS Docs Open in app →

Local Bridge — Configuración en Linux

Guía de instalación específica para Linux (x64 y arm64). Para la visión general, checklist previo, errores, modelo de seguridad y diagnósticos, consulta Local Bridge — Guía de configuración.

Tiempo total: ~45 segundos — sin fricciones de Gatekeeper.

Elige tu arquitectura

Tu máquina Haz clic en este botón en CRM Archivo que recibirás
La mayoría de 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)

¿No estás seguro? Ejecuta uname -m en tu terminal. x86_64 → elige x64. aarch64 o arm64 → elige arm64.

Los pasos a continuación son idénticos para ambas arquitecturas. Sustituye arm64 ↔ x64 en los nombres de carpetas y binarios.

1. Descarga

En CRM: Ajustes → Integraciones → Bridge Setup → 🐧 Linux (x64) (o arm64).

Recibirás bridge-linux-<arch>.tar.gz en ~/Downloads/.

2. Extrae y ejecuta

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

Algunos navegadores (Firefox, GNOME Web) extraen automáticamente al descargar. Si ya tienes una carpeta, omite la línea de tar.

🎞️ Placeholder de GIF — media/bridge/linux-install.gif Especificación: grabación de terminal de 15 segundos (exportación asciinema a GIF) — tar -xzf … → cd → bash install.sh → prompts del instalador → ✓ Connected.

El instalador ejecuta chmod +x automáticamente en el binario.

3. Conecta

Antes de iniciar, obtén dos valores desde CRM:

Qué Dónde
Token Ajustes → Integraciones → Bridge Setup → haz clic en Copy (JWT, TTL de 24h)
Nombre técnico del proyecto Barra lateral → tu proyecto → slug de la URL (el que está en minúsculas con guiones, no el nombre de visualización)

El bridge te pedirá tres valores:

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

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

P: ¿Para qué sirve la Server URL? Solo presiona Enter. El valor por defecto apunta al relay de producción de Arc OS. La URL personalizada es para configuraciones self-hosted; no necesitas modificarla.

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

Ejecutar en segundo plano (daemonizar)

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

Un modo de servicio persistente (unidad systemd) está en el roadmap — ver Phase 23.4.

ripgrep — recomendado

La herramienta search_files recurre a un escaneo nativo lento si ripgrep no está instalado. Para búsquedas instantáneas:

# Debian / Ubuntu
sudo apt install ripgrep

# Fedora / RHEL
sudo dnf install ripgrep

# Arch
sudo pacman -S ripgrep

Qué sigue