Skip to main content
Runs a read-only health check of your Momentic setup and prints a section-by-section report: CLI version, authentication, connectivity to the Momentic API (including TLS interception, WebSocket support, clock skew, and proxy settings), environment, installed browsers (including missing OS libraries needed to launch them), and your project configuration (deprecated options, legacy file format, agent versions that have a newer release available, tests that have neither a base URL nor an environment, and browsers referenced by tests that are not installed). Problems are listed at the end with a suggested fix for each, and the command exits non-zero when any are found. Warnings do not affect the exit code.
npx momentic doctor

Options

--api-key <key>
string
Momentic API key. Defaults to MOMENTIC_API_KEY or the key saved by momentic login.
-c, --config <config>
string
Path to the Momentic configuration file. Defaults to momentic.config.yaml in the current directory.
--fix
boolean
Remove deprecated options from the project configuration file.
--json
boolean
Output the report as JSON. Useful for attaching to support tickets.

Examples

Check the installation and project:
npx momentic doctor
Remove deprecated options from the project configuration:
npx momentic doctor --fix
Generate a machine-readable report for a support ticket:
npx momentic doctor --json