Skip to main content
Esta documentación corresponde a las implementaciones federales de Devin. Volver a la documentación de Devin
Esta página te guía en la primera instalación del paquete de Devin Desktop aislado de la red, que incluye la Devin CLI aislada de la red. Realízala primero en una estación de trabajo y, después, repite el proceso en el resto de tus equipos con tu procedimiento aprobado de transferencia de medios.

​
Antes de empezar

  • Has iniciado sesión en el portal como miembro aprobado de un equipo con un derecho de uso on-prem activo. Sin ese derecho, la página de descargas para entornos aislados de la red indica que no cumples los requisitos; ponte en contacto con tu equipo de gestión de cuentas.
  • Tienes preparados, o estás en condiciones de preparar, los dos archivos que todo host necesita antes del primer inicio:
    • un archivo de licencia, emitido desde el portal (consulta Licencia);
    • un archivo de modelos que describe tus endpoints de modelos (consulta Archivo de modelos).
  • El host de destino ejecuta una plataforma compatible: macOS (Apple silicon o Intel), Linux (x86_64 o aarch64) o Windows (x64 o arm64).

​
Paso 1: Descarga el paquete desde el portal

  1. En el portal, abre Install → Air-gapped downloads (windsurf.fedstart.com/install/airgap).
  2. Elige el instalador de Devin Desktop para la plataforma de destino. La página ofrece un package por cada plataforma y formato: Los archivos de Windows se llaman DevinSetup-<arch>-<version>.exe y Devin-win32-<arch>-<version>.zip, donde <arch> es x64 o arm64. El instalador instala la aplicación para todos los usuarios; no hay un instalador por usuario.
  3. Anota la suma de comprobación SHA-256 que aparece junto al archivo (usa Show checksum). Tendrás que compararla después de la transferencia.
  4. Transfiere el archivo al entorno aislado de la red mediante el proceso de soportes físicos aprobado por tu organización.
La misma página ofrece otras dos descargas, cada una con su propia suma de comprobación SHA-256: La CLI del agente de Devin (devin) no forma parte de estas descargas: viene incluida en todos los packages de Desktop (consulta el Paso 5).

​
Paso 2: Verifica la suma de comprobación

En el host de destino (o antes de transferir el archivo al entorno aislado), calcula el SHA-256 del archivo descargado y compáralo con el valor que se muestra en el portal.
La primera columna debe coincidir exactamente con la suma de comprobación que aparece en la página del portal. Si no coincide, descarta el archivo y vuelve a descargarlo.

​
Paso 3: Instalar

  1. Abre el .dmg y arrastra Devin - Airgap a /Applications.
  2. Verifica la firma de código y la notarización antes de iniciar la aplicación por primera vez:
    spctl muestra accepted; codesign --verify no muestra nada y finaliza con el código 0 cuando la firma está intacta. Si aparece rejected o code object is not signed at all, significa que el paquete se alteró durante la transferencia: descártalo y vuelve a empezar desde el Paso 1.
En Linux, la verificación consiste en la comparación SHA-256 del Paso 2; los package no van acompañados de un archivo de firma independiente.

​
Paso 4: Coloca la licencia y el archivo de modelos

Tanto la CLI independiente como el agente incluido en Desktop leen los mismos dos archivos. Colócalos en las rutas predeterminadas para no tener que definir variables de entorno: En Windows, el directorio predeterminado es C:\ProgramData\Devin\; las variables de anulación son las mismas:

​
Windows: restringe el acceso a la carpeta de configuración

