> ## 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. # Atualizar o Devin Desktop e a CLI air-gapped > Como novas versões do Devin Desktop e da CLI air-gapped aparecem na página de downloads do portal e como verificar, instalar e validar uma atualização sem a atualização automática. > [!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 Desktop e a CLI air-gapped nunca se atualizam sozinhos: a atualização automática está desativada no build do Desktop, e o `devin update` está desativado na CLI. Cada atualização é um novo pacote que você baixa do portal, verifica e instala em cada estação de trabalho, seguindo o mesmo processo da primeira [instalação](/pt-BR/federal/air-gapped/install). Esta página explica o que muda nas atualizações seguintes. *** ## Como uma nova versão é disponibilizada A página **Install → Air-gapped downloads** do portal ([`windsurf.fedstart.com/install/airgap`](https://windsurf.fedstart.com/install/airgap)) disponibiliza apenas uma versão por vez. A versão é exibida no título **Downloads** (por exemplo, `version 1.66.101 (0123abcdef)`), e o checksum SHA-256 de cada arquivo pode ser visualizado pelo controle **Show checksum** ao lado. Quando a Cognition lança um novo build air-gapped para o seu portal, a página passa a disponibilizar a nova versão e os novos checksums no lugar dos antigos. Não há seletor de versões nem notificação. Para acompanhar as versões, verifique o rótulo de versão na página de downloads como parte do seu ciclo regular de manutenção. ## Etapa 1: Verifique o que você está executando Em uma estação de trabalho, compare a versão instalada da CLI com a versão exibida na página de downloads: ```sh theme={null} devin --version ``` ```text theme={null} devin-federal +airgap. ``` `devin --version` exibe a versão e o hash curto do commit do build. O Desktop e a CLI que o acompanha são gerados a partir do mesmo commit, então essa versão vale para ambos. ## Etapa 2: Baixe e verifique o novo pacote Siga a [Etapa 1](/pt-BR/federal/air-gapped/install#step-1-download-the-bundle-from-the-portal) e a [Etapa 2](/pt-BR/federal/air-gapped/install#step-2-verify-the-checksum) do guia de instalação para a nova versão: baixe o pacote de cada plataforma da sua frota, anote o checksum exibido na página do portal, transfira os arquivos para o ambiente isolado (air gap) e confirme que o SHA-256 confere antes de instalar. Os checksums mudam a cada versão. Anote o novo valor exibido na página do portal ao fazer o download; não reutilize o checksum de uma versão anterior. ## Etapa 3: Instale sobre a versão existente Antes de começar, feche o Desktop e encerre todas as sessões `devin` em execução na estação de trabalho. A configuração, o histórico de sessões, o registro de auditoria e os logins de SSO ficam armazenados fora do aplicativo (consulte [Formatos em disco](/pt-BR/federal/air-gapped/on-disk-formats)) e são preservados na atualização. **macOS** Abra o novo `.dmg` e arraste **Devin - Airgap** para `/Applications`, substituindo o aplicativo existente quando solicitado. Em seguida, verifique a assinatura conforme a [Etapa 3 do guia de instalação](/pt-BR/federal/air-gapped/install#step-3-install): ```sh theme={null} spctl --assess --type execute --verbose "/Applications/Devin - Airgap.app" ``` ```text theme={null} /Applications/Devin - Airgap.app: accepted source=Notarized Developer ID ``` **Linux (.deb / .rpm)** ```sh theme={null} sudo dpkg -i Devin-linux-x64-.deb # Debian/Ubuntu sudo rpm -U Devin-linux-x64-.rpm # RHEL/Fedora ``` O `dpkg -i` atualiza um pacote já instalado diretamente; use `rpm -U` (e não `rpm -i`) para que o `rpm` substitua a versão instalada em vez de recusar a instalação. Não há repositório apt ou yum para builds air-gapped. **Linux (.tar.gz)** Mova a extração antiga para outro local e, em seguida, extraia o novo arquivo no mesmo local, para que o caminho do inicializador (`/opt/Devin-linux-x64/bin/devin-airgap`) e qualquer entrada de `PATH` para o binário `devin` incluído continuem válidos: ```sh theme={null} sudo mv /opt/Devin-linux-x64 /opt/Devin-linux-x64.previous sudo tar -xzf Devin-linux-x64-.tar.gz -C /opt ``` Remova `/opt/Devin-linux-x64.previous` depois de validar a nova versão. **Windows (installer)** Verifique a assinatura Authenticode do novo instalador conforme a [Etapa 3 do guia de instalação](/pt-BR/federal/air-gapped/install#step-3-install) e, em seguida, execute-o como administrador: ```powershell theme={null} Get-AuthenticodeSignature .\DevinSetup-x64-.exe | Format-List Status, SignerCertificate ``` O build air-gapped não tem URL de atualização; a única forma de atualizar uma cópia instalada é usar um novo instalador. **Windows (.zip)** Descompacte `Devin-win32-x64-.zip` em uma pasta própria, verifique a assinatura dos executáveis descompactados conforme a [Etapa 3 do guia de instalação](/pt-BR/federal/air-gapped/install#step-3-install) e execute o Desktop a partir da nova pasta. Depois de validar a nova versão, remova a pasta anterior e atualize qualquer entrada de `PATH` para o `devin.exe` incluído. O arquivo de licença, o arquivo de modelos e o arquivo de autenticação em `/etc/devin/` (`C:\ProgramData\Devin\` no Windows) não fazem parte do pacote e não são alterados pela atualização. ## Etapa 4: Validar a atualização Em cada estação de trabalho atualizada, execute como usuário comum: ```sh theme={null} devin --version devin airgap doctor ``` ```text theme={null} devin-federal +airgap. pass license seat alice@example.gov (account acme), expires 2027-03-01 ... 10 check(s): 10 passed, 0 warning(s), 0 failure(s) ``` Em seguida, inicie o Desktop uma vez e confirme que ele abre uma sessão usando o endpoint do seu modelo. Duas falhas específicas da atualização às quais você deve ficar atento: | Sintoma | Causa | Ação | | - | - | - | | `LIC004` logo após a atualização | O novo build incorpora um conjunto renovado de chaves públicas, e sua licença foi assinada com uma chave na qual o build não confia mais. | Emita uma nova licença no portal e substitua o arquivo conforme descrito em [Renovar ou substituir uma licença](/pt-BR/federal/air-gapped/license#renew-or-replace-a-license). Execute a [verificação de `kid`](/pt-BR/federal/air-gapped/license#check-the-key-id) para confirmar. | | Um código `MDL` em um arquivo de modelos que antes passava na validação | A nova versão alterou a validação do arquivo de modelos. | Execute `devin models validate`; o diagnóstico indica o campo e o código. Consulte [Arquivo de modelos](/pt-BR/federal/air-gapped/models-file). | Todo registro de auditoria `session_start` inclui o `cli_version`, o que permite ao seu SIEM confirmar o rollout: as sessões de uma estação de trabalho atualizada informam a nova versão. ## Reversão Mantenha o pacote e o checksum da versão anterior até que a nova versão seja validada em toda a frota. O procedimento de reversão é o mesmo da instalação: verifique o checksum do pacote mais antigo e instale-o por cima do mais recente. Em sistemas RPM, adicione `--oldpackage`, pois, sem essa opção, o `rpm -U` se recusa a substituir uma versão mais recente por uma mais antiga: ```sh theme={null} sudo rpm -U --oldpackage Devin-linux-x64-.rpm ``` ## Notas de versão As notas de versão dos builds air-gapped são publicadas junto com as demais notas de versão do Devin em [Atualizações recentes](/pt-BR/release-notes/overview). Antes de implantar uma nova versão, leia a entrada correspondente e verifique principalmente se há alterações nos formatos de armazenamento em disco ou no schema do registro de auditoria (o valor `schema_version`), códigos de erro novos ou alterados e alguma rotação de chave de licença que exija a reemissão de licenças. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.