Professional Linux system diagnostics, security auditing, and optimization CLI tool.
If Linux Doctor helps you, consider supporting the project:
GitHub Sponsors: https://github.com/sponsors/linuxdoctor213 Web Download: https://send-christina-conclude-butterfly.trycloudflare.com
Donate Crypto:
- Bitcoin (Legacy):
1FJfTzCsnHDJbW9Nmf4cHLr8sNgMA567xV - Bitcoin (SegWit):
3LptXh2hNNhxVS1MRAe2RhpWY57g5WoPwo - Ethereum:
0x7625b7a47beaa21ab593d0d31c6b3520db2810fb - Litecoin:
LVE5ofzuPzacrkqvyZovwp3m3bxXyrhtwh - Monero (XMR):
46GxGR9YpQdG5weXhA9gcGixGGiUENpigZFrxmnct7xjTxgMRMSErsyUEda18ejQQVYCFTrn2ZwsFGc2DF1QVLnbLBiFzQz
pip install linux-doctor
# Or download standalone:
curl -O https://raw.githubusercontent.com/nousresearch/linux-doctor/main/linux-doctor.py
chmod +x linux-doctor.py
./linux-doctor --check-all# Full system check
linux-doctor --check-all
# Security audit only
linux-doctor --check-security
# Full audit with optimization recommendations
linux-doctor --check-all --optimize
# Machine-readable output for automation
linux-doctor --check-all --json > report.json
# Selective checks
linux-doctor --check-system --check-disk --check-memory
linux-doctor --check-network --check-security| Feature | Details |
|---|---|
| System Info | Hostname, OS/kernel, architecture, uptime, CPU, container/VM detection |
| Disk Analysis | Usage, inodes, I/O stats, large directory scanning, threshold alerts |
| Memory Diagnostics | RAM/swap totals, hugepages, OOM scores, top consumers, pressure detection |
| Network Diagnostics | Interfaces, bandwidth, socket counts, DNS resolution + latency, port scanning |
| Security Audit | Root audit, SSH hardening, sudo config, world-writable files, firewall, sysctl |
| Optimization | Categorized recommendations with severity (HIGH/MED/LOW/INFO) |
| Output | Colorized terminal, JSON export, exit codes (0=clean, 1=issues) |
0— All checks passed, system is healthy1— Issues found (warnings or failures)2— Runtime error (missing commands, permission denied)
- Python 3.8+
- Linux (reads /proc, /sys, runs system commands)
- Common tools:
df,free,ip,ps,ss(most are pre-installed)
MIT — free for personal and commercial use.
If Linux Doctor helps you, consider a donation:
Bitcoin: 1FJfTzCsnHDJbW9Nmf4cHLr8sNgMA567xV
