A personal and professional collection of documented solutions for diagnosing and resolving Linux problems.
This repository documents real-world Linux troubleshooting cases, including their symptoms, diagnosis, cause, solution, and verification.
The goal is to build a practical and searchable knowledge base that can be useful both as personal technical documentation and as a reference for others facing similar problems.
| Category | Description |
|---|---|
| Keyboard | Keyboard layouts, special characters, input problems |
| Display | Display servers, graphics, monitors and related issues |
| Desktop Environments | KDE, GNOME, XFCE and desktop-related problems |
| Networking | DNS, Wi-Fi, NetworkManager and connectivity |
| Packages | APT, repositories and package installation problems |
| Permissions | Users, groups, permissions and ownership |
| Storage | Disks, partitions, filesystems and storage |
| System | Services, configuration and environment |
| Virtualization | QEMU/KVM, VirtualBox and virtual machines |
| Applications | Application-specific Linux problems |
- Clipboard not working between Parrot OS and host on Wayland
- Rsync error 10 / insufficient disk space during Parrot Security installation
- VM boots to a black screen or returns to the installer
This repository is not limited to a single Linux distribution.
Solutions may apply to distributions such as:
- Parrot OS
- Debian
- Ubuntu
- Linux Mint
- Kali Linux
- Other Debian-based and Linux distributions
Each troubleshooting guide documents the specific environment in which the solution was tested.
Each guide aims to document:
- Problem
- Symptoms
- Environment
- Diagnosis
- Cause
- Solution
- Verification
- Notes
This structure helps preserve not only the fix, but also the reasoning used to identify the problem.
Contributions and corrections are welcome.
See CONTRIBUTING.md for guidelines.
See LICENSE for information about using and redistributing this documentation.