> ## Documentation Index > Fetch the complete documentation index at: https://docs.devin.ai/llms.txt > Use this file to discover all available pages before exploring further. # Devin Desktop e CLI air-gapped > Visão geral para administradores do Devin Desktop e da CLI air-gapped: o que a Cognition fornece, o que você precisa providenciar, como funciona a autenticação e quais endpoints são usados. > [!NOTE] > > Esta documentação é destinada às implantações federais do Devin. [Voltar para a Documentação do Devin](/pt-BR/get-started/devin-intro) O build air-gapped do Devin Desktop e da Devin CLI foi projetado para redes sem acesso à internet. A inferência é feita em endpoints de modelos hospedados por você, o acesso é controlado por um arquivo de licença assinado e validado localmente, e todos os eventos são gravados em um registro de auditoria local. Este guia é destinado ao administrador responsável por instalar, configurar e dar suporte ao produto. Ele está organizado como um runbook: cada página aborda uma parte da implantação e termina com os códigos de erro que podem aparecer e o que fazer em cada caso. > [!NOTE] > > **Beta.** No momento, o build air-gapped é oferecido em versão beta. As plataformas com suporte são macOS (Apple silicon e Intel), Linux (x86\_64 e aarch64) e Windows (x64 e arm64). *** ## O que é o produto | Componente | O que faz | | - | - | | **Devin Desktop (build air-gapped)** | O aplicativo para desktop, instalado pela página de downloads air-gapped do portal. Ele já vem com a Devin CLI air-gapped como agente e se comunica com ela localmente. Não tem login na nuvem, não inclui o Cascade e não recebe atualizações automáticas. | | **Devin CLI (build air-gapped)** | O agente de terminal. Pode ser executado de forma independente em um shell (`devin`) ou como agente dentro do Desktop. Obtém o catálogo de modelos de um arquivo de modelos criado por você e o direito de uso de um arquivo de licença instalado por você. | O Desktop e a CLI incluída são gerados a partir do mesmo commit de versão, então um único pacote do Desktop já constitui uma instalação completa e consistente. ## Antes de começar ### Fornecido pela Cognition | Item | Onde é abordado | | - | - | | Acesso ao portal com um direito de uso on-prem ativo para sua equipe, configurado pela sua equipe de contas | [Instalação](/pt-BR/federal/air-gapped/install) | | Os pacotes do Desktop (e a CLI de túnel do Desktop) na página de downloads air-gapped do portal, com checksums SHA-256 | [Instalação](/pt-BR/federal/air-gapped/install), [Atualizações](/pt-BR/federal/air-gapped/updates) | | Arquivos de licença assinados, emitidos pelo portal; as chaves públicas usadas para verificá-los vêm incorporadas aos binários | [Licença](/pt-BR/federal/air-gapped/license) | ### O que você fornece | Item | Onde é abordado | | - | - | | Um host com uma plataforma compatível, com o arquivo de licença instalado em `/etc/devin/license.devin-onprem-license` (Windows: `C:\ProgramData\Devin\license.devin-onprem-license`) ou no caminho definido em `DEVIN_LICENSE_FILE` | [Licença](/pt-BR/federal/air-gapped/license) | | Um ou mais endpoints de modelo compatíveis com OpenAI dentro da sua rede, descritos em um arquivo de modelos em `/etc/devin/models.json` (Windows: `C:\ProgramData\Devin\models.json`) ou no caminho definido em `DEVIN_MODELS_FILE` | [Arquivo de modelos](/pt-BR/federal/air-gapped/models-file) | | Opcionalmente, um provedor de identidade OIDC para exigir login do usuário além da licença | [SSO](/pt-BR/federal/air-gapped/sso) | | Opcionalmente, um pacote de CA privado, caso seus endpoints de modelo ou IdP usem certificados que não estejam no repositório de confiança do sistema operacional | [Rede e certificados](/pt-BR/federal/air-gapped/network-and-certificates) | ## Endpoints que o produto usa O CLI e o Desktop air-gapped são configurados inteiramente por arquivos no host. Os endpoints que eles usam são aqueles que você configura: * **Endpoints de modelos** listados no seu arquivo de modelos. Não há catálogo de modelos na nuvem: a lista de modelos, o seletor de modelos e o roteamento de inferência vêm todos desse arquivo. Os endpoints devem usar `https://`; `http://` simples só é aceito para hosts de loopback (`localhost`, `127.0.0.0/8`, `[::1]`), por exemplo, um servidor vLLM ou Ollama na mesma máquina. * **Seu provedor de identidade**, se você ativar o SSO (Single Sign-On). O CLI lê o documento de descoberta OIDC do emissor e usa os endpoints de autorização, token e JWKS indicados nele. * **Servidores MCP** que você configurar localmente, se houver. * **O portal** (`windsurf.fedstart.com`), que um administrador acessa pelo navegador para baixar pacotes e emitir licenças. O registro de auditoria e o relatório de diagnósticos são gravados no disco local. O `devin update` fica desativado; novas versões são instaladas a partir de pacotes baixados do portal (consulte [Atualizações](/pt-BR/federal/air-gapped/updates)). ## Como o acesso é controlado 1. **Licença** (sempre). Na inicialização, a CLI verifica a assinatura e o período de validade do arquivo de licença usando as chaves públicas incorporadas ao binário. Sem uma licença válida, a CLI não é iniciada; consulte [Licença](/pt-BR/federal/air-gapped/license). 2. **SSO** (opcional). Se você criar um arquivo de autenticação que selecione `"mode": "sso"`, cada usuário também precisará fazer login no seu IdP com `devin auth login`. O login pode exigir a associação a um grupo obrigatório, e uma sessão em execução é revalidada com base no token em cache; consulte [SSO](/pt-BR/federal/air-gapped/sso). Ambos os mecanismos são impostos pela CLI e, portanto, se aplicam da mesma forma ao uso independente no terminal e ao agente dentro do Desktop. ## Próximos passos > **[Instalação](/pt-BR/federal/air-gapped/install)** > > Baixe pelo portal, verifique o download, instale e execute a primeira verificação de integridade. > **[Códigos de erro](/pt-BR/federal/air-gapped/error-codes)** > > O catálogo completo de códigos `LIC`, `IDP`, `MDL`, `NET` e `CFG`, com as ações recomendadas ao operador. > **[Solução de problemas](/pt-BR/federal/air-gapped/troubleshooting)** > > O runbook do `devin airgap doctor` e o que enviar ao suporte. > **[Formatos em disco](/pt-BR/federal/air-gapped/on-disk-formats)** > > Caminhos de configuração por sistema operacional e o schema JSONL do registro de auditoria para ingestão no SIEM. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.