> ## 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. # Fehlercode-Referenz für air-gapped Devin > Vollständiger Katalog der LIC-, MDL-, IDP-, NET- und CFG-Fehlercodes, die von der air-gapped Devin CLI und Devin Desktop ausgegeben werden, jeweils mit Bedeutung und erforderlicher Maßnahme für Administratoren. > [!NOTE] > > Diese Dokumentation gilt für föderale Deployments von Devin. [Zurück zur Devin-Dokumentation](/de/get-started/devin-intro) Jeder Fehler, den die air-gapped CLI und Desktop diagnostizieren können, wird mit einem stabilen Code im Format `XXXnnn` gemeldet. Die Codes stehen am Anfang der Fehlermeldung im Terminal, in der Ausgabe von `devin airgap doctor`, in den Diagnosedaten von Desktop sowie im Feld `error_code` von `auth`-[Audit-Ereignissen](/de/federal/air-gapped/on-disk-formats#auth). Die Nummer bezeichnet den Fehlerzustand, nicht den Wortlaut der Meldung. Sie können Support-Runbooks und SIEM-Alarme daher zuverlässig daran ausrichten. | Namensraum | Bereich | Detailseite | | - | - | - | | `LIC` | Validierung der Lizenzdatei | [Lizenz](/de/federal/air-gapped/license) | | `MDL` | Validierung der Modelldatei | [Modelldatei](/de/federal/air-gapped/models-file) | | `IDP` | SSO und Identity Provider | [SSO](/de/federal/air-gapped/sso) | | `NET` | Erreichbarkeit von Endpunkten, TLS, HTTP-Prüfung | [Netzwerk und Zertifikate](/de/federal/air-gapped/network-and-certificates) | | `CFG` | Lokale Pfade, Konfiguration, Umgebung | [Netzwerk und Zertifikate](/de/federal/air-gapped/network-and-certificates), [Modelldatei](/de/federal/air-gapped/models-file) | ## `LIC` Lizenz Wird als `LIC00n: ` ausgegeben, gefolgt vom geprüften Pfad und einem Hinweis, wie er sich überschreiben lässt (`DEVIN_LICENSE_FILE`). | Code | Bedeutung | Vorgehen | | - | - | - | | `LIC001` | Lizenzdatei fehlt oder ist unter `/etc/devin/license.devin-onprem-license` (`C:\ProgramData\Devin\license.devin-onprem-license` unter Windows) bzw. unter dem Pfad aus `DEVIN_LICENSE_FILE` nicht lesbar. Unter Windows wird dieser Code auch zurückgegeben, wenn ein Standardnutzer versucht, über Desktop eine Lizenz zu ersetzen, die einem Administrator gehört. | Installieren Sie die Datei im Standardpfad oder setzen Sie `DEVIN_LICENSE_FILE`; prüfen Sie die Leseberechtigung des Nutzers, unter dem Devin ausgeführt wird. | | `LIC002` | Fehlerhafte Datei: kein gültiges EdDSA-JWT oder kein `kid` im header. | Laden Sie die Lizenz erneut aus dem Portal herunter und übertragen Sie sie bytegenau (ohne zusätzlichen Zeilenumbruch, Zeilenumbrüche innerhalb des Inhalts oder geänderte Kodierung). | | `LIC003` | Signaturprüfung fehlgeschlagen. | Die Nutzdaten wurden nach dem Signieren verändert. Laden Sie die Lizenz erneut herunter. | | `LIC004` | Unbekannter `kid`: In diesem build ist kein passender öffentlicher Schlüssel eingebettet. | Führen Sie die [`kid`-Prüfung](/de/federal/air-gapped/license#check-the-key-id) durch. Die Lizenz wurde von einer anderen Umgebung ausgestellt, oder Ihr build ist älter als eine Schlüsselrotation; installieren Sie das aktuelle Release. | | `LIC005` | Abgelaufen und die 24-stündige Kulanzfrist überschritten. | Erneuern Sie die Lizenz über das Portal. | | `LIC006` | Noch nicht gültig: Das Ausstellungsdatum liegt mehr als 24 Stunden in der Zukunft. | Prüfen Sie die Systemuhr des Hosts; ist sie korrekt, wenden Sie sich an Ihr Support-Team. | | `LIC007` | Falscher `product`-Claim (nicht `devin-onprem`). | Die Datei ist keine air-gapped Devin-Lizenz. Laden Sie sie erneut aus dem Portal herunter. | ## `MDL` Modelldatei Gemeldet von `devin models validate`, `devin airgap doctor`, den Modelleinstellungen in Desktop und beim Start des Agents. Jede Diagnose nennt den Modelleintrag, auf den sie sich bezieht. | Code | Bedeutung | Vorgehen | | - | - | - | | `MDL001` | Die Datei ist kein gültiges JSON für Schema v0 (dies umfasst auch unbekannte Felder). | Beheben Sie die Fehler im JSON; entfernen Sie Felder, die nicht im [Schema](/de/federal/air-gapped/models-file#schema-reference-version-0) enthalten sind. | | `MDL002` | Nicht unterstützte `schema_version`. | Setzen Sie `"schema_version": 0`. | | `MDL003` | `models` ist leer. | Fügen Sie mindestens einen Modelleintrag hinzu. | | `MDL004` | Ein Modell hat einen leeren `name`. | Geben Sie jedem Eintrag einen eindeutigen `name`. | | `MDL005` | Doppelter Modell-`name`. | Benennen Sie einen der Einträge um. | | `MDL006` | Leere `base_url`. | Legen Sie die Endpunkt-URL fest. | | `MDL007` | Leeres `api_key.env`. | Geben Sie die Umgebungsvariable an, die den Schlüssel enthält. | | `MDL008` | `max_context_tokens` ist null. | Legen Sie das Kontextfenster des Modells fest. | | `MDL009` | Mehr als ein Modell ist als `default` markiert. | Belassen Sie `default: true` bei genau einem Eintrag. | | `MDL010` | `base_url` ist keine `https://`-URL mit Host (`http://` wird nur für Loopback-Adressen akzeptiert). | Verwenden Sie `https://` oder für einen Server auf demselben Host eine Loopback-Adresse. | | `MDL011` | `max_output_tokens` überschreitet `max_context_tokens`. | Verringern Sie `max_output_tokens`. | | `MDL012` | Die Datei existiert, konnte aber nicht gelesen werden (Berechtigungen oder ungültiges UTF-8). | Korrigieren Sie die Leseberechtigung für den Nutzer, unter dem Devin ausgeführt wird; speichern Sie die Datei als UTF-8. | | `MDL013` | `max_output_tokens` ist null. | Entfernen Sie das Feld oder setzen Sie einen positiven Wert. | | `MDL014` | Die Datei gehört einem anderen Nutzer, daher verweigert Desktop das Ersetzen. | Bearbeiten Sie die Datei direkt auf dem Datenträger als deren Eigentümer, oder lassen Sie `DEVIN_MODELS_FILE` auf eine Datei verweisen, die Ihnen gehört. | ## `IDP` SSO und Identity Provider Wird von `devin auth login` und `devin auth status`, beim Start des Agents sowie im Anmeldeablauf der Desktop-App gemeldet. `IDP004` und `IDP005` werden bei `sso_login_denied`-Events zusätzlich in das Audit-Protokoll geschrieben, und jeder `IDP`-Code kann bei `sso_revalidation_failed` auftreten. | Code | Bedeutung | Vorgehen | | - | - | - | | `IDP001` | Die Auth-Datei ist nicht lesbar oder ungültig. | Korrigieren Sie `/etc/devin/auth.json` (`C:\ProgramData\Devin\auth.json` unter Windows) bzw. die Datei unter dem in `DEVIN_AUTH_FILE` angegebenen Pfad; die Meldung nennt das fehlerhafte Feld. | | `IDP002` | Für den konfigurierten Issuer ist keine zwischengespeicherte Anmeldung vorhanden. | Führen Sie `devin auth login` aus. | | `IDP003` | Die Anmeldung ist ungültig oder abgelaufen und konnte nicht automatisch im Hintergrund erneuert werden (z. B. aufgrund einer `invalid_grant`-Antwort des IdP). | Führen Sie `devin auth login` erneut aus. | | `IDP004` | Die Anmeldung war erfolgreich, aber der Nutzer ist kein Mitglied von `required_group`. | Fügen Sie den Nutzer beim IdP zur Gruppe hinzu oder korrigieren Sie `required_group` / `groups_claim` in der Auth-Datei. | | `IDP005` | Der IdP war nicht erreichbar, hat einen Fehler zurückgegeben oder ein ID-Token geliefert, dessen Validierung fehlgeschlagen ist. | Prüfen Sie die Netzwerkerreichbarkeit, das TLS-Vertrauen (`DEVIN_CA_BUNDLE`), den Wert von `issuer` sowie die Logs des IdP. | | `IDP006` | Der lokale SSO-Token-Cache ist nicht lesbar, fehlerhaft oder nicht ausschließlich für den aktuellen Nutzer zugänglich. | Führen Sie `devin auth login` aus; bei einer neuen Anmeldung wird der Cache mit Berechtigungen ausschließlich für den Eigentümer neu geschrieben. | ## `NET` Netzwerk Wird von den Endpunkt-Prüfungen von `devin airgap doctor` sowie bei Inferenz- und IdP-Anfragen gemeldet. Jeder `NET`-Fehler enthält die zugrunde liegende Fehlerkette. | Code | Bedeutung | Vorgehen | | - | - | - | | `NET001` | Die DNS-Auflösung des Endpunkt-Hosts ist fehlgeschlagen. | Prüfen Sie den Hostnamen in der Modelldatei bzw. Auth-Datei sowie die DNS-Konfiguration der Workstation. | | `NET002` | Die TCP-Verbindung konnte nicht hergestellt werden (abgelehnt, zurückgesetzt oder nicht routbar). | Prüfen Sie, ob der Endpunkt auf dem Port lauscht und ob Firewall- oder Proxy-Regeln der Workstation den Zugriff darauf erlauben. | | `NET003` | Der TLS-Handshake ist fehlgeschlagen: nicht vertrauenswürdiges, abgelaufenes oder nicht übereinstimmendes Zertifikat. `devin airgap doctor` gibt, sofern verfügbar, das vom Server vorgelegte Zertifikat (Subject, Issuer, Ablaufdatum) aus und zeigt an, ob `DEVIN_CA_BUNDLE` aktiv war. | Hinterlegen Sie die private CA über [`DEVIN_CA_BUNDLE`](/de/federal/air-gapped/network-and-certificates#trust-a-private-ca-with-devin_ca_bundle) als vertrauenswürdig oder korrigieren Sie das Serverzertifikat (Name, Kette, Ablaufdatum). | | `NET004` | Der Endpunkt hat einen Fehlerstatus (HTTP) außer 401/403 zurückgegeben. Ein `404` bei `GET {base_url}/models` wird als Warnung gemeldet, da einige OpenAI-kompatible Server `/models` nicht implementieren. | Prüfen Sie die Logs des Endpunkts selbst sowie den Pfad in `base_url` (zum Beispiel ein fehlendes `/v1`). | | `NET005` | Zeitüberschreitung der Anfrage (10 s für Doctor-Prüfungen, 30 s für IdP-Anfragen, 30 s Verbindungsaufbau / 300 s Lesen für Inferenz). | Prüfen Sie die Auslastung des Endpunkts und etwaiger zwischengeschalteter Proxys; siehe [Timeouts](/de/federal/air-gapped/network-and-certificates#timeouts). | | `NET006` | Der Endpunkt hat die konfigurierten Anmeldedaten abgelehnt (HTTP 401/403). | Prüfen Sie den Wert der in `api_key.env` angegebenen Variablen und ob der Schlüssel für den Endpunkt gültig ist. | ## `CFG` Konfiguration Wird von `devin airgap doctor` und beim Start gemeldet. | Code | Bedeutung | Vorgehen | | - | - | - | | `CFG001` | Ein erforderliches Konfigurations- oder Zustandsverzeichnis fehlt oder ist nicht beschreibbar (`~/.config/devin`, `~/.local/share/devin` oder das Produktverzeichnis `cli-federal`; unter Windows `%APPDATA%\devin` oder dessen Unterverzeichnis `cli-federal`). | Erstellen Sie das Verzeichnis oder korrigieren Sie Eigentümer und Berechtigungen für den Nutzer, unter dem Devin ausgeführt wird. | | `CFG002` | Eine Umgebungsvariable, auf die die Konfiguration verweist (`api_key.env` eines Modells), ist in der Umgebung des Agents nicht gesetzt. | Exportieren Sie die Variable oder setzen Sie sie über die Desktop-Einstellung `devin.acp.agentEnv`; siehe [Umgebungsvariablen für API-Schlüssel](/de/federal/air-gapped/models-file#api-key-environment-variables). | | `CFG003` | Die Modelldatei wurde weder unter `/etc/devin/models.json` (unter Windows `C:\ProgramData\Devin\models.json`) noch über die Überschreibung `DEVIN_MODELS_FILE` gefunden. | Installieren Sie die Modelldatei; siehe [Modelldatei](/de/federal/air-gapped/models-file). | | `CFG004` | Die Datei `DEVIN_CA_BUNDLE` fehlt, ist nicht lesbar oder enthält keine gültigen PEM-Zertifikate. | Korrigieren Sie den Pfad oder den Dateiinhalt; siehe [Netzwerk und Zertifikate](/de/federal/air-gapped/network-and-certificates). | | `CFG005` | Die Definition eines benutzerdefinierten Unteragenten (`agents/**/AGENT.md` oder eine flache Datei `agents/.md`) konnte nicht geparst werden, meist wegen ungültiger YAML-frontmatter; das Profil wird übersprungen. Wird außerdem als Warnung gemeldet, wenn eine Definition frontmatter-Schlüssel enthält, die Devin nicht auswertet (zum Beispiel `allowed_tools` statt `allowed-tools`); das Profil wird trotzdem geladen. | Korrigieren Sie die genannte Datei anhand des Parse-Fehlers, den `devin doctor` ausgibt. | | `CFG006` | Es ist eine `OTEL_EXPORTER_OTLP_*`-Umgebungsvariable gesetzt, die der OTLP-Export ignoriert (jedes Feld außer `ENDPOINT`, `HEADERS`, `TIMEOUT` und `PROTOCOL`, jede `TRACES_`-Variable oder ein nicht unterstütztes `PROTOCOL`). Nur eine Warnung; ausgegeben wird ausschließlich der Variablenname, nie ihr Wert. | Entfernen oder korrigieren Sie die Variable. | `CFG005` und `CFG006` stammen aus den Standard-Checks von `devin doctor` und betreffen nicht speziell den air-gapped build. ## Fehlermeldungen richtig lesen Ein typischer Validierungsfehler: ```sh theme={null} devin models validate ``` ```text theme={null} /etc/devin/models.json: 1 problem(s) found MDL010 [model 'qwen3-vl-32b']: model 'qwen3-vl-32b': `base_url` must be an https:// URL (plain http:// is only allowed for loopback addresses: localhost, 127.0.0.0/8, or [::1]) ``` Suchen Sie den Code in den obigen Tabellen, führen Sie die angegebene Maßnahme durch und führen Sie anschließend `devin airgap doctor` erneut aus, bis alle Prüfungen bestanden sind. Ist ein Code hier nicht aufgeführt, ist Ihr Build neuer als diese Seite. Führen Sie in diesem Fall `devin --version` aus und fügen Sie die vollständige Meldung Ihrer Support-Anfrage bei, wie unter [Fehlerbehebung](/de/federal/air-gapped/troubleshooting) beschrieben. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.