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

> Übersicht für Administratoren zu Air-gapped Devin Desktop und CLI: was Cognition bereitstellt, was Sie selbst bereitstellen, wie die Authentifizierung erfolgt und welche Endpunkte verwendet werden.

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

Der Air-gapped-Build von Devin Desktop und der Devin CLI ist für Netzwerke ohne Internetzugang konzipiert. Inferenzanfragen werden an Modell-Endpunkte gesendet, die Sie selbst hosten. Der Zugriff wird über eine signierte Lizenzdatei gesteuert, die lokal validiert wird, und jedes Ereignis wird in einem lokalen Audit-Protokoll erfasst.

Dieser Leitfaden richtet sich an Administratoren, die das Produkt installieren, konfigurieren und betreuen. Er ist als Runbook aufgebaut: Jede Seite behandelt einen Teil der Bereitstellung und schließt mit den möglichen Fehlercodes und den jeweils erforderlichen Maßnahmen ab.

> [!NOTE]
>
> **Beta.** Der Air-gapped-Build ist derzeit als Beta verfügbar. Unterstützte Plattformen sind macOS (Apple Silicon und Intel), Linux (x86\_64 und aarch64) und Windows (x64 und arm64).

***

## Was das Produkt ist

| Komponente | Funktion |
| - | - |
| **Devin Desktop (Air-gapped-Build)** | Die Desktop-Anwendung, die Sie über die Downloadseite für Air-gapped-Builds im Portal installieren. Sie enthält die air-gapped Devin CLI als Agent und kommuniziert lokal mit ihr. Sie bietet keine Cloud-Anmeldung, kein Cascade und keine automatischen Updates. |
| **Devin CLI (Air-gapped-Build)** | Der Terminal-Agent. Läuft eigenständig in einer Shell (`devin`) oder als Agent innerhalb von Desktop. Liest seinen Modellkatalog aus einer von Ihnen erstellten Modelldatei und seine Lizenzberechtigung aus einer von Ihnen installierten Lizenzdatei. |

Desktop und die enthaltene CLI werden aus demselben Release-Commit gebaut. Ein einzelnes Desktop-Paket ist daher eine vollständige, in sich konsistente Installation.

## Bevor Sie beginnen

### Von Cognition bereitgestellt

| Element | Behandelt in |
| - | - |
| Portalzugang mit einer aktiven On-Prem-Berechtigung für Ihr Team, eingerichtet von Ihrem Kundenbetreuungsteam | [Installation](/de/federal/air-gapped/install) |
| Die Desktop-Pakete (und die Desktop-Tunnel-CLI) auf der Air-gapped-Downloadseite des Portals, inklusive SHA-256-Prüfsummen | [Installation](/de/federal/air-gapped/install), [Updates](/de/federal/air-gapped/updates) |
| Signierte Lizenzdateien, die über das Portal ausgestellt werden; die öffentlichen Schlüssel zu ihrer Verifizierung sind in die Binärdateien eingebettet | [Lizenz](/de/federal/air-gapped/license) |

### Was Sie bereitstellen

| Element | Wo es behandelt wird |
| - | - |
| Ein Host mit einer unterstützten Plattform, auf dem die Lizenzdatei unter `/etc/devin/license.devin-onprem-license` (Windows: `C:\ProgramData\Devin\license.devin-onprem-license`) oder unter dem in `DEVIN_LICENSE_FILE` angegebenen Pfad installiert ist | [Lizenz](/de/federal/air-gapped/license) |
| Ein oder mehrere OpenAI-kompatible Modell-Endpunkte innerhalb Ihres Netzwerks, die in einer Modelldatei unter `/etc/devin/models.json` (Windows: `C:\ProgramData\Devin\models.json`) oder unter dem in `DEVIN_MODELS_FILE` angegebenen Pfad beschrieben sind | [Modelldatei](/de/federal/air-gapped/models-file) |
| Optional ein OIDC-Identitätsanbieter, um zusätzlich zur Lizenz eine Nutzeranmeldung vorauszusetzen | [SSO](/de/federal/air-gapped/sso) |
| Optional ein privates CA-Paket, falls Ihre Modell-Endpunkte oder Ihr IdP Zertifikate verwenden, die nicht im Vertrauensspeicher des Betriebssystems enthalten sind | [Netzwerk und Zertifikate](/de/federal/air-gapped/network-and-certificates) |

