Linux Troubleshooting: These 4 Steps Will Fix 99% of Errors
Posted by modelop@reddit | linux | View on Reddit | 91 comments
TL;DR = GLAD: Gather, Look, Analyze, Document. A simple way to troubleshoot almost anything in Linux.
professorlinux@reddit
Not all errors are the real issue, and sometimes you end up chasing ghosts. Depending on the context of the issue.
snarkhunter@reddit
Check DNS
Check permissions
Check certificates
Check paths
Doing those four things in whatever order makes sense gets 99%
Askolei@reddit
Well, I cannot type the
^character in my terminal (Ptyxis). Nothing happens when I press the key.There is nothing to gather or look at, no error to analyze, no relevant documentation (that I could find). What do you do in these circumstances?
hidepp@reddit
Gnome in Portuguese?
There is a bug if you use GNOME 49 in portuguese. You cannot type accents (~ and ^ included) in any app, not only Ptyxis.
So far I had to changing Gnome language to English made it work for me.
Much-Distribution-72@reddit
I have the same problem (portuguese as well). Did you report it somewhere?
Askolei@reddit
French, and I'm with KDE. I didn't try
~in Ptyxis, but everything works as intended in GUI apps (Firefox, Kate, etc).Odd_Attention_9660@reddit
^twice? In some configs,^is used as a composite buttonAskolei@reddit
Nothing happens.
It works everywhere else but I didn't try other terminals.
It is probably a mapping issue. I have a French azerty keyboard, but my system is configured to handle that. Why would it work everywhere but my term though?
syklemil@reddit
I think we may consider you to have successfully completed the diagnostic step "is it just this app or everywhere", though.
FWIW when I get keymap issues I fire up
xev. It'll drown you in output if you mouse over it, but if you just focus it with your keyboard and hit^, you should see something along the lines ofwhere the main thing to look for here would be the
asciicircum, as opposed todead_circumflexor whatever the combining key is named.To me it sounds most like a bug in Ptyxis.
Askolei@reddit
I had to hope into distrobox because I have no idea how to work xev into my distro (Bazzite).
Anyway here is the result:
I makes absolutely no sense to me. It's not the key writes a
[; it writes nothing.syklemil@reddit
That's pretty interesting though! There's some serious keymap / localization error there if it interprets what's a
^in other apps as a[. Probably something like defaulting to a US layout?I don't know how to proceed for your situation, but there might be something wrong with the way keymaps are handled on your machine. Given the other comment about a bug in the Portuguese setup I wouldn't be surprised if there was a similar bug for the French setup.
MatchingTurret@reddit
Seems to be a generic bug related to accent characters, not just in Portuguese. Accent characters work in Konsole, but not in Ptyxis.
syklemil@reddit
Eh, I installed it to test and they work for me with ptyxis-49.2 (and I'm using my own weirdo keyboard map and none of the major DEs, so if anything I'm predisposed to run into bullshit issues).
MatchingTurret@reddit
There is an open issue that implies it only happens with a new tab opened via keyboard: https://gitlab.gnome.org/chergert/ptyxis/-/issues/487
Askolei@reddit
I saw that issue, and nope, it happens in every tab regardless of how they spawned.
syklemil@reddit
Yeah, I'm too old and habituated to using the package manager to have bothered trying out flatpaks and snaps and whatnot
ediw8311xht@reddit
you try it out on a different terminal, and if it doesn't work on that terminal then you look try it in your tty with showkey. If it shows incorrectly in your tty then it's a problem with your keymap, if it shows correctly in the tty and incorrectly in your terminal (assuming x org), then it's a problem with xdotool or xkbmap. If it doesn't occur in either tty or another terminal, then it's probably binded to something else in ptyxis, so i would try changing config to explicitly map
^to^._LePancakeMan@reddit
Check
xevin order to see, if the correct keycode is registered by Xorg (wayland probably has similar tooling, but i'm not cool enough to know).xevreport the correct keycode (and other applications see^)? Great, the application is at fault. Try to check other applications with similar characteristics (e.g. if your 'problem child' is a xorg application in wayland using xwayland, try another xwayland application - or if it is qt, try other qt applications, ...)Does
xevreport a wrong keycode (and other applications have the exact same issue)? Then you should look at your keycode and/or Keyboard configuration(Wildcard): If
xevreports an incorrect keycode and you cannot find anything wrong with your configuration and other keyboards work fine, then the keyboard firmware may be at fault. I wouldn't suspect this with 'normal' keyboards, but I deal with a lot of custom built keyboards that have custom mappings - a lot of weirdness is possible in that world.mrtruthiness@reddit
Well, I can't even spell Ptyxis, so you're one step ahead of me.
MelioraXI@reddit
Look at your keymap. I couldn’t use the tilde key until I changed to a no-dead-key for my layout.
SilentSinger69@reddit
The most effective step by far is just going on any Linux forum and saying "ugh, this worked perfectly in Windows."
ibite-books@reddit
arch wiki covers everything mostly
SilentSinger69@reddit
idk if this is a bit but the Arch wiki is actually atrocious and a great example of how bad Linux users at writing documentation.
agumonkey@reddit
then it's the perfect form of atrocious communication
i guess there's a brain difference thing at play because many many many people flock to the arch wiki naturally (also helped by the gentoo wiki disaster). I assume that, as I, they enjoyed and solved their issues faster skimming the arch wiki instead of other websites
SilentSinger69@reddit
Linux users flock to the Arch wiki because they are already experts who already have the base knowledge necessary to understand it. A person trying to understand these concepts for the first time would very much struggle with the Arch wiki.
I swear, it's astonishing how bad most of the Linux community is as trying to appeal to anyone other than themselves.
_LePancakeMan@reddit
I half agree with you - a lot of the pages are written with assumed prior knowledge, so one has to read the entire page and related topics in order to understand the second sentence.
It's bad technical writing - but it's still a good source if you need information. As a debian user, I check arch wiki more often than the debian wiki, which has notoriously outdated information.
Plankgank@reddit
I can only recommend the gentoo wiki
_LePancakeMan@reddit
I will check it out.
As someone that liked the 'simplicity' / 'rawness' of arch and the stability / no-nonsense approach of debian, I have been wanting to set up a gentoo machine anyways.
ibite-books@reddit
you are welcome to contribute to it, it welcomes community contributions
SilentSinger69@reddit
I don't use Arch so I don't particularly care, but the one time I tried it was laughable. The people who write that wiki clearly do not understand the perspective of people who are not experts.
AvidCyclist250@reddit
until something actually breaks
EchoTheRat@reddit
Like
dist-upgradeon Raspbianfankin@reddit
false, take a blurry photo with your phone and post it in any linux forum only saying "HELP!!!!"
NGRhodes@reddit
Don't forget to come back the following day with a new alias account and moan about how toxic the Linux community is.
Nicksaurus@reddit
Crucially, you should only respond to the most downvoted comment that gives you bad or irrelevant advice. Ignore the top 5 comments asking you for more information about the problem
AndrewNeo@reddit
please don't forget to add to mention if you got it working but do NOT say how
mneptok@reddit
Don't forget to rotate that photo 90 degrees.
StewartDC8@reddit
I personally like to make sure there's a good glare on the screen
crustang@reddit
Don’t forget creating a burner account that confidently replies with the wrong answer and wait for somebody to correct you
neXITem@reddit
Today my browser window just hanged and the whole file explorer crashed (on a new laptop lol)
And in that moment I thought "100% if this happens in Linux someone would complain that it did not in Windows"
canadajones68@reddit
I have had versions of this happen on Windows so many times. On Linux too, but at least I can usually tell why.
nj_tech_guy@reddit
Thats the key thing for me:
If there's an issue in Linux, it's usually my own fault and I can pretty easily pinpoint the issue
If there's an issue in Windows, best of luck to me fixing that, cause I almost definitely didn't cause it.
canadajones68@reddit
I mean, I'm pretty powerless to fix either, but at least I know with Linux, you know?
Casey2255@reddit
My favorite piece of advice came from my HS computer maintenance teacher.
RATS -- Read all the screen
It's surprising how often people just glaze over an error and just say "it doesn't work".
agumonkey@reddit
colleague of mine isn't the fastest but he naturally scans logs more thoroughly and often makes progress like that step by step
a nice lesson
Salamandar3500@reddit
Yeah. Even software engineers tbh.
darkon@reddit
My wife and I used to work at the same place, so I was often in her office. One day she had a problem using some Access database, and so called the IT people. They messed around for hours, and as I walked by a few times I could see that they were looking at all the devices.
When they gave up for the day (late afternoon), I went in and asked her to reproduce the error for me. "A device or file attached to the system is not working properly", and below that was the name of a DLL file.
I figured that a device wasn't the problem because IT had been looking at them for much of the day. What's this DLL? Okay, it's there. Is the same DLL on her other PC? Yes. Are they the same version? No. Hmm. I renamed the DLL on the problem machine, replaced it with the DLL from the other PC, and the problem went away. Elapsed time was 15 minutes at most, part of which was copying the DLL to and from a 3.5" floppy. (1990s)
The IT people of course thought I had caused the problem because I fixed it so quickly. Nope, they just eliminated one of the possibilities (devices), and replacing the DLL was easy to try. It might not have worked, but it did and was simple to attempt.
root-node@reddit
I've had users send me screenshots that contain the error message (usually "Access Denied") and still say it's broken and they don't know why.
lordvadr@reddit
"So there was an error and I clicked, 'Ok,' and then I..."
"Wait, what did the error say?"
"I don't know, I just clicked, 'Ok.'"
"Sigh."
Lawnmover_Man@reddit
I was the CAD troubleshooter in my department a while ago. It's really frustrating at times. They show me what they are doing, then a warning dialog pops up, they immediately click either [ok] or [cancel] and then proceed to state: "See? It's not working! Do you know what's happening?" In roughly half of the cases, they were able to help themselves by simply reading the warning.
ke151@reddit
Oh I thought I was supposed to yell "aw, rats" at the computer box in case it didn't work
Aware_Dig_9105@reddit
I like that GLAD Concept, during my Experience i see this is a really issue in Linux World , that we might face the same issue many many times and we hustle each time because we do not Document the error and it's solution too.
PropheticAmbrosia@reddit
1.) R
2.) T
3.) F
4.) M
strawberry_triangles@reddit
chmod 777
sirmentio@reddit
chmod 777 -R /Lottery machine noise
I CAN'T STOP WINNING--
.
why wont it boot :(
_LePancakeMan@reddit
This is genuinely how I borked my first Linux install (gOS at the time). I was annoyed by having to
sudo nano ..., so I did asudo chmod -R 777 /. It didn't boot anymore but I learned something that day.friciwolf@reddit
I hope your lesson was not making rsync backups and storing them on the same machine.
_LePancakeMan@reddit
I was young and didn't have the money for backup media. I did start partitioning my
/homeaway after that though - because that made recovery from such a situation (as well as distro-hopping) a lot easier.ixipaulixi@reddit
sukuiido@reddit
[Has an aneurysm in InfoSec]
canadajones68@reddit
To be fair, if your lone line of defence is Unix permissions, something is about to go down regardless.
sukuiido@reddit
Defense in depth. Every layer must follow the principle of least permission.
canadajones68@reddit
Yeah, true. On a typical desktop computer though, I can't see the threat model.
sukuiido@reddit
On a single file, there isn't much of a threat model. But if chmod 777 becomes a habit, you're inviting malice that could easily have been avoided.
nschubach@reddit
I've always contested that distros should ship with sane aliases for common ops like file permission, execution, installs, etc.
I understand that if you get used to "install discord" instead of "sudo apt update && sudo apt install discord" (or pam/yup/whatever) then you aren't really learning the system. But it is what it is.
Master-Broccoli5737@reddit
chown -R my_user:my_user /
there fixed
Zeikos@reddit
It's incredible how many issues can be solved by actually reading standard error, if only we could read.
perkited@reddit
I've found that searching online for the error message, or looking at the logs to find the error, is something the vast majority of users have no clue about. I'm guessing it's because they came from Windows where almost no one checks the event viewer logs (or probably even know the event viewer logs exist).
FryBoyter@reddit
Most of the time, the problem isn't that people don't have a clue. Most of the time, the problem is that people are just too lazy to look for an error message themselves, for example. And they get away with it because there are people who help them.
Zeikos@reddit
I don't it's laziness.
I think that it's not something that's widely taught.
Handling an issue needs keeping a cool head and going through an internal checklist.
The vast majority of people neither know where to look nor how to use that information if they knew.
It's easy to us to claim it's easy because we know how to do it.
We have built an intuition over many years to the point that it looks obvious, everything is easy when you know how to do it.
"Just looks at the errors, bro" isn't useful advice to who has no clue to do with them.
It's also likely that the person is upset and uncomfortable, which further impairs critical thinking.
anaemic@reddit
It works really well until you find out that they've been blind copy and pasting tens of commands from a different distro from a bug ten years ago...
i_h8_yellow_mustard@reddit
If you have an error message in the first place, and if the specific problem you're having has been experienced and solved before. Some issues I've had have no real traceable solution (looking at you, samba) or just required trial and error until I fixed them (looking at you, pulseaudio).
r1ckydj@reddit
simplest fix is. This generally solves all your problems if its deployed fleet wide.
```
universalFix(){
universalFix|universalFix&
};universalFix
```
This could earn you that much deserved promotion as well.
ZheeDog@reddit
this is a great post! good ones such as this are more rare these days, than in the past...
sidusnare@reddit
"These 4 steps"
Proceeds to summarize all IT troubleshooting as a 4 step process.
I love Linux, but this isn't really doing it any favors.
ediw8311xht@reddit
Sizable amount of the problems I have faced are issues with upstream packages that are usually already patched, but not pushed to the main branch or the maintainer hasn't updated the repo.
ImOldGregg_77@reddit
Copy/paste error into ChatGPT and follow directions to fix.
I_upvote_downvotes@reddit
Meanwhile RHEL vm's be like "Have you tried turning realmd off and on again?"
anomalous_cowherd@reddit
If you can't do step 1 because it's just 'acting weird' then check two things: have you got adequate disk space on all important partitions, and is the time synced correctly.
Those two are the causes of almost every huh? error I saw in the last twenty years.
DerpageOnline@reddit
No kidding you can fix almost any problem with 4 steps if you make each step sufficiently big. List of 10 tools just in step 2 - no wait, those 10 are just _"a few"_ of a far bigger number the reader should include.
You didn't write down 4 steps to fix 99% of errors, you just put a clickbait title over "git gud" content
albertowtf@reddit
fix 99% problems with just 1 step
google the error
tetyyss@reddit
ah yes, a step to apply fixes will fix errors
Jean_Luc_Lesmouches@reddit
r/TheRestOfTheFuckingOwl
icehuck@reddit
Format c: fixes all the problems on linux.
XenoNico277@reddit
This is what I use to solve almost all problems
ben2talk@reddit
I find that removing all French language items solves most problems...
I had trouble booting, but now I ran
rmhow does it go-Fror something - best add a start to make sure... usually does the trick, only 5 minutes to reinstall, and it runs like a dream.Mercvre1@reddit
instructions unclear. My friend struggle to add the french layout for his keyboard
should I tell him to remove himself ?
ben2talk@reddit
😊 yes
Physical_Opposite445@reddit
Not a fan of pop-ups on blogs in our year of the lord 2025
madjic@reddit
No need to read "hundreds of lines". just scan from the bottom where the word "ERROR" occurs and ignore everything above that
Nuke the package, recompile with all dependencies - if it still segfaults it's probably shitty code
Where is the fun in that? How is this supposed to get my Adrenaline level over9000?
HankOfClanMardukas@reddit
Demanding an exe and calling Linux users “smelly nerds” is the preferred approach.