Arc OS Docs Open in app →

Local Bridge — Installation macOS

Guide d'installation spécifique à macOS. 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 : ~60 secondes en supposant que le token est déjà copié.

Identifie ta puce en premier

Ton Mac Clique ce bouton dans le CRM Fichier obtenu
Apple Silicon (M1 / M2 / M3 / M4 / M5) macOS (Apple Silicon) bridge-darwin-arm64.tar.gz (~50 Mo)
Intel (Mac avant 2020) macOS (Intel) bridge-darwin-x64.tar.gz (~50 Mo)

Tu ne sais pas quelle puce tu as ? Clique sur le logo 🍎 (en haut à gauche) → À propos de ce Mac → cherche "Puce : Apple M1/M2/M3/M4/M5" (Apple Silicon) ou "Processeur : Intel Core …" (Intel). En cas de doute : Apple Silicon — tous les Mac vendus depuis novembre 2020.

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

1. Téléchargement

Dans le CRM : Paramètres → Intégrations → Bridge Setup → 🍎 macOS (Apple Silicon) (ou 🍏 pour Intel).

Safari télécharge bridge-darwin-arm64.tar.gz et l'extrait automatiquement vers ~/Downloads/bridge-darwin-arm64/.

🎞️ GIF à venir — media/bridge/macos-download.gif Spec : enregistrement d'écran de 8 secondes — le curseur clique sur le bouton 🍎 → la barre de progression Safari se remplit → un dossier apparaît dans le Finder.

Le dossier contient :

bridge-darwin-arm64/
├── bridge-darwin-arm64    ← le binaire
├── install.sh             ← script shell (compatible terminal)
└── install.command        ← lanceur compatible Finder

2. Lancer l'installateur

Méthode simple (Finder, sans Terminal)

🎞️ GIF à venir — media/bridge/macos-rightclick-open.gif Spec : enregistrement de 12 secondes — Finder ouvert sur ~/Downloads/bridge-darwin-arm64/, clic droit sur install.command, choisir Ouvrir dans le menu, boîte de dialogue "le développeur ne peut pas être vérifié" apparaît, clic sur Ouvrir, Terminal se lance avec l'installateur en cours.

  1. Ouvre ~/Downloads/bridge-darwin-arm64/ dans le Finder
  2. Clic droit sur install.command → Ouvrir
  3. Clique Ouvrir dans la boîte de dialogue "le développeur ne peut pas être vérifié"
  4. Terminal se lance et exécute l'installateur automatiquement

❗ Le clic droit → Ouvrir est obligatoire au premier lancement. Un simple double-clic déclenche le blocage dur de Gatekeeper. Après le premier lancement réussi, le double-clic fonctionne définitivement.

Méthode avancée (Terminal)

cd ~/Downloads/bridge-darwin-arm64
bash install.sh

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):  ⌘+V
Project name:             <project>
Server URL [enter for default]:  press ⏎

🖼️ Capture d'écran à venir — media/bridge/macos-connected.png Spec : fenêtre Terminal après connexion. Lignes visibles : ✓ Token validated · ✓ Connected to ws://…/ws/local-bridge · Watching <abs-path>. Titre de la fenêtre : Terminal — install.command.

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.

❌ Trois choses à NE PAS faire sur macOS

🖼️ Capture d'écran à venir — media/bridge/macos-damaged-error.png Spec : boîte de dialogue macOS "bridge-darwin-arm64" is damaged and can't be opened. avec les boutons Move to Trash / Cancel. Annotation : croix rouge sur Move to Trash, coche verte sur Cancel.

Ne pas faire Pourquoi Faire à la place
Double-cliquer directement sur bridge-darwin-arm64 Gatekeeper le marque "damaged" — déroutant mais attendu pour les binaires non signés Exécuter install.command en premier ; il supprime l'attribut de quarantaine
Cliquer "Mettre à la corbeille" sur la boîte de dialogue "damaged" Perd ton binaire téléchargé Cliquer Annuler et utiliser install.command
Glisser le dossier vers Applications Le bridge doit s'exécuter depuis l'endroit où tu l'as lancé (racine du sandbox) L'exécuter directement depuis ~/Downloads/bridge-darwin-arm64/

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

nohup ./bridge-darwin-arm64 > bridge.log 2>&1 &

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

Et ensuite