conda-doctor

View report for the currently active environment

$ conda doctor

$ conda doctor [[-n|--name]] [environment_name]

$ conda doctor [[-p|--prefix]] [path/to/environment]

$ conda doctor [[-v|--verbose]]

conda-doctor [ENV_PATH] [--debug] [--section SECTION] [--json] [--fix] [-h --help]

ENV_PATH
    Path to specific Conda environment (default: checks all)

--debug
    Enable verbose debug logging


--section SECTION
    Limit checks to named section (e.g., prefix, activation, solver)


--json
    Emit machine-readable JSON output instead of human-readable report


--fix
    Attempt automatic fixes for detected issues (experimental; use cautiously)


-h, --help
    Display usage summary and exit

conda-doctor is a diagnostic utility for identifying and troubleshooting problems in Conda installations and environments. It scans environment prefixes for issues like missing files, broken symlinks, incorrect permissions, and activation script failures. The tool also checks solver satisfiability, package integrity, and shell hook configurations, categorizing findings into actionable sections such as prefix, activation, and solver. Ideal for data scientists and developers maintaining complex multi-environment setups, it provides verbose reports to pinpoint root causes of errors like failed activations or dependency conflicts.

Run without arguments to check all environments, or specify a path for targeted analysis. JSON output enables scripting and automation. While primarily for maintenance, its --fix mode offers semi-automated remediation for common issues, enhancing reproducibility in scientific computing workflows.

Third-party tool, not official Conda component.
--fix modifies environments; always backup first.
May require elevated privileges for system-wide checks.

pip install conda-doctor or conda install -c conda-forge conda-doctor

prefix: File/symlink integrity.
activation: Shell hook validation.
solver: Dependency resolution tests.

Developed as open-source project in 2021 by Conda community contributors. Hosted on conda-forge/PyPI; evolved to support Conda 4.10+ and multi-platform diagnostics.

conda(1), mamba(1)