Skip to main content
Questa documentazione riguarda le distribuzioni di Devin per il governo federale. Torna alla documentazione di Devin
Questa pagina ti guida nella prima installazione del bundle air-gapped di Devin Desktop, che include la Devin CLI air-gapped. Completa la procedura prima su una singola workstation, poi ripetila sulle altre postazioni seguendo il processo approvato per i supporti fisici.

​
Prima di iniziare

  • Hai effettuato l’accesso al portale come membro approvato di un team con un’autorizzazione on-prem attiva. In assenza dell’autorizzazione, la pagina dei download air-gapped segnala che non sei idoneo; in tal caso, contatta il tuo team di gestione dell’account.
  • Hai già preparato, o sei pronto a preparare, i due file necessari a ogni host prima del primo avvio:
    • un file di licenza, emesso dal portale (vedi Licenza);
    • un file dei modelli che descrive gli endpoint dei tuoi modelli (vedi File dei modelli).
  • L’host di destinazione utilizza una piattaforma supportata: macOS (Apple silicon o Intel), Linux (x86_64 o aarch64) oppure Windows (x64 o arm64).

​
Passaggio 1: Scarica il bundle dal portale

  1. Nel portale, apri Install → Air-gapped downloads (windsurf.fedstart.com/install/airgap).
  2. Scegli il programma di installazione di Devin Desktop per la piattaforma di destinazione. La pagina elenca un package per ciascuna piattaforma e formato: I file per Windows si chiamano DevinSetup-<arch>-<version>.exe e Devin-win32-<arch>-<version>.zip, dove <arch> è x64 o arm64. Il programma di installazione installa l’applicazione per tutti gli utenti; non è disponibile un programma di installazione per singolo utente.
  3. Annota il checksum SHA-256 riportato nella pagina accanto al file (usa Show checksum): ti servirà per il confronto dopo il trasferimento.
  4. Trasferisci il file nell’ambiente isolato dalla rete seguendo la procedura approvata per i supporti fisici.
La stessa pagina offre altri due download, ciascuno con il proprio checksum SHA-256: La CLI dell’agente Devin (devin) non fa parte di questi download: è inclusa in ogni package di Desktop (vedi Passaggio 5).

​
Passaggio 2: Verificare il checksum

Sull’host di destinazione (o prima di trasferire il file oltre l’air gap), calcola lo SHA-256 del file scaricato e confrontalo con il valore indicato nel portale.
La prima colonna deve corrispondere esattamente al checksum riportato nella pagina del portale. In caso contrario, elimina il file e scaricalo di nuovo.

​
Passaggio 3: Installazione

  1. Apri il file .dmg e trascina Devin - Airgap in /Applications.
  2. Prima del primo avvio, verifica la firma del codice e la notarizzazione:
    Se la firma è integra, spctl restituisce accepted, mentre codesign --verify non produce alcun output e termina con codice 0. Un output rejected o code object is not signed at all indica che il bundle è stato alterato durante il trasferimento: eliminalo e ricomincia dal Passaggio 1.
Su Linux, la verifica consiste nel confronto SHA-256 descritto nel Passaggio 2: i package non sono accompagnati da un file di firma separato.

​
Passaggio 4: Posizionare il file di licenza e il file dei modelli

Sia la CLI standalone sia l’agente integrato in Desktop leggono gli stessi due file. Salvali nei percorsi predefiniti, così non dovrai impostare alcuna variabile d’ambiente: Su Windows la directory predefinita è C:\ProgramData\Devin\; le variabili di override restano le stesse:

​
Windows: proteggere la cartella di configurazione

