Ottili Coder

Coder doctor und Troubleshooting

Wie du Ottili Coder mit dem Coder doctor diagnostizierst und häufige Probleme bei Runs, Validierung, Cloud-Runs, Git, Desktop und Firmenkontext behebst – mit den echten Befehlen des Plattform-CLI.

Überblick

Der Coder doctor* ist die geführte Diagnose, die du ausführst, wenn Ottili Coder nicht wie erwartet arbeitet. Er prüft die Umgebung, in der Coder läuft, und zeigt die wahrscheinlichste Ursache mit konkreten Lösungsschritten. Der Befehl gehört zum Plattform-CLI* (ottili) und heißt ottili doctor troubleshoot.

Ottili Coder ist öffentlich als Public Beta (BETA)* verfügbar. Einzelne Fähigkeiten tragen eigene Reifestatus — Cloud-Runs sind in der Beta, die direkte Cloud-Auslieferung (Deployment) ist geplant (PLANNED). Der doctor hilft, wenn du eine Self-hosting- oder lokale Docker-Umgebung betreibst; für reine Nutzer der Oberflächen (Chat, CLI, Desktop, Cloud) gilt der Abschnitt „Häufige Coder-Probleme und Lösungen“ unten.

Wann du den Coder doctor nutzt

Setze den doctor ein, wenn:

ein Coder-Lauf stecken bleibt oder wiederholt fehlschlägt,
die Dienste, die Coder ausführen, nicht erreichbar sind,
Ports kollidieren oder Konfiguration fehlt,
du vor einer Fehlerbehebung die Systemgesundheit prüfen willst.

Der doctor arbeitet gegen die lokale, Docker-basierte Bereitstellung* (Container ottili_one_postgres, ottili_one_redis, Netzwerk ottili_one_network, Service-Registry config/service_registry.yaml, Umgebungsvariablen in keys/.env). Betreibt Ottili die Ausführung für dich (Ottili Cloud), ist die zugrundeliegende Gesundheit durch Ottili verwaltet — hier hilft der Abschnitt zu häufigen Problemen.

Den Coder doctor ausführen

Führe den doctor mit automatischer Erkennung aus, springe gezielt zu einer Kategorie, oder liste alle Kategorien auf:

ottili doctor troubleshoot --auto
ottili doctor troubleshoot --category database_connectivity
ottili doctor troubleshoot --list-categories

Mit --auto führt der doctor Konfigurations- und Gesundheitsprüfungen aus und schlägt die passende Kategorie vor. Mit --category springst du direkt zur gesuchten Ursache. Die interaktive Auswahl fragt bei mehreren Funden nach der Kategorie.

Verfügbare Issue-Kategorien

Kategorie	Bedeutung
`database_connectivity`	PostgreSQL ist nicht erreichbar oder antwortet nicht
`service_health`	Ein oder mehrere Dienste sind ungesund oder nicht erreichbar
`port_conflicts`	Mehrere Dienste beanspruchen denselben Port
`configuration_errors`	Fehlende oder ungültige Konfigurationsparameter
`dependency_failures`	Abhängigkeiten sind nicht verfügbar oder ungesund
`resource_exhaustion`	Systemressourcen (CPU, Speicher, Platte) erschöpft
`network_issues`	Netzwerkverbindungsprobleme zwischen Diensten

Jede Kategorie liefert eine geführte Diagnose mit Symptomen, Schritten, konkreten Befehlen und Verifikation pro Schritt.

Gesundheitsprüfung (health check)

Ergänzend zum doctor prüfst du einzelne Dienste mit dem health-Befehl, lokal oder auf einen Dienst, nur Konfiguration oder nur Port-Kollisionen begrenzt:

ottili health check
ottili health check --service unified_api
ottili health check --config-only
ottili health check --ports-only

Weitere, ebenfalls im Plattform-CLI verfügbare Werkzeuge sind ottili troubleshoot wizard (interaktiver Assistent), ottili troubleshoot service <dienst> (Startfehler eines Dienstes), ottili troubleshoot database (Datenbankverbindung) und ottili troubleshoot analyze <dienst> (KI-gestützte Root-Cause-Analyse).

Häufige Coder-Probleme und Lösungen

Ein Run steckt oder schlägt fehl

Prüfe den gewählten Modus* (Ask, Plan, Build, Fix, Review, Stabilize, Deploy, Full Run). Build, Fix, Stabilize, Deploy und Full Run dürfen Dateien ändern; Ask und Plan nur analysieren/planen. Siehe [Coder-Modi](/docs/coder-modes).
Sieh in den Logs des Laufs nach Exception- oder Fehlerzeilen; wiederhole mit einem gezielteren Modus (z. B. Fix für einen konkreten Fehler).
Bei Cloud-Runs denk daran, dass diese Beta (BETA)* tragen — siehe [Feature-Status-Labels verstehen](/docs/understand-feature-status-labels).

Validierungsschleife schlägt fehl