Este paso es obligatorio en Windows tanto con el instalador como con el archivo zip, y el instalador no lo hace por ti. De forma predeterminada, los usuarios estándar pueden crear archivos en una carpeta nueva dentro de C:\ProgramData, así que, sin esta restricción, un usuario podría crear models.json (o el archivo de licencia o de autenticación) antes que tú y mantener el control sobre él. Antes de colocar ningún archivo, crea la carpeta desde una sesión de PowerShell con privilegios elevados y restringe su acceso para que SYSTEM y Administrators tengan control total y los usuarios estándar solo tengan permisos de lectura:
Si C:\ProgramData\Devin\ ya existía, los comandos anteriores no bastan: todo lo que un usuario estándar haya creado antes en ella sigue siendo propiedad de ese usuario, y cualquier permiso concedido explícitamente sobre la carpeta a otro usuario o grupo se mantiene. Después de los comandos anteriores, ejecuta también los siguientes, en este orden. Estos comandos transfieren la propiedad de la carpeta y de su contenido a Administrators, eliminan todos los permisos explícitos de la carpeta, vuelven a aplicar el bloqueo y restablecen los permisos del contenido para que hereden los de la carpeta:
Confirma el resultado. Ninguno de los comandos anteriores debería haber mostrado un mensaje de error para ningún archivo o carpeta: /C hace que icacls continúe con el siguiente elemento cuando no puede modificar uno, por lo que un error significa que ese elemento conservó su propietario o sus permisos anteriores. A continuación, lista los permisos de la carpeta y de todo su contenido:
La carpeta en sí, C:\ProgramData\Devin, debe mostrar exactamente tres entradas: NT AUTHORITY\SYSTEM:(OI)(CI)(F), BUILTIN\Administrators:(OI)(CI)(F) y BUILTIN\Users:(OI)(CI)(RX), sin que ninguna esté marcada con (I). Cada archivo y subcarpeta que contenga debe mostrar los mismos tres usuarios y grupos, y ningún otro, cada uno marcado con (I) porque se hereda de la carpeta; en el caso de un archivo, son NT AUTHORITY\SYSTEM:(I)(F), BUILTIN\Administrators:(I)(F) y BUILTIN\Users:(I)(RX). Si aparece cualquier otro usuario o grupo en algún lugar, si una entrada de la carpeta está marcada con (I) o si una entrada de un archivo o subcarpeta no está marcada con (I), el bloqueo no se ha aplicado; vuelve a ejecutar los comandos para una carpeta existente. A continuación, copia el archivo de licencia y el archivo de modelos en la carpeta desde la misma sesión con privilegios elevados. Cada entrada de modelo indica una variable de entorno que contiene su clave de API (api_key.env); esa variable debe estar definida en el entorno del proceso que ejecuta el agente. Consulta Archivo de modelos → Variables de entorno de claves de API para saber cómo proporcionarla a Desktop, cuyo agente integrado hereda el entorno de la aplicación Desktop en lugar del de tu shell.

​
Paso 5: Localiza la CLI incluida

La CLI del agente de Devin viene integrada en cada package de Desktop y se compila a partir del mismo commit de versión que Desktop, de modo que ambas versiones siempre se mantienen sincronizadas. Usa este binario para ejecutar los comandos devin … de esta guía, o agrégalo a PATH. Confirma la versión:

​
Paso 6: Ejecuta la comprobación de estado

Desde un shell que tenga el mismo entorno con el que se ejecutará el agente (en particular, las variables de clave de API indicadas en tu archivo de modelos), ejecuta:
El comando devuelve 0 solo si no falla ninguna comprobación. Cada línea FAIL incluye un código de error, como CFG002 o NET003; búsquelo en Códigos de error y siga el manual de procedimientos de Solución de problemas.

​
Paso 7: Primer inicio

Inicia la aplicación instalada usando su ruta explícita:
Evita open -a "Devin - Airgap": este comando resuelve el nombre a través de LaunchServices y podría abrir una copia distinta de la que verificaste (un .dmg montado o una instalación anterior).
Si falta la licencia o no es válida, Desktop se abre de todos modos, pero el agente incluido falla: el panel de chat muestra el error de ACP -32019 license_invalid. Abre View → Output → Devin ACP, busca la línea LIC00X y consulta Licencia.

​
Próximos pasos

  • Configura SSO si tu despliegue requiere que los usuarios inicien sesión: SSO.
  • Agrega una CA privada si tus endpoints usan certificados internos: Red y certificados.
  • Descubre dónde guarda el producto su estado y cómo ingerir el registro de auditoría: Formatos en disco.