Beginner’s Guide to Troubleshooting Linux and System Issues
1. Check Disk Space Issues
Problem: System is slow or refuses to write files.
Diagnosis:
Explanation:
-
df -h→ shows disk usage for all mounted partitions -
du -sh ~/*→ shows size of each folder in your home directory
Solution:
-
Delete unnecessary files:
rm -rf ~/Downloads/old_files/* -
Clean package cache:
2. Check Memory and Swap Issues
Problem: System freezes or programs crash.
Diagnosis:
Explanation:
-
free -h→ shows RAM and swap usage -
top→ shows top processes consuming memory
Solution:
-
Kill memory-hogging processes:
-
Add swap space if necessary:
3. Check CPU Usage Issues
Problem: System is extremely slow, fan running at full speed.
Diagnosis:
Explanation:
-
top→ shows processes using CPU -
Look for high
%CPUusage
Solution:
-
Kill or restart processes using excessive CPU
-
Investigate running services that may need optimization
4. Troubleshoot Network Issues
Problem: Cannot access the internet or server connection fails.
Diagnosis:
Explanation:
-
ping→ checks network connectivity -
ifconfig/ip addr→ shows network interfaces and IP addresses -
traceroute→ shows path packets take to reach destination
Solution:
-
Restart network service:
-
Check firewall rules:
5. Troubleshoot Package Installation Errors
Problem: Cannot install or update software.
Diagnosis:
Explanation:
-
Updates repository information and checks for package errors
Solution:
-
Fix broken packages:
-
Clear package cache and try again:
6. Check System Logs
Problem: Unknown errors or crashes.
Diagnosis:
Explanation:
-
dmesg→ kernel messages -
journalctl→ systemd logs -
/var/log/syslog→ general system logs
Solution:
-
Identify repeating errors
-
Google error messages for guidance
-
Adjust system configuration or services based on log info
7. General Troubleshooting Tips
-
Reboot – sometimes it solves transient issues.
-
Backup logs – always keep logs before making changes.
-
Search online – copy exact error messages; Linux forums are very helpful.
-
Test changes in a controlled environment before applying to production.
Summary
This tutorial provides a structured approach to troubleshooting:
-
Check disk space
-
Check memory and CPU
-
Check network
-
Check packages
-
Examine system logs
By following these steps, beginners can systematically diagnose and fix common Linux issues without panic.