Arc OS Docs Open in app →

Local Bridge — Installation Linux

Guide d'installation spécifique à Linux (x64 et arm64). Pour la vue d'ensemble, la checklist de pré-vol, les erreurs, le modèle de sécurité et les diagnostics, consulte Local Bridge — Guide d'installation.

Durée totale : ~45 secondes — sans friction Gatekeeper.

Identifie ton architecture

Ta machine Clique ce bouton dans le CRM Fichier obtenu
La plupart des laptops, desktops, VMs, serveurs x86 Linux (x64) bridge-linux-x64.tar.gz (~50 Mo)
Raspberry Pi, AWS Graviton, serveurs ARM Linux (arm64) bridge-linux-arm64.tar.gz (~50 Mo)

Tu ne sais pas ? Exécute uname -m dans ton terminal. x86_64 → choisir x64. aarch64 ou arm64 → choisir arm64.

Les étapes ci-dessous sont identiques pour les deux. Substitue arm64 ↔ x64 dans les noms de dossiers/binaires.

1. Téléchargement

Dans le CRM : Paramètres → Intégrations → Bridge Setup → 🐧 Linux (x64) (ou arm64).

Tu obtiens bridge-linux-<arch>.tar.gz dans ~/Downloads/.

2. Extraire et lancer

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

Certains navigateurs (Firefox, GNOME Web) extraient automatiquement au téléchargement. Si tu as déjà un dossier, saute la ligne tar.

🎞️ GIF à venir — media/bridge/linux-install.gif Spec : enregistrement terminal de 15 secondes (export asciinema vers GIF) — tar -xzf … → cd → bash install.sh → invites de l'installateur → ✓ Connected.

L'installateur exécute automatiquement chmod +x sur le binaire.

3. Connexion

Avant de lancer, récupère deux valeurs dans le CRM :

Quoi Où
Token Paramètres → Intégrations → Bridge Setup → cliquer Copier (JWT, TTL 24h)
Nom technique du projet Barre latérale → ton projet → slug URL (ex. le nom en minuscules avec tirets, pas le nom d'affichage)

Le bridge demande alors trois valeurs :

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

Q : Pourquoi un nom de projet si j'en ai plusieurs ? Une instance du bridge se lie à un seul projet — les workers de ce projet lisent les fichiers uniquement depuis le répertoire où tu as lancé le bridge (sandboxé). Pour travailler avec plusieurs projets, lance un bridge par projet dans son propre répertoire.

Q : Pourquoi une URL de serveur ? Appuie juste sur Entrée. La valeur par défaut pointe vers le relais de production Arc OS. L'URL personnalisée est pour les installations auto-hébergées ; tu n'as pas besoin d'y toucher.

Si tu vois ✓ Connected, tu as terminé. Passe au CRM → Bridge Setup et confirme le point vert.

Exécuter en arrière-plan (daemoniser)

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

Un mode service persistant (unité systemd) est prévu dans la roadmap — voir Phase 23.4.

ripgrep — recommandé

L'outil search_files retombe sur une analyse native lente si ripgrep n'est pas installé. Pour des recherches instantanées :

# Debian / Ubuntu
sudo apt install ripgrep

# Fedora / RHEL
sudo dnf install ripgrep

# Arch
sudo pacman -S ripgrep

Et ensuite