Validierungsschleifen prüfen Tests, Typen, Lint und Sicherheits-Gates; eine Aufgabe gilt erst dann als erledigt, wenn die Gates bestehen. Bei Fehlschlag:

lies die Validierungsmeldung und behebe den konkreten Check (Test, Typ, Lint, Secret/Abhängigkeit),
wiederhole den Lauf — die Schleife arbeitet mit Wiederholungen und expliziten Fehlerzuständen,
nutze den Modus Fix* oder Review*, um die Grundursache gezielt zu klären. Siehe [Validierung](/docs/coder-validation).

Cloud-Runs (Beta) und Deployment

Cloud-Runs* sind Beta (BETA): dieselbe Aufgabenliste läuft in Ottili Cloud*, damit lokale Rechner nicht blockiert werden. Einzelne Einschränkungen sind möglich. Siehe [Lokale, Cloud- und Hybrid-Runs](/docs/coder-local-cloud-hybrid-runs).
Deployment* (direkte Cloud-Auslieferung) ist geplant (PLANNED)* — bis die öffentliche Zielverbindung geschaltet ist, bereitet Coder validierte Ergebnisse vor. Behaupte nicht, dass direktes Deployment bereits verfügbar ist. Siehe [Deployment](/docs/coder-deployments) und [Produktlebenszyklus und Feature-Status](/docs/product-lifecycle-and-feature-status).
Wie Ottili ONE Reifestatus öffentlich kennzeichnet, beschreibt [Produktlebenszyklus und Feature-Status](/docs/product-lifecycle-and-feature-status).

Git-Integration

Coder arbeitet in deinem bestehenden Repository: Branch pro Run, Commit pro Task, Pull Request zur Review, Branch-Protection. Wenn die GitHub-Verbindung fehlschlägt:

prüfe die GitHub-App/den Connector und die Berechtigungen,
stelle sicher, dass ein Repository mit dem Workspace verbunden ist,
bei Branch-Protection-Konflikten den PR manuell freigeben. Siehe [Git-Integration](/docs/coder-git).

Desktop-App

Die Ottili Coder Desktop*-App für Windows, macOS und Linux trägt den Status verfügbar (AVAILABLE). Wenn sie nicht startet:

prüfe die Anmeldung (Sign in with Ottili* / One Login) und den Firmenkontext,
stelle sicher, dass die App auf die aktuelle Coder-Umgebung zeigt,
bei Sync-Problemen die App neu starten und erneut anmelden.

Firmenkontext und Anmeldung

Jeder Coder-Lauf gehört zu genau einem Unternehmen (company_id). Wenn Aktionen dem falschen Unternehmen zugeordnet werden, prüfe den aktiven Firmenkontext in deiner Sitzung. Siehe [Plattform-Schicht und Produkt-Schicht](/docs/platform-layer-and-product-layer) und [Installation](/docs/coder-installation).

Sicherheitsprüfungen

Ottili Security Check* prüft Abhängigkeits- und Secret-Risiken in dasselbe Aufgabensystem. Schlägt eine Prüfung fehl, wird das als Validierungsfehler sichtbar — behebe das gemeldete Risiko, bevor der Lauf als erledigt gilt. Siehe [Coder-Sicherheit](/docs/coder-security).

Status und Verfügbarkeit

Fähigkeit	Status
Repository-Analyse	Verfügbar (AVAILABLE)
Pläne	Verfügbar (AVAILABLE)
Aufgabenlisten (Task Queues)	Verfügbar (AVAILABLE)
Agenten	Verfügbar (AVAILABLE)
Validierungs-Schleifen	Verfügbar (AVAILABLE)
CLI	Verfügbar (AVAILABLE)
Desktop	Verfügbar (AVAILABLE)
Cloud-Runs	Beta (BETA)
Deployment (Auslieferung)	Geplant (PLANNED)
Sicherheitsprüfungen	Verfügbar (AVAILABLE)

Quelle: kanonische Feature-Status-Registry config/product_truth/coder_feature_status.yaml. Die Reifestatus einzelner Fähigkeiten sind in [Feature-Status-Labels verstehen](/docs/understand-feature-status-labels) erklärt.

Verwandte Artikel

[Ottili Coder – Überblick](/docs/ottili-coder)
[Coder-Modi](/docs/coder-modes)
[Validierung](/docs/coder-validation)
[Git-Integration](/docs/coder-git)
[Coder-Sicherheit](/docs/coder-security)
[Deployment](/docs/coder-deployments)
[Lokale, Cloud- und Hybrid-Runs](/docs/coder-local-cloud-hybrid-runs)
[Installation](/docs/coder-installation)
[Feature-Status-Labels verstehen](/docs/understand-feature-status-labels)
[Produktlebenszyklus und Feature-Status](/docs/product-lifecycle-and-feature-status)
[Plattform-Schicht und Produkt-Schicht](/docs/platform-layer-and-product-layer)
[Was ist Ottili ONE?](/docs/what-is-ottili-one)

War dieser Artikel hilfreich?