## Vom Produkt verwendete Endpunkte

Die air-gapped CLI und die Desktop-App werden vollständig über Dateien auf dem Host konfiguriert. Sie verwenden ausschließlich die Endpunkte, die Sie selbst konfigurieren:

* **Modell-Endpunkte**, die in Ihrer Modelldatei aufgeführt sind. Es gibt keinen Cloud-Modellkatalog: Modellliste, Modellauswahl und Inferenz-Routing stammen vollständig aus dieser Datei. Endpunkte müssen `https://` verwenden; reines `http://` wird nur für Loopback-Hosts (`localhost`, `127.0.0.0/8`, `[::1]`) akzeptiert, zum Beispiel für einen vLLM- oder Ollama-Server auf derselben Maschine.
* **Ihr Identitätsanbieter**, sofern Sie SSO aktivieren. Die CLI liest das OIDC-Discovery-Dokument des Issuers aus und verwendet dessen Autorisierungs-, Token- und JWKS-Endpunkte.
* **MCP-Server**, sofern Sie welche lokal konfigurieren.
* **Das Portal** (`windsurf.fedstart.com`), das ein Administrator im Browser aufruft, um Pakete herunterzuladen und Lizenzen auszustellen.

Das Audit-Protokoll und der Diagnosebericht werden lokal auf die Festplatte geschrieben. `devin update` ist deaktiviert; neue Versionen werden aus Paketen installiert, die Sie aus dem Portal herunterladen (siehe [Updates](/de/federal/air-gapped/updates)).

## Wie der Zugriff gesteuert wird

1. **Lizenz** (immer). Beim Start prüft die CLI die Signatur und den Gültigkeitszeitraum der Lizenzdatei anhand der in die Binary eingebetteten öffentlichen Schlüssel. Ohne gültige Lizenz startet die CLI nicht; siehe [Lizenz](/de/federal/air-gapped/license).
2. **SSO** (optional). Wenn Sie eine Auth-Datei erstellen, die `"mode": "sso"` festlegt, muss sich jeder Nutzer zusätzlich mit `devin auth login` bei Ihrem IdP anmelden. Die Anmeldung kann an die Mitgliedschaft in einer erforderlichen Gruppe gebunden werden, und eine laufende Sitzung wird anhand des zwischengespeicherten token erneut validiert; siehe [SSO](/de/federal/air-gapped/sso).

Beide Mechanismen werden von der CLI erzwungen und gelten daher gleichermaßen für die eigenständige Nutzung im terminal wie für den Agent in Desktop.

## Nächste Schritte

> **[Installation](/de/federal/air-gapped/install)**
>
> Laden Sie die Software aus dem Portal herunter, verifizieren Sie den Download, installieren Sie sie und führen Sie die erste Integritätsprüfung durch.

> **[Fehlercodes](/de/federal/air-gapped/error-codes)**
>
> Der vollständige Katalog der Codes `LIC`, `IDP`, `MDL`, `NET` und `CFG` mit Handlungsanweisungen für Betreiber.

> **[Fehlerbehebung](/de/federal/air-gapped/troubleshooting)**
>
> Das Runbook für `devin airgap doctor` und welche Informationen Sie an den Support senden sollten.

> **[Dateiformate auf dem Datenträger](/de/federal/air-gapped/on-disk-formats)**
>
> Konfigurationspfade je Betriebssystem und das JSONL-Schema des Audit-Protokolls für die Datenaufnahme in SIEM-Systeme.


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