ContextQMD
Back to Eliza

eliza doctor

packages/docs/cli/doctor.mdx

2.0.11.1 KB
Original Source

eliza doctor

Runs health checks across four categories: System, Configuration, Storage, and Network. Reports pass/fail/warn status for each check with suggested fixes.

Options

FlagDescription
--no-portsSkip port availability checks
--fixAutomatically fix issues where possible (runs eliza sub-commands for auto-fixable checks)
--jsonOutput results as JSON (CI-friendly). Exits with code 1 if any checks fail.

Examples

bash
eliza doctor
eliza doctor --fix
eliza doctor --json
eliza doctor --no-ports

From a source checkout:

bash
bun run eliza:doctor

When to use it

  • After installing or updating Eliza
  • After changing ports or state directory paths
  • After moving ~/.eliza/ to a new location
  • When the agent fails to start or connectors do not load
  • When filing a bug report — include the doctor output