Su Windows questo passaggio è obbligatorio sia con il programma di installazione sia con il file zip, e il programma di installazione non lo esegue al posto tuo. Per impostazione predefinita, gli utenti standard possono creare file in una nuova cartella in C:\ProgramData: senza questa protezione, quindi, un utente potrebbe creare models.json (o il file di licenza o di autenticazione) prima di te e mantenerne il controllo. Prima di inserire qualsiasi file, da una sessione PowerShell con privilegi elevati, crea la cartella e limitane l’accesso in modo che SYSTEM e Administrators abbiano il controllo completo e gli utenti standard abbiano solo l’accesso in lettura:
Se C:\ProgramData\Devin\ esisteva già, i comandi precedenti non bastano: tutto ciò che un utente standard vi ha creato in precedenza resta di proprietà di quell’utente, e qualsiasi autorizzazione concessa esplicitamente sulla cartella a un altro utente o gruppo rimane in vigore. Dopo i comandi precedenti, esegui anche i seguenti, in quest’ordine. Questi comandi assegnano la proprietà della cartella e del suo contenuto al gruppo Administrators, rimuovono tutte le autorizzazioni esplicite dalla cartella, applicano di nuovo il blocco e reimpostano le autorizzazioni sul contenuto in modo che ereditino quelle della cartella:
Verifica il risultato. Nessuno dei comandi precedenti deve aver restituito un messaggio di errore per file o cartelle: /C fa sì che icacls continui anche quando non riesce a modificare un elemento, quindi un errore indica che quell’elemento ha mantenuto il proprietario o le autorizzazioni precedenti. Poi elenca le autorizzazioni della cartella e di tutto il suo contenuto:
L’elenco della cartella stessa, C:\ProgramData\Devin, deve contenere esattamente tre voci: NT AUTHORITY\SYSTEM:(OI)(CI)(F), BUILTIN\Administrators:(OI)(CI)(F) e BUILTIN\Users:(OI)(CI)(RX), nessuna delle quali contrassegnata con (I). Per ogni file e sottocartella al suo interno devono comparire gli stessi tre utenti e gruppi e nessun altro, ciascuno contrassegnato con (I) perché ereditato dalla cartella; per un file, le voci sono NT AUTHORITY\SYSTEM:(I)(F), BUILTIN\Administrators:(I)(F) e BUILTIN\Users:(I)(RX). Se in qualsiasi punto compare un altro utente o gruppo, se una voce della cartella è contrassegnata con (I) o se una voce di un file o di una sottocartella non è contrassegnata con (I), il blocco non è attivo: esegui di nuovo i comandi previsti per una cartella esistente. Quindi, dalla stessa sessione con privilegi elevati, copia nella cartella la licenza e il file dei modelli. Ogni voce di modello indica una variabile d’ambiente che contiene la relativa chiave API (api_key.env); tale variabile deve essere impostata nell’ambiente del processo che esegue l’agente. Consulta File dei modelli → Variabili d’ambiente delle chiavi API per sapere come fornirla a Desktop, il cui agente integrato eredita l’ambiente dell’app Desktop anziché quello della tua shell.

​
Passaggio 5: Individua la CLI inclusa

La CLI dell’agente Devin è integrata in ogni package Desktop ed è compilata dallo stesso commit di rilascio di Desktop, quindi le due versioni restano sempre allineate. Usa questo binario per i comandi devin … di questa guida, oppure aggiungilo al PATH. Verifica la versione:

​
Passaggio 6: Esegui la verifica dello stato di salute

Da una shell con lo stesso ambiente in cui verrà eseguito l’agente (in particolare con le variabili delle chiavi API indicate nel tuo file dei modelli), esegui:
Il comando termina con codice 0 solo se nessuna verifica ha esito negativo. Ogni riga FAIL riporta un codice di errore, ad esempio CFG002 o NET003: cercalo in Codici di errore e segui il runbook di Risoluzione dei problemi.

​
Passaggio 7: Primo avvio

Avvia l’app installata specificandone il percorso esplicito:
Evita open -a "Devin - Airgap": questo comando risolve il nome tramite LaunchServices e potrebbe selezionare una copia diversa da quella che hai verificato (ad esempio un .dmg montato o un’installazione precedente).
Se la licenza è mancante o non valida, Desktop si apre comunque, ma l’agente incluso non funziona: il pannello della chat mostra l’errore ACP -32019 license_invalid. Apri View → Output → Devin ACP, cerca la riga LIC00X e consulta Licenza.

​
Passaggi successivi

  • Configura l’SSO se la tua distribuzione richiede l’accesso degli utenti: SSO.
  • Aggiungi una CA privata se i tuoi endpoint usano certificati interni: Rete e certificati.
  • Scopri dove il prodotto salva il proprio stato e come importare il registro di audit: Formati su disco.