Arc OS Docs Open in app →

Local Bridge — Installation Windows

Guide d'installation spécifique à Windows. 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 incluant l'acceptation SmartScreen. Testé sur Windows 10 et 11.

1. Téléchargement

Dans le CRM : Paramètres → Intégrations → Bridge Setup → 🪟 Windows (x64).

Tu obtiens directement bridge-windows-x64.exe (pas d'archive — Windows n'a pas de système de quarantaine de style Gatekeeper).

Taille du fichier : ~55 Mo. Téléchargé dans %USERPROFILE%\Downloads\ par défaut.

2. Lancer

🎞️ GIF à venir — media/bridge/windows-smartscreen.gif Spec : enregistrement de 10 secondes — double-clic sur .exe, boîte de dialogue bleue Windows a protégé votre PC, clic sur Plus d'informations, clic sur Exécuter quand même, Invite de commandes s'ouvre avec les invites du bridge.

  1. Double-clique sur bridge-windows-x64.exe dans Downloads
  2. SmartScreen avertit Windows a protégé votre PC → clique Plus d'informations → Exécuter quand même

❗ La boîte de dialogue SmartScreen n'apparaît qu'au premier lancement. Après ça, le double-clic l'exécute directement.

Méthode avancée (PowerShell)

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

Si PowerShell bloque l'exécution : Set-ExecutionPolicy -Scope Process Bypass pour la session courante.

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

PowerShell — masque la fenêtre console :

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

Ou planifie via Planificateur de tâches → Créer une tâche → déclencheur : À l'ouverture de session → action : Démarrer un programme : bridge-windows-x64.exe. Un mode service persistant (Windows Service) est prévu dans la roadmap — voir Phase 23.4.

Interférences antivirus

Certains produits antivirus (Windows Defender, Kaspersky, Bitdefender) mettent en quarantaine les binaires non signés. Si le fichier disparaît après téléchargement :

  1. Ouvre Paramètres → Confidentialité et sécurité → Sécurité Windows → Protection contre les virus et les menaces → Historique de la protection
  2. Trouve l'entrée de mise en quarantaine bridge-windows-x64.exe
  3. Clique Actions → Autoriser sur l'appareil

Les machines d'entreprise sous MDM peuvent bloquer cela — parle à l'IT ou utilise une machine personnelle pour la bêta.

Et ensuite