Fehlercode-Referenz für air-gapped Devin

Diese Dokumentation gilt für föderale Deployments von Devin. Zurück zur Devin-Dokumentation

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. 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
`MDL`	Validierung der Modelldatei	Modelldatei
`IDP`	SSO und Identity Provider	SSO
`NET`	Erreichbarkeit von Endpunkten, TLS, HTTP-Prüfung	Netzwerk und Zertifikate
`CFG`	Lokale Pfade, Konfiguration, Umgebung	Netzwerk und Zertifikate, Modelldatei

`LIC` Lizenz

Wird als LIC00n: <message> 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 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 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` 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.
`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.
`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.
`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.
`CFG005`	Die Definition eines benutzerdefinierten Unteragenten (`agents/**/AGENT.md` oder eine flache Datei `agents/<name>.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:

devin models validate

/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 beschrieben.

​LIC Lizenz

​MDL Modelldatei

​IDP SSO und Identity Provider

​NET Netzwerk

​CFG Konfiguration

​Fehlermeldungen richtig lesen

`LIC` Lizenz

`MDL` Modelldatei

`IDP` SSO und Identity Provider

`NET` Netzwerk

`CFG` Konfiguration

Fehlermeldungen richtig lesen