💊 Debian Doctor

Comprehensive system diagnostic and troubleshooting tool for Debian Linux and derivatives (Ubuntu, Mint, Pop!_OS, etc.)

Key Features

💾

Disk Space Analysis

Monitor disk usage with configurable warning thresholds and identify space-consuming directories

🧠

Memory Monitoring

Track RAM and swap usage, detect memory leaks, and optimize system performance

🔧

Service Health Checks

Monitor critical system services and automatically detect failed or degraded services

🌐

Network Diagnostics

Test connectivity, DNS resolution, and network configuration issues

📦

Package System Integrity

Verify APT configuration, check for broken packages, and validate repositories

📊

Interactive Troubleshooting

Guided diagnosis with specific fixes and solutions for common problems

See It In Action

$ sudo ./debian_doctor.sh

═══════════════════════════════════════════════════════════════
                     🩺 DEBIAN DOCTOR 🩺                      
           System Diagnostic and Troubleshooting Tool          
═══════════════════════════════════════════════════════════════

━━━━━━━━━━━━━━━━━━━━━━ System Information ━━━━━━━━━━━━━━━━━━━━━━
 OS: Ubuntu 22.04.3 LTS
 Kernel: 5.15.0-91-generic
 Architecture: x86_64
 Uptime: 15 days, 3:42

━━━━━━━━━━━━━━━━━━━━━━ Disk Space Check ━━━━━━━━━━━━━━━━━━━━━━
 Root filesystem (/): 45% used (OK)
 /home: 87% used (WARNING - Above 85% threshold)
 /var: 62% used (OK)

━━━━━━━━━━━━━━━━━━━━━━ Memory Status ━━━━━━━━━━━━━━━━━━━━━━
 RAM Usage: 4.2GB / 16GB (26%)
 Swap Usage: 0.5GB / 4GB (12%)
                

Quick Installation

1

Install from Snap Store

sudo snap install debian-doctor
2

Grant Permissions

sudo snap connect debian-doctor:system-observe
sudo snap connect debian-doctor:hardware-observe
3

Run Diagnostic

debian-doctor

Compatibility

Ubuntu
Debian
Linux Mint
Pop!_OS