nself doctor
nself doctor — ɳSelf documentation.
Run system diagnostics.
Synopsis
nself doctor [flags]Description
nself doctor checks everything ɳSelf needs to function correctly and reports issues with actionable fix suggestions. It covers infrastructure prerequisites (Docker, Docker Compose, Git), Docker daemon health and permissions, disk and memory availability, network connectivity, configuration correctness, running container health, and plugin schema placement.
Run nself doctor when something is not working as expected, before deploying to a new environment, or as part of an automated health check pipeline. The --fix flag enables automatic remediation of common problems.
Exit codes: 0 all checks passed, 1 one or more checks failed, 2 warnings only.
Flags
| Flag | Default | Description |
|---|---|---|
--full |
false | Run all checks including network and memory (slower) |
--deep |
false | Alias for --full |
--verbose |
false | Detailed diagnostics output |
--json |
false | JSON output |
--format |
text |
Output format: json or text |
--fix |
false | Auto-fix safe issues |
--yes |
false | Non-interactive mode: accept all defaults (for CI/scripts) |
--only |
"" |
Run only a specific subsystem check: host, docker, postgres, hasura, nginx, ssl, ping, plugins, license, monitoring, backups, security |
--section |
"" |
Run only a specific section: system, core, backups, license, plugins, monitoring, security |
--skip |
none | Skip specific check sections |
--alerts |
false | Check monitoring alert rules are loaded |
--check-legacy |
false | Scan host for v0.9 stale paths (global scan, not per-project) |
--install-check |
false | Run 6-stage onboarding funnel check (used by Homebrew post-install hook) |
--ai |
false | Run the AI first-run wizard (install Ollama, setup Gemini pool, verify) |
--skip-ollama |
false | Skip local Ollama installation step |
--skip-pool |
false | Skip Gemini pool setup step |
--headless |
false | Print OAuth URL instead of opening browser (for SSH/headless servers) |
--help, -h |
none | Show help |
Checks Performed
| Category | What is Checked |
|---|---|
| Infrastructure | docker, docker compose, git are installed |
| Docker | Daemon running, user permissions, BuildKit available |
| Disk | ≥5 GB free space recommended |
| Memory | ≥2 GB RAM recommended |
| Network | Internet connectivity, Docker Hub reachable |
| Configuration | .env exists, required vars set, password strength meets requirements |
| Containers | Health status of running containers, error logs for unhealthy services |
| Plugin schemas | Warns if np_* tables are in the public schema instead of plugin schemas |
Examples
# Quick diagnostic
nself doctor
# Full diagnostic (includes network and memory checks)
nself doctor --full
# Verbose output with details per check
nself doctor --verbose
# JSON output for automated monitoring
nself doctor --json
# Suggest fixes for detected issues
nself doctor --fix
# Run only the Docker subsystem check
nself doctor --only docker
# Run only the security section
nself doctor --section security
# Run the AI first-run wizard
nself doctor --ai