On this page
Good troubleshooting begins with a precise observation. “Ubuntu is broken” is difficult to test. “The Wi-Fi control disappeared after Airplane Mode was enabled” gives you a safe first check.
Use the symptom that matches what you see. Stop after each check and test again.
An application will not open
What it may mean: the app is already open elsewhere, starting slowly, or failed during launch.
Safe first checks: select its Dock icon, inspect the Activities overview and workspaces, then wait briefly. Try launching it once from application search.
Avoid: selecting the icon repeatedly or deleting application settings before identifying an error.
Continue with Ubuntu Dock and Applications Explained or, if it is visibly frozen, System Monitor and Frozen Applications.
An application stops responding
Wait for a heavy file or save operation. Try normal close once. If the rest of the desktop works, use System Monitor and choose End Process before any forceful Kill action.
Unsaved work may be lost. Do not force power off the entire computer for one frozen application unless the desktop itself no longer offers a safer path.
Wi-Fi disappears
Check Wi-Fi, Airplane Mode, and any physical wireless key or switch. If another device also cannot see the network, the access point may be the problem.
Do not paste a driver command from an unrelated hardware guide. Use Connect Ubuntu to Wi-Fi and Bluetooth for the graphical checks first.
A Bluetooth device will not connect
Charge the device, turn Bluetooth on, place the device into pairing mode again, and disconnect it from another computer or phone that may claim it.
Pairing mode often expires. Its disappearance after a short time can be expected, not evidence that Ubuntu deleted the device.
A USB drive does not appear
Wait a moment, reopen Files, and inspect the sidebar. Try another known-working port without an unreliable hub. Confirm that the drive receives power where it has an indicator.
Do not format the drive merely because it is not mounted. Formatting erases the selected filesystem. Continue with USB Drives and External Storage, and seek storage-specific help if the data matters.
Sound comes from the wrong place
Open Sound settings. Check mute, volume, and the selected output. A monitor or previously connected headset may be selected instead of speakers.
For microphone trouble, choose the input and watch its level meter. Sound, Keyboard, Mouse, and Touchpad Settings keeps output and input checks separate.
The screen resolution or arrangement looks wrong
Open Displays and select the affected monitor. Check native resolution, scale, and the arrangement diagram.
If a new display choice makes the screen unusable, do not confirm it. Wait for the timed reversion described in Display, Scaling, and Multiple Monitor Settings.
Keyboard symbols are wrong
Inspect the active input source and keyboard layout. A consistent wrong punctuation symbol often means the selected layout does not match the printed keys.
Do not change the whole system language first. Test the correct layout with several symbols.
Files appear missing
Confirm the current folder in the path bar. Check Recent, Trash, hidden-file state, and any disconnected removable drive.
Search from the most likely folder, then broaden the scope. Do not create a replacement file with the same name until you know whether the original still exists.
Downloads looks empty
Check the browser’s download list for the saved filename and destination. Sort Downloads by newest, then search Home if the browser saved elsewhere.
A file that opened in the browser may not have been saved yet.
The computer feels slow
Look for a current update, file copy, browser download, or visibly busy application. Open System Monitor and observe sustained CPU, memory, disk, and network activity.
Restarting normally is reasonable after saving work when a temporary problem persists. It is not a diagnosis; record whether the symptom returns and what is active when it does.
An application disappeared from the Dock
Press Super and search for it. The application may still be installed but no longer pinned. Open it and choose Add to Favorites if you want the Dock shortcut back.
Removing a favorite does not uninstall software.
The laptop will not wake correctly
Wait, press a key, click the pointer device, then briefly press the power button once if that is the documented wake action for the machine. Avoid repeated long presses, which can force power off.
If the display or devices repeatedly fail after suspend, save work and stop relying on suspend until model-specific firmware and driver help is found. The Path 1 hardware test lesson explains how to record the behavior safely.
An update notification appears
Read which application produced it. Save work and use Ubuntu’s graphical update tool when convenient. Keep the charger connected for system updates.
Do not interrupt an update or install unrelated packages to dismiss the notice. The first-boot update section explains the current graphical and beginner terminal choices; a dedicated software-management path is planned.
Know when restarting is reasonable
Restart after saving work when:
- A temporary desktop or device state remains after the focused checks.
- An update explicitly requests it.
- Several unrelated applications are affected.
- The computer has been awake through a hardware or docking change that did not recover cleanly.
Do not restart during a visible firmware update, disk write, or package operation unless official recovery instructions say to.
Record evidence before asking for help
Useful desktop problem report
- Ubuntu version shown in Settings → About.
- Computer or device manufacturer and model.
- Exact visible symptom or message.
- The last action before it began.
- Whether the problem affects one app, one user, or the whole desktop.
- Which safe checks were tried and what changed.
- A reviewed screenshot when it adds useful evidence.
Redact account names, email addresses, Wi-Fi names when desired, serial numbers, recovery keys, passwords, and private files before sharing.
Practice
Knowledge check
Choose the safest first diagnostic step.
Pick three symptoms from this lesson. For each, name one safe check and one tempting but unrelated action you would avoid.
What to learn next
Continue to GUI vs Terminal: When Should a Linux Beginner Use Each? to understand where graphical troubleshooting ends and later command-line learning becomes useful.