>
~$linuxier
Read the blog
~$ home /Troubleshooting

Troubleshooting

Every Linux user hits the same wall eventually: something that worked yesterday is broken today, and the screen isn't saying why. This track turns that panic into method. The system is almost always telling you what happened — in journalctl, in dmesg, in the output apt hands back when a package won't install. Learn to read those signals and most "mystery" failures stop being mysteries: a broken dependency, a missing kernel module, a mount that references a disk by the wrong name, a boot that stalls before you ever see a login. We cover how to find the one line that matters and turn it into a fix.

start here

Tools you'll reach for when things break.

Dedicated logging and recovery guides are being written. Until then, these two cover the identifiers and shell skills you'll lean on in almost every fix.

boot-repair.sh
$ lsblk -f # a wrong UUID in fstab drops you to a rescue shell
Boot & disks

How to Find the UUID in Linux [3 Methods]

Many "won't boot" and "device not ready" failures come down to an /etc/fstab pointing at a stale disk name. Reading the real UUID is step one of the fix.

read the guide →
diagnose.sh
$ journalctl -p err -b # every fix starts by reading
Foundations

How to Use the Command Line on Linux

Tailing logs, piping to grep, editing a config in an emergency shell — troubleshooting is command-line work. Build the terminal fluency the rest of this track assumes.

read the guide →
logs.sh
$ dmesg --level=err,warn | tail
Reading logs

Reading journalctl & dmesg

The kernel ring buffer and the systemd journal record what actually happened. Learn to filter them by priority, service and boot so the signal rises above the noise.

read the guide →
A note before you dig in: troubleshooting rewards patience over guesswork. Change one thing at a time, keep a note of what you touched, and read the error text in full before you act — the fix is usually hiding in plain sight, not behind a random command from a forum.
what you'll learn

Turn a broken box
back into a boring one.

01
Read the logs firstFilter journalctl -p err -b and dmesg by priority and boot to find the one line that explains the failure.
02
Fix broken packagesRecover from half-configured installs and dependency loops with apt --fix-broken install and dpkg — without nuking the system.
03
Chase missing modulesWhen a device or filesystem "isn't supported," find and load the right kernel module with lsmod, modprobe and dmesg.
04
Survive boot issuesUnderstand the emergency shell, fix a bad /etc/fstab, and get back to a login prompt when the machine stalls on startup.
the method

Debugging is reading, not guessing.

Two habits separate people who fix Linux quickly from people who reinstall — and both start with looking closely before touching anything.

Broken packages & dependencies

A failed upgrade can leave packages half-configured and apt refusing to do anything else. The fix is rarely dramatic: sudo apt --fix-broken install to resolve the chain, sudo dpkg --configure -a to finish interrupted setups, and reading the error to see which package actually broke first.

Missing modules & boot stalls

When hardware "isn't detected" or the boot hangs, the kernel usually logged why. Check dmesg for the failing driver, confirm the module with lsmod, and load it with sudo modprobe <name>. For boot stalls, an incorrect UUID in /etc/fstab is a classic cause — which is exactly why the disk-identifier guide above is here.

Tip: Add -b to journalctl to scope logs to the current boot, and -b -1 for the previous one. Comparing "last good boot" against "the boot that failed" is often the fastest way to spot what changed.

AltStyle によって変換されたページ (->オリジナル) /