Linux Troubleshooting Hub

Start Here: Quick Linux Checks

  • Restart your computer
  • Check your internet connection
  • Close unused apps and browser tabs
  • Ensure your system is up to date
  • Check available disk space
  • Disconnect and reconnect external devices

Wi‑Fi & Network Problems

  • Toggle Wi‑Fi off and on
  • Restart your router
  • Forget the network and reconnect
  • Check for system updates
  • Disable VPNs or proxies
  • Restart the Network Manager service (varies by distro)

Software Installation Issues

  • Update your package lists
  • Check your internet connection
  • Ensure you’re using the correct package manager for your distro
  • Remove partial or broken installs
  • Try installing from official repositories first

Update & Upgrade Problems

  • Check your storage space
  • Update package lists before upgrading
  • Restart the computer after major updates
  • Remove old or unused packages
  • Check for held or locked packages

Performance & Slow System Fixes

  • Close unused apps
  • Disable startup applications
  • Check system resources with your system monitor
  • Remove heavy browser extensions
  • Update graphics drivers
  • Free up disk space

Display, Graphics & Driver Issues

  • Restart the computer
  • Check for system updates
  • Try a different display cable or port
  • Update graphics drivers (NVIDIA, AMD, Intel)
  • Reset display settings

File System & Permissions Problems

  • Ensure you have permission to access the file or folder
  • Check if the drive is mounted
  • Restart the computer
  • Try opening the file with a different app
  • Check for read‑only drives or partitions

Keyboard, Mouse & Touchpad Issues

  • Restart the computer
  • Disconnect and reconnect the device
  • Try a different USB port
  • Check keyboard and mouse settings
  • Update system drivers

Beginner‑Safe Terminal Commands

  • Update package lists: sudo apt update
  • Upgrade installed packages: sudo apt upgrade
  • Check disk space: df -h
  • Check memory usage: free -h

(Commands may vary depending on your Linux distribution.)

Distro‑Specific Notes

  • Ubuntu / Linux Mint: Uses APT package manager
  • Fedora: Uses DNF package manager
  • Debian: Uses APT package manager
  • Arch / Manjaro: Uses Pacman package manager

Hardware Problems?

If your issue seems physical (screen, keyboard, battery, charging, USB ports, overheating), go to the Hardware Troubleshooting Hub:

Hardware Troubleshooting Hub