Skip to main content
The doctor command runs a series of diagnostic checks to identify common problems with your Panguard installation, configuration, and runtime environment. It provides actionable recommendations for each issue found.

​
Usage

panguard doctor

​
Diagnostic Checks

The doctor command inspects the following areas:
CheckWhat It Verifies
InstallationBinary integrity, version currency, dependencies
ConfigurationConfig file validity, required fields, path permissions
AuthenticationToken validity, API endpoint reachability
GuardService status, log file health, resource usage
NetworkConnectivity to Panguard Cloud, DNS resolution, firewall rules
PermissionsFile ownership, directory access, elevated privilege requirements
Disk SpaceAvailable space for logs, scan data, and intelligence databases

​
Examples

panguard doctor

​
Sample Output

Panguard Doctor v1.2.0
======================

[PASS] Installation: binary intact, version 1.2.0 (latest)
[PASS] Configuration: ~/.panguard/config.yaml valid
[PASS] Authentication: logged in as user@example.com (Pro plan)
[WARN] Guard: not running -- start with 'panguard guard start'
[PASS] Network: cloud API reachable (latency 45ms)
[PASS] Permissions: all directories accessible
[FAIL] Disk Space: /var/log/panguard has only 200MB free (minimum 500MB)

1 failure, 1 warning, 5 passed
Run panguard doctor whenever you encounter unexpected behavior before opening a support ticket. The output is designed to be shared with the support team.

​
Plan Requirements

Available on all plans including Community (Free).

Common Issues

Solutions for frequently encountered problems.

panguard status

Quick health overview of all services.

Guard Troubleshooting

Specific troubleshooting for Guard agent issues.

Auth Troubleshooting

Fix authentication and login problems.