Skip to main content
Cette documentation concerne les déploiements fédéraux de Devin. Retour à la documentation Devin
Le build en air gap de Devin Desktop et de la Devin CLI est conçu pour les réseaux sans accès à Internet. Les requêtes d’inférence sont envoyées aux points de terminaison de modèles que vous hébergez, l’accès est contrôlé par un fichier de licence signé et validé localement, et chaque événement est consigné dans un journal d’audit local. Ce guide s’adresse à l’administrateur chargé d’installer, de configurer et d’assurer le support du produit. Il est structuré comme un guide d’exploitation : chaque page traite d’un aspect du déploiement et se termine par les codes d’erreur que vous pouvez rencontrer, ainsi que la marche à suivre pour chacun d’eux.
Bêta. Le build en air gap est actuellement proposé en version bêta. Les plateformes prises en charge sont macOS (Apple silicon et Intel), Linux (x86_64 et aarch64) et Windows (x64 et arm64).

Présentation du produit

Desktop et le CLI embarqué sont compilés à partir du même commit de version : un seul paquet Desktop constitue donc une installation complète et cohérente.

Avant de commencer

Fourni par Cognition

Ce que vous fournissez

Points de terminaison utilisés par le produit

La CLI et l’application Desktop en air gap sont entièrement configurées au moyen de fichiers présents sur l’hôte. Les points de terminaison qu’elles utilisent sont ceux que vous configurez :
  • Points de terminaison de modèles répertoriés dans votre fichier de modèles. Il n’existe aucun catalogue de modèles dans le cloud : la liste des modèles, le sélecteur de modèles et le routage de l’inférence proviennent tous de ce fichier. Les points de terminaison doivent utiliser https:// ; le http:// simple n’est accepté que pour les hôtes de bouclage (localhost, 127.0.0.0/8, [::1]), par exemple un serveur vLLM ou Ollama exécuté sur la même machine.
  • Votre fournisseur d’identité, si vous activez le SSO (authentification unique). La CLI lit le document de découverte OIDC de l’émetteur et utilise ses points de terminaison d’autorisation, de token et JWKS.
  • Les serveurs MCP que vous configurez localement, le cas échéant.
  • Le portail (windsurf.fedstart.com), auquel un administrateur accède depuis un navigateur pour télécharger des paquets et émettre des licences.
Le journal d’audit et le rapport de diagnostic sont enregistrés sur le disque local. devin update est désactivé ; les nouvelles versions s’installent à partir de paquets téléchargés depuis le portail (voir Mises à jour).

Contrôle de l’accès

  1. Licence (toujours). Au démarrage, la CLI vérifie la signature et la période de validité du fichier de licence à l’aide des clés publiques intégrées au binaire. Sans licence valide, la CLI ne démarre pas ; voir Licence.
  2. SSO (facultatif). Si vous créez un fichier d’authentification qui sélectionne "mode": "sso", chaque utilisateur doit également se connecter à votre IdP avec devin auth login. La connexion peut être subordonnée à l’appartenance à un groupe obligatoire, et toute session en cours est revalidée à partir du token mis en cache ; voir SSO.
Ces deux mécanismes sont imposés par la CLI : ils s’appliquent donc de la même manière à une utilisation autonome dans le terminal et à l’agent intégré à Desktop.

Pour aller plus loin

Installation

Téléchargez depuis le portail, vérifiez le téléchargement, installez, puis effectuez le premier contrôle de bon fonctionnement.

Codes d’erreur

Le catalogue complet des codes LIC, IDP, MDL, NET et CFG, avec les actions à mener par l’opérateur.

Dépannage

Le guide d’exploitation de devin airgap doctor et les éléments à transmettre au support.

Formats sur disque

Les chemins de configuration par système d’exploitation et le schéma JSONL du journal d’audit pour l’ingestion dans un SIEM.