Docs
Gateway service runbook
Doctor

Doctor

Scope

This page is a placeholder generated from the official source file structure.

What to verify

  • TODO: Add prerequisites and validation checklist.

Outline (from official headings)

  • Quick start
  • Headless / automation
  • What it does (summary)
  • Detailed behavior and rationale
    1. Optional update (git installs)
    1. Config normalization
    1. Legacy config key migrations
  • 2b) OpenCode Zen provider overrides
    1. Legacy state migrations (disk layout)
    1. State integrity checks (session persistence, routing, and safety)
    1. Model auth health (OAuth expiry)
    1. Hooks model validation
    1. Sandbox image repair
    1. Gateway service migrations and cleanup hints
    1. Security warnings
    1. systemd linger (Linux)
    1. Skills status
    1. Gateway auth checks (local token)
    1. Gateway health check + restart
    1. Channel status warnings

Further reading

  • Official source file: gateway/doctor.md
Discovery & transportsGateway lock