> ## 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.

# Air-gapped Devin Desktop und CLI aktualisieren

> Wie neue air-gapped Versionen von Devin Desktop und CLI auf der Download-Seite des Portals erscheinen und wie Sie ein Update ohne automatische Aktualisierung prüfen, installieren und validieren.

> [!NOTE]
>
> Diese Dokumentation gilt für föderale Deployments von Devin. [Zurück zur Devin-Dokumentation](/de/get-started/devin-intro)

Die air-gapped Versionen von Desktop und CLI aktualisieren sich nie selbst: Im Desktop-Build ist die automatische Aktualisierung deaktiviert, in der CLI der Befehl `devin update`. Jedes Update ist ein neues Paket, das Sie aus dem Portal herunterladen, prüfen und auf jeder Workstation installieren – nach demselben Verfahren wie bei der ersten [Installation](/de/federal/air-gapped/install). Auf dieser Seite erfahren Sie, was sich beim zweiten Mal unterscheidet.

***

## So erscheint eine neue Version

Die Seite **Install → Air-gapped downloads** des Portals ([`windsurf.fedstart.com/install/airgap`](https://windsurf.fedstart.com/install/airgap)) stellt immer genau ein Release bereit. Die Version wird in der Überschrift **Downloads** angezeigt (zum Beispiel `version 1.66.101 (0123abcdef)`). Die SHA-256-Prüfsumme der einzelnen Dateien können Sie über das danebenliegende Steuerelement **Show checksum** einblenden.

Wenn Cognition einen neuen air-gapped Build für Ihr Portal veröffentlicht, stellt die Seite die neue Version samt Prüfsummen anstelle der bisherigen bereit. Es gibt weder ein Auswahlsteuerelement für Versionen noch eine Benachrichtigung. Um neue Releases zu verfolgen, prüfen Sie die Versionsangabe auf der Download-Seite im Rahmen Ihres regulären Wartungszyklus.

## Schritt 1: Prüfen Sie, welche Version Sie verwenden

Vergleichen Sie auf einer Workstation die installierte CLI-Version mit der Version auf der Download-Seite:

```sh theme={null}
devin --version
```

```text theme={null}
devin-federal <version>+airgap.<sha>
```

`devin --version` gibt die Release-Version und den kurzen Commit-Hash des Builds aus. Desktop und die mitgelieferte CLI werden aus demselben Commit gebaut, daher gilt diese Version für beide.

## Schritt 2: Neues Paket herunterladen und prüfen

Führen Sie für die neue Version [Schritt 1](/de/federal/air-gapped/install#step-1-download-the-bundle-from-the-portal) und [Schritt 2](/de/federal/air-gapped/install#step-2-verify-the-checksum) der Installationsanleitung aus: Laden Sie das Paket für jede Plattform in Ihrer Flotte herunter, notieren Sie die Prüfsumme von der Portalseite, übertragen Sie die Dateien über den Air Gap und stellen Sie vor der Installation sicher, dass der SHA-256-Wert übereinstimmt.

Prüfsummen ändern sich mit jedem Release. Notieren Sie beim Herunterladen den neuen Wert von der Portalseite und verwenden Sie keine Prüfsumme aus einer früheren Version.

## Schritt 3: Über die vorhandene Version installieren

Beenden Sie zuerst Desktop und stoppen Sie alle laufenden `devin`-Sitzungen auf der Workstation. Konfiguration, Sitzungsverlauf, das Audit-Protokoll und SSO-Anmeldungen werden außerhalb der Anwendung gespeichert (siehe [Formate auf dem Datenträger](/de/federal/air-gapped/on-disk-formats)) und bleiben beim Update erhalten.

**macOS**

Öffnen Sie die neue `.dmg`-Datei und ziehen Sie **Devin - Airgap** nach `/Applications`. Ersetzen Sie die vorhandene Anwendung, wenn Sie dazu aufgefordert werden. Überprüfen Sie anschließend die Signatur wie in [Schritt 3 der Installationsanleitung](/de/federal/air-gapped/install#step-3-install) beschrieben:

```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-<new-version>.deb   # Debian/Ubuntu
sudo rpm -U Devin-linux-x64-<new-version>.rpm    # RHEL/Fedora
```

`dpkg -i` aktualisiert ein installiertes Paket direkt an Ort und Stelle. Verwenden Sie `rpm -U` (nicht `rpm -i`), damit `rpm` die installierte Version ersetzt, statt die Installation abzulehnen. Für air-gapped Builds gibt es kein apt- oder yum-Repository.

**Linux (.tar.gz)**

Verschieben Sie das bisher entpackte Verzeichnis und entpacken Sie dann das neue Archiv an denselben Ort, damit der Starterpfad (`/opt/Devin-linux-x64/bin/devin-airgap`) und alle `PATH`-Einträge für die mitgelieferte `devin`-Binary gültig bleiben:

```sh theme={null}
sudo mv /opt/Devin-linux-x64 /opt/Devin-linux-x64.previous
sudo tar -xzf Devin-linux-x64-<new-version>.tar.gz -C /opt
```

Entfernen Sie `/opt/Devin-linux-x64.previous`, sobald die neue Version validiert ist.

**Windows (installer)**

Überprüfen Sie die Authenticode-Signatur des neuen Installationsprogramms wie in [Schritt 3 der Installationsanleitung](/de/federal/air-gapped/install#step-3-install) beschrieben und führen Sie es dann als Administrator aus:

```powershell theme={null}
Get-AuthenticodeSignature .\DevinSetup-x64-<new-version>.exe | Format-List Status, SignerCertificate
```

Der air-gapped Build hat keine Update-URL. Eine installierte Kopie lässt sich ausschließlich über ein neues Installationsprogramm aktualisieren.

**Windows (.zip)**

Entpacken Sie `Devin-win32-x64-<new-version>.zip` in einen eigenen Ordner, überprüfen Sie die Signatur der entpackten ausführbaren Dateien wie in [Schritt 3 der Installationsanleitung](/de/federal/air-gapped/install#step-3-install) beschrieben und starten Sie Desktop aus dem neuen Ordner.

Entfernen Sie den vorherigen Ordner, sobald die neue Version validiert ist, und passen Sie alle `PATH`-Einträge für die mitgelieferte `devin.exe` an.

Die Lizenzdatei, die Modelldatei und die Authentifizierungsdatei unter `/etc/devin/` (unter Windows `C:\ProgramData\Devin\`) sind nicht Teil des Pakets und bleiben von einem Update unberührt.

## Schritt 4: Das Update überprüfen

Führen Sie auf jeder aktualisierten Workstation als normaler Nutzer Folgendes aus:

```sh theme={null}
devin --version
devin airgap doctor
```

```text theme={null}
devin-federal <new-version>+airgap.<sha>
pass  license                                seat alice@example.gov (account acme), expires 2027-03-01
...
10 check(s): 10 passed, 0 warning(s), 0 failure(s)
```

Starten Sie anschließend Desktop einmal und vergewissern Sie sich, dass damit eine Sitzung mit Ihrem Modell-Endpunkt geöffnet wird.

Auf zwei Update-spezifische Fehlschläge sollten Sie achten:

| Symptom | Ursache | Maßnahme |
| - | - | - |
| `LIC004` unmittelbar nach dem Update | Der neue build enthält einen rotierten Satz öffentlicher Schlüssel, und Ihre Lizenz wurde mit einem Schlüssel signiert, dem der build nicht mehr vertraut. | Stellen Sie im Portal eine neue Lizenz aus und ersetzen Sie die Datei wie unter [Lizenz erneuern oder ersetzen](/de/federal/air-gapped/license#renew-or-replace-a-license) beschrieben. Führen Sie zur Bestätigung die [`kid`-Prüfung](/de/federal/air-gapped/license#check-the-key-id) aus. |
| Ein `MDL`-Code bei einer Modelldatei, die zuvor erfolgreich validiert wurde | Mit dem neuen release hat sich die Validierung von Modelldateien geändert. | Führen Sie `devin models validate` aus; die Diagnose nennt das betroffene Feld und den Code. Siehe [Modelldatei](/de/federal/air-gapped/models-file). |

Jeder `session_start`-Audit-Eintrag enthält die `cli_version`, sodass Ihr SIEM den rollout bestätigen kann: Sitzungen von einer aktualisierten Workstation melden die neue Version.

## Rollback auf eine frühere Version

Bewahren Sie das Paket und die Prüfsumme der vorherigen Version auf, bis die neue Version auf allen Systemen der Flotte validiert ist. Ein Rollback folgt demselben Vorgehen wie die Installation: Prüfen Sie die Prüfsumme des älteren Pakets und installieren Sie es über das neuere. Fügen Sie auf RPM-Systemen `--oldpackage` hinzu, da `rpm -U` sich sonst weigert, eine neuere Version durch eine ältere zu ersetzen:

```sh theme={null}
sudo rpm -U --oldpackage Devin-linux-x64-<previous-version>.rpm
```

## Versionshinweise

Versionshinweise für air-gapped Builds werden zusammen mit den übrigen Devin-Versionshinweisen unter [Neueste Updates](/de/release-notes/overview) veröffentlicht. Lesen Sie vor dem Rollout einer neuen Version den zugehörigen Eintrag und achten Sie insbesondere auf Änderungen an den Formaten auf dem Datenträger oder am Audit-Log-Schema (Wert `schema_version`), auf neue oder geänderte Fehlercodes sowie auf eine etwaige Rotation des Lizenzschlüssels, die eine Neuausstellung der Lizenzen erfordert.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.