Skip to content

Operator diagnostics with automax doctor

automax doctor checks the local controller environment before you run jobs against real systems.

automax doctor

Typical output:

Automax doctor
  OK   python: 3.12.3
  OK   automax: 1.0.0
  OK   paramiko: installed
  OK   database.sqlite: installed
  WARN database.postgres: optional driver missing
  WARN database.mysql: optional driver missing
  WARN database.oracle: optional driver missing
  OK   state-dir: /home/operator/automation/.automax/runs
  OK   ssh: /usr/bin/ssh
  OK   plugins: 67 builtin plugins

Optional database drivers are reported as warnings because SQLite is builtin and PostgreSQL, MySQL and Oracle support is installed only when their extras are needed.

JSON output

For CI or support scripts:

automax doctor --json

State directory check

Use --state-dir to verify a custom run-state location:

automax doctor --state-dir /var/lib/automax/runs