linux-expert
Skill0 starsChanged 23 days agoMITView on GitHub
Use when a non-programmer needs general Linux system knowledge, command-line help, troubleshooting method or distro comparisons, on Bazzite or any other distro.
- Pipes a download into a shell
- Deletes or force-pushes
- Installs packages
In this repository69 other files it gives its agents.
- ableton-liveSkill
- ableton-push-expertSkill
- ardourSkill
- arduino-electronics-solderingSkill
- audacitySkill
- audio-driver-stacksSkill
- audio-interface-digital-ioSkill
- av-receiver-specialistSkill
- bazzite-kde-linuxSkill
- bitwig-studioSkill
- color-palette-expertSkill
- couch-pc-cec-gaming-modeSkill
- cubaseSkill
- daw-hubSkill
- denon-prime-sc5000-x1800Skill
- design-software-guideSkill
- dj-gig-guideSkill
- dj-specialistSkill
- drawing-tabletsSkill
- dsp-references-and-licencesSkill
- electronic-music-producerSkill
- fl-studioSkill
- fx-plugin-designSkill
- gha-supply-chain-hardeningSkill
- github-for-beginnersSkill
- github-repo-lockdownSkill
- grapheneosSkill
- graphic-design-expertSkill
- hard-dance-productionSkill
- hardstyle-sound-design-notesSkill
- hardware-protocol-captureSkill
- home-network-specialistSkill
- js-to-cpp-dsp-portSkill
- juce-audio-thread-handoffSkill
- juce-expertSkill
- juce-headless-test-snapshotSkill
- knulli-handhelds-m8Skill
- korg-logue-sdk-expertSkill
- linux-audio-productionSkill
- linux-security-hardeningSkill
- linux-terminal-expertSkill
- logic-proSkill
- loudness-and-lowend-deliverySkill
- man-page-expertSkill
- max-for-live-expertSkill
- mockup-is-the-pluginSkill
- mockup-to-juce-layoutSkill
- nextcloud-specialistSkill
- photo-editing-color-gradingSkill
- pihole-raspberry-piSkill
- plugin-dsp-qualitySkill
- plugin-fleet-auditSkill
- plugin-performance-profilingSkill
- plugin-security-fuzzingSkill
- plugin-ship-checklistSkill
- pro-toolsSkill
- reaperSkill
- rog-ally-x-bazziteSkill
- sound-engineer-acousticsSkill
- sound-forgeSkill
- The first 60 shown.
The file
Show its rules and text
We split this skill into the rules it gives an agent
25 rules. About 0 are common, 14 are distinctive, and 11 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈14
Distinctive · estimate
This author's own choices. Worth a look.
11
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 20
Prefer read-only commands first (list, status, show).
- Distinctive: line 21
Never ask for passwords, keys or real public IPs in chat.
- Distinctive: line 22
Before a risky step: say what could go wrong, and what to back up first.
- Distinctive: line 62
Every process has user and group IDs, plus supplementary groups used in permission checks.
- Very specific: line 64
Read permission output with ls -l: first character is the type, then three triplets for owner, group, others.
- Very specific: line 68
Check your IDs: id. List who owns a file: ls -l <file>.
- Very specific: line 72
Never sudo chmod -R 777 or sudo chown -R on system folders or your whole home.
- Distinctive: line 73
Never run a graphical app with sudo.
- Very specific: line 88
Do not edit files in /usr/lib/systemd/system.
- Very specific: line 132
Test an fstab edit before reboot: sudo mount -a (errors show now).
- Very specific: line 153
If IP ping works but the name does not: DNS problem.
- Distinctive: line 159
Never run two firewall front-ends at once.
- Very specific: line 172
Check: lspci -nnk | grep -A3 -i vga and glxinfo -B (needs mesa-utils).
- Distinctive: line 201
Look for words: "failed", "denied", "not found", "timeout", "no space".
- Distinctive: line 224
Start from a terminal; read first error.
- Very specific: line 236
Remove layering one package at a time, retry.
- Very specific: line 242
Never curl ... | bash or sudo sh a script you have not read.
- Distinctive: line 243
Test on a copy: Distrobox container, a spare disk, or a live USB.
- Very specific: line 244
Check a command before pressing Enter: rm -rf, dd, mkfs, chmod -R, chown -R, and anything with sudo and a wildcard.
- Very specific: line 245
Prefer read-only checks first (status, list, show, -n dry-run flags where they exist).
- Distinctive: line 246
Do not copy a Stack Overflow or forum fix for another distro without translating it (section 5 table).
- Distinctive: line 247
Keep one working path to a desktop: do not remove your only kernel, boot entry or user.
- Distinctive: line 248
Update regularly; reboot to apply on Atomic systems.
- Distinctive: line 251
Use this to answer "other distros I will meet" (all COMMUNITY unless marked.
- Distinctive: line 276
Not reading the first error line.
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Linux expert for a non-programmer (Bazzite first, other distros second)
Labels: VERIFIED (source) = read on a fetched page this session. COMMUNITY = widely repeated, not read on a fetched page. UNVERIFIED = not confirmed, test before trusting. Some fetches failed (Fedora Docs, Arch Wiki, Debian Wiki, Reddit were blocked; see Not verified). Say so when a question lands there.
Related skills (do not duplicate them):
bazzite-kde-linuxfor Bazzite install, images, Gaming Mode, updates, rollback, layering costs.linux-security-hardeningfor encryption, Secure Boot, firewall policy, backups.linux-audio-production,wine-proton-bottles,home-network-specialistfor their topics.
How to teach (assume the reader is not a programmer)
- Plain words first, then the exact command, then what good output looks like, then how to undo.
- One command at a time. Ask for the output before the next step.
- Say which machine a command runs on: host terminal, inside a container, or on another PC.
- Prefer read-only commands first (list, status, show). Change things only after diagnosis.
- Never ask for passwords, keys or real public IPs in chat. Use placeholders.
- Before a risky step: say what could go wrong, and what to back up first.
- Distro-specific advice needs the distro named first. Ask:
cat /etc/os-release. COMMUNITY.
1. How Linux is organised
- Linux itself is the kernel: it talks to hardware and runs programs. VERIFIED (kernel.org README: "a clone of the operating system Unix, written from scratch by Linus Torvalds"). The kernel docs README does not define "kernel" in its opening lines: UNVERIFIED wording, the split below is COMMUNITY.
- A distribution (distro) = kernel + system tools + package manager + default settings + a support policy. COMMUNITY.
- Desktop environment (DE) = the look and feel: KDE Plasma, GNOME, XFCE. It is a separate layer from the distro. COMMUNITY. Bazzite here uses KDE.
- Display server: Wayland or X11, chosen by the DE and distro. COMMUNITY.
- Sound server: PipeWire on modern distros. COMMUNITY (see
linux-audio-production). - Package formats (what an app is shipped as):
- RPM (
.rpm): Fedora, RHEL, openSUSE. COMMUNITY. - DEB (
.deb): Debian, Ubuntu, Mint. COMMUNITY. - Arch packages via pacman, plus the AUR (user-made build recipes, not vetted). COMMUNITY.
- Flatpak: sandboxed desktop apps. VERIFIED ("a system for building, distributing, and running sandboxed desktop applications on Linux", docs.flatpak.org).
- AppImage: one downloadable file you make executable and run. COMMUNITY.
- Nix and Homebrew: separate package systems that sit beside the distro's own. See section 5.
- RPM (
2. Filesystem layout (FHS) and immutable variants
Linux has one tree starting at /. There are no drive letters. VERIFIED (mount man page: attaches a filesystem "to the big file tree").
Directory purposes, VERIFIED from the hier(7) man page:
/etc: configuration files local to the machine./home: home directories for users./usr: shareable, read-only data./usr/binis the primary directory for programs./usr/localis for programs local to the site./var: files that change in size, such as spool and log files./var/logholds log files./opt: add-on packages with static files./srv: data served by this system./tmp: temporary files that may be deleted without notice./boot: static files for the boot loader./dev: device files./procand/sys: live info about processes and the kernel./run: information about the system since boot./mntand/media: mount points (temporary and removable media)./root: usually the root user's home./sbin: commands needed to boot, usually not run by normal users. Notes:- The hier page is a man page. The formal FHS 3.0 document (refspecs.linuxfoundation.org) was not fetched: the formal standard text is UNVERIFIED.
- Hidden files start with a dot (
~/.config,~/.local/share). App settings live there. COMMUNITY. - Immutable (Atomic) variants:
/usris replaced as a whole image and is read-only;/etcand/varstay writable; rpm-ostree keeps two bootable deployments by default. VERIFIED for the two-deployment default and offline, reboot-applied updates (rpm-ostree handbook). The read-only/usrand writable/etc//vardetail comes from thebazzite-kde-linuxskill (its source: docs.bazzite.gg). - On Fedora Atomic,
/homemay be a link to/var/home. COMMUNITY. - Consequence: instructions that say "edit a file under /usr" or "sudo dnf install" fail on Bazzite. Use the install order in section 5.
3. Users, groups, permissions, sudo
- Every process has user and group IDs, plus supplementary groups used in permission checks. VERIFIED (credentials(7)).
- Superuser is UID 0 (root). The credentials page does not say this: COMMUNITY.
- Read permission output with
ls -l: first character is the type, then three triplets for owner, group, others. COMMUNITY. - Numeric modes: read=4, write=2, execute=1, summed per digit for owner, group, others.
755= owner rwx, group and others r-x. VERIFIED (chmod(1)). - Symbolic modes:
u+xadds execute for the owner,go-wremoves write for group and others. VERIFIED (chmod(1)). - On a directory,
xmeans "search" (you can enter it). VERIFIED (chmod(1)). The sticky bit on a directory stops users removing files they do not own. VERIFIED (chmod(1)). - Check your IDs:
id. List who owns a file:ls -l <file>. COMMUNITY. - sudo runs one command as root. What a user may run is decided by the sudoers policy. VERIFIED (sudoers(5): "determines a user's sudo privileges"). Edit with
visudo, never a plain editor: COMMUNITY (the man page excerpt read did not state it). - Admin group name differs:
wheelon Fedora/RHEL,sudoon Debian/Ubuntu. COMMUNITY (the sudoers page does not mention it). Red Hat docs have chapters "Managing users and groups" and "Managing sudo access": VERIFIED titles only. - Rules:
- Never
sudo chmod -R 777orsudo chown -Ron system folders or your whole home. COMMUNITY. - Never run a graphical app with sudo; it can leave root-owned files in your home. COMMUNITY.
- Wrong-permission fix order: look first (
ls -l), change one file, test. COMMUNITY. - Files copied from NTFS or exFAT drives show wide-open permissions. That is normal, see section 6.
- Never
4. Processes and systemd
- systemd starts and supervises services. Its objects are units:
.service,.timer,.mount,.target,.socket. COMMUNITY for the list; unit files are VERIFIED (systemd.unit). - Check, then change:
systemctl status <unit>: runtime state plus recent journal lines. VERIFIED.systemctl list-units --failed: failed units. VERIFIED.systemctl is-active <unit>andis-enabled <unit>. VERIFIED.sudo systemctl start|stop|restart <unit>. VERIFIED.sudo systemctl enable --now <unit>: enable hooks the unit into boot, it does NOT start it;--nowalso starts it. VERIFIED ("Enabling and starting units is orthogonal").sudo systemctl mask <unit>: links to /dev/null so nothing can start it, even by hand. VERIFIED. Undo withunmask: COMMUNITY.sudo systemctl daemon-reloadafter editing unit files. VERIFIED.
- Unit file locations, highest priority first:
/etc/systemd/system(admin),/run/systemd/system,/usr/local/lib/systemd/system,/usr/lib/systemd/system(distro packages). VERIFIED (systemd.unit). - Do not edit files in
/usr/lib/systemd/system. Use a drop-in: a folder<unit>.service.d/with a.conffile; drop-ins merge after the main file, and/etcbeats/runbeats/usr/lib. VERIFIED. Easy way:sudo systemctl edit <unit>: COMMUNITY. - User services run as you, with no sudo. Add
--userto systemctl and journalctl. VERIFIED (--usertalks to the user's service manager). Unit files go in~/.config/systemd/user. VERIFIED.systemd-analyze --user unit-pathsshows the real list. VERIFIED. - User services stopping when you log out, and
loginctl enable-linger: UNVERIFIED (loginctl page not fetched, rate limit). - Timers (cron replacement): a
.timeractivates the same-named.serviceby default. VERIFIED (systemd.timer).OnCalendar=follows wall-clock time,OnBootSec=counts from boot. VERIFIED.Persistent=trueruns a missed calendar timer after the machine was off; default is false. VERIFIED. List them:systemctl list-timers, ordered by next run. VERIFIED. A timer does not start a second copy if the service is still running. VERIFIED. - Processes:
ps aux,top,htop(if installed),kill <pid>,kill -9 <pid>as last resort. COMMUNITY (ps page not fetched). Try the plainkillfirst. - Boot slow?
systemd-analyze blame. COMMUNITY (page not fetched).
5. Package managers by family
Pick the tool by distro, not by habit. Confirm with cat /etc/os-release.
| Family | Tool | Update | Install |
| Fedora/RHEL | dnf | sudo dnf upgrade | sudo dnf install x |
| Fedora Atomic / Bazzite | rpm-ostree | rpm-ostree upgrade or ujust update | layering, last resort |
| Debian/Ubuntu | apt | sudo apt update && sudo apt upgrade | sudo apt install x |
| Arch | pacman | sudo pacman -Syu | sudo pacman -S x |
| openSUSE | zypper | sudo zypper refresh, zypper up | sudo zypper in x |
- The dnf, apt and pacman commands in the table are COMMUNITY (their pages were blocked, see Not verified).
- zypper: VERIFIED (openSUSE SDB).
zypper refrefreshes metadata,zypper in,zypper rm(-ualso removes unneeded dependencies),zypper sesearches.zypper upupdates packages;zypper dupis a distribution upgrade that can also downgrade packages to match the repositories. Usedupon Tumbleweed or when switching release, not as a casual update. - Arch: never run
pacman -Syalone then install (partial upgrade). COMMUNITY (Arch Wiki blocked, unverified here). Always-Syu. - Debian/Ubuntu: do not mix repositories from other releases or random PPAs without need. COMMUNITY (Debian wiki blocked).
- rpm-ostree on Atomic systems, VERIFIED (rpm-ostree handbook):
- Layered packages persist across upgrades, rebases and deploys.
rpm-ostree statuslists deployments in bootloader order; the first is the default.rpm-ostree rollbackswaps the default deployment with the other one.- Upgrades keep at most two bootable deployments by default.
- Changes apply after reboot; operations are transactional and offline.
install -yAcan live-apply simple additions. - Bazzite costs of layering: see
bazzite-kde-linux.
- Flatpak: sandboxed apps with a shared runtime. VERIFIED. Typical commands:
flatpak install flathub <app>,flatpak run <app>,flatpak update,flatpak list. COMMUNITY (docs intro page showed no commands). Permissions review with Flatseal: seelinux-security-hardening. - AppImage: download only from the project's own site,
chmod +x file.AppImage, run. COMMUNITY. Gear Lever manages them on Bazzite (perbazzite-kde-linux). - Homebrew on Linux: installs to
/home/linuxbrew/.linuxbrew; needs a system compiler and build tools;brew doctortroubleshoots; 32-bit x86 unsupported. VERIFIED (docs.brew.sh). - Distrobox: runs another distro in a container; wraps podman, docker or lilipod. VERIFIED (distrobox.it). It shares your HOME, USB devices, graphics and audio, and "the container will have complete access to your home". VERIFIED. So it is not a security sandbox. Rootless podman is the recommended setup for security. VERIFIED. Commands:
distrobox create -n test,distrobox enter test,distrobox-export(inside the container, shows apps on the host). VERIFIED. Host examples listed include Fedora Atomic Desktops and SteamOS 3. VERIFIED. - Nix (own store at /nix/store, works beside any distro) and Toolbx (Fedora's container tool,
toolbox create/enter): COMMUNITY, pages not fetched. - Which to use on Bazzite: Bazaar/Flatpak, then Homebrew (CLI), then Distrobox, then AppImage, then layering. See
bazzite-kde-linuxfor the reasoning. - Rules: one package tool per job; never
sudo pip installorsudo npm -gto fix a missing tool (can break system tools, COMMUNITY); use a Distrobox container for dev tools instead.
6. Disks, mounts, filesystems
- See disks:
lsblk -f(name, filesystem type, label, UUID, free space, mount points). VERIFIED (lsblk(8)).blkidis the authoritative source for filesystem info. VERIFIED. Never guess a device: re-runlsblkright before any write. - Device names (
/dev/sda,/dev/nvme0n1) can change between boots. UseUUID=orLABEL=in fstab. VERIFIED (fstab(5) calls it the recommended method). /etc/fstabhas six fields: device, mount point, type, options, dump, fsck pass. VERIFIED (fstab(5)).- Options: use at least
defaults.nofail= no error if the device is missing. VERIFIED. For USB or secondary drives,nofailavoids a stuck boot. COMMUNITY. - fsck pass: root should be 1, others 2, 0 = never checked. VERIFIED.
- Mount manually:
mount; override fstab options with-o;-o romounts read-only;mount --bind a bshows one folder in two places. VERIFIED (mount(8)).
- Options: use at least
- Test an fstab edit before reboot:
sudo mount -a(errors show now). COMMUNITY. Keep a copy:sudo cp /etc/fstab /etc/fstab.bak. COMMUNITY. - On Atomic systems
/etc/fstabstill works and survives updates. COMMUNITY. Do not mount over/usr. - Filesystems:
- ext4: the long-standing Linux default. Red Hat has "Getting started with an ext4 file system". VERIFIED title. "Default" claim COMMUNITY.
- XFS: RHEL's default; Red Hat has chapters on creating, backing up, growing XFS. VERIFIED titles. XFS cannot be shrunk: COMMUNITY.
- btrfs: copy-on-write, snapshots, subvolumes, checksums on data and metadata, compression (ZLIB, LZO, ZSTD), software RAID 0/1/10. VERIFIED. RAID5/6 is "experimental, not production-ready". VERIFIED. Fedora Workstation and Bazzite default to btrfs: UNVERIFIED (Bazzite default root filesystem not fetched; check with
lsblk -f). - NTFS: kernel
ntfs3driver is read-write, up to NTFS 3.1; mount typentfs3;forcemounts a dirty volume and is "not recommended"; optionsuid=,gid=,umask=,discard. VERIFIED (kernel.org ntfs3 page). Windows Fast Startup/hibernation leaves NTFS dirty: COMMUNITY. Turn it off in Windows before sharing a drive. - exFAT: shared drive for Windows, macOS and Linux with no permissions and no journal. COMMUNITY. Fine for transfer, bad for Linux game libraries or system use.
- FAT32: 4 GB file limit. COMMUNITY.
- Game libraries on NTFS cause Proton problems. COMMUNITY. Prefer ext4 or btrfs for Steam libraries.
- Health:
sudo smartctl -H /dev/nvme0(quick verdict),sudo smartctl -a /dev/nvme0(full), from the smartmontools package. COMMUNITY (smartmontools site blocked this session). - fsck: checks and repairs a filesystem. Run it only on UNMOUNTED filesystems and never on the live root. COMMUNITY (fsck(8) fetch hit the rate limit). Use
fsck -n(read-only dry run): UNVERIFIED flag meaning. Red Hat has the chapter "Checking and repairing a file system": VERIFIED title only. - Free space:
df -h, what is big:du -h --max-depth=1 <path>. COMMUNITY. - Disk work rules: back up first; double check the device with
lsblk; neverddor format from memory; unplug unrelated drives before partitioning. COMMUNITY.
7. Networking basics
- Desktop distros use NetworkManager. Red Hat docs cover it (nmcli, DNS server order, per-domain DNS, DHCP settings, debugging). VERIFIED chapter titles only.
- Quick checks, in this order (COMMUNITY):
ip -br addr: do I have an address?ip route: is there a default gateway?ping -c 3 <router IP>, thenping -c 3 1.1.1.1, thenping -c 3 example.com.- If IP ping works but the name does not: DNS problem.
resolvectl statusshows DNS servers (when systemd-resolved is used, UNVERIFIED on Bazzite). nmcli device status,nmcli connection show,nmcli device wifi list.
- Reading the result: no address = link or DHCP; address but no gateway = DHCP or manual config; gateway ok but internet not = router or ISP; IP ok but names fail = DNS. COMMUNITY.
- Firewalls:
- firewalld (Fedora, Bazzite per
linux-security-hardening): "a dynamically managed firewall", D-Bus service, zones assign trust levels to networks and interfaces, runtime and permanent configuration are separate. VERIFIED (firewalld.org). Commands such asfirewall-cmd --stateand--get-default-zone: seelinux-security-hardening. Remember--permanentfor changes that must survive reboot: COMMUNITY. - ufw (Ubuntu, Debian): off until you enable it;
sudo ufw enable,sudo ufw status verbose,sudo ufw allow <port>/tcp; default is deny incoming, allow outgoing. VERIFIED (help.ubuntu.com). - Never run two firewall front-ends at once. COMMUNITY.
- firewalld (Fedora, Bazzite per
8. Hardware, drivers, modules, firmware
- Kernel drivers are often modules.
modprobe <name>loads one with its dependencies;modprobe -r <name>removes it; modules live under/lib/modules/$(uname -r). VERIFIED (modprobe(8)). The page says there is "usually no reason to remove modules". VERIFIED. - Blocking a module: config lives in
modprobe.d(see modprobe.d(5), not fetched); the boot-line formmodprobe.blacklist=<module>exists. VERIFIED for the existence of both references; file syntax UNVERIFIED. On Atomic systems prefer kernel arguments (section 9). - Loaded modules:
lsmod. Module info:modinfo <name>. COMMUNITY. - Hardware lists (COMMUNITY):
lspci -nnk(PCI devices, with "Kernel driver in use"),lsusb,lscpu,inxi -Fxzif installed. A device with no "driver in use" line has no driver bound. - Kernel messages:
dmesg. VERIFIED options:-wfollow,-Thuman timestamps (can be wrong after suspend),--level=err,warn,-Hhuman output. Needs root on some systems. COMMUNITY. - Same messages through journald:
journalctl -k(kernel only),journalctl -b -p err. VERIFIED. - GPU drivers:
- AMD and Intel use the in-kernel open drivers (Mesa for graphics). COMMUNITY.
- NVIDIA: Bazzite ships the driver in the image (
-nvidia,-nvidia-open). Details perbazzite-kde-linux. - On other distros the NVIDIA driver is a separate package or module; mismatch after a kernel update is a classic black screen. COMMUNITY.
- Check:
lspci -nnk | grep -A3 -i vgaandglxinfo -B(needs mesa-utils). COMMUNITY.
9. Boot: UEFI, bootloaders, initramfs, kernel arguments
Boot order (COMMUNITY summary): firmware (UEFI) reads the EFI System Partition, starts a boot loader, which loads the kernel and initramfs, which mounts the real root, which starts systemd.
- UEFI vs BIOS: modern PCs are UEFI. UEFI keeps boot programs on the EFI System Partition (ESP). COMMUNITY. systemd-boot supports UEFI only. VERIFIED.
- ESP is usually at
/efi,/bootor/boot/efi. VERIFIED (systemd-boot page). - GRUB: the common boot loader on Fedora and Bazzite. Menu at power-on shows the previous deployment on Atomic systems (per
bazzite-kde-linux). GRUB2 doc page was blocked: commands such asgrub2-mkconfigare COMMUNITY. Do not run it on Atomic systems without checking: UNVERIFIED. - systemd-boot: simple UEFI boot manager with a text menu and a built-in kernel command line editor; entries are files in
/loader/entries/on the ESP; unified kernel images are in/EFI/Linux/. VERIFIED. - Dual boot: install Windows first, then Linux; Windows updates can reset boot order. COMMUNITY.
- initrd/initramfs: a small temporary root loaded with the kernel. The kernel starts with minimal built-in drivers and more modules load from it, then the real root is mounted and
/sbin/initruns. VERIFIED (kernel.org initrd page, which uses the older term "initrd"). "Initramfs" as the modern name: COMMUNITY. Missing drivers or an encrypted root failing here gives a drop to an emergency shell. COMMUNITY. - Kernel arguments (command line): the kernel reads them from the boot loader; see them live with
cat /proc/cmdline. VERIFIED (/proc/cmdline). Module parameters can be set asmodule.param=value, for exampleusbcore.blinkenlights=1. Hyphens and underscores are interchangeable; values with spaces go in double quotes; length is limited. VERIFIED (kernel-parameters). nomodesetandquiet: the kernel page excerpt did not show them.nomodesetas a black-screen workaround: COMMUNITY. UNVERIFIED on current kernels.- One-time test: at the GRUB menu press
e, add the argument to the line starting withlinux, press Ctrl+X. Nothing is saved, a reboot undoes it. COMMUNITY. - Permanent change on Bazzite/Fedora Atomic:
rpm-ostree kargs --append=<arg>. COMMUNITY (the rpm-ostree handbook page read did not cover kargs). Check withrpm-ostree kargs. Reboot after. - Rollback and pinning: see
bazzite-kde-linux. Secure Boot and TPM: seelinux-security-hardening. - Rescue rules: keep a live USB (Bazzite or Fedora ISO) made before you need it; know your firmware key (F2, F12, Del) for boot menu. COMMUNITY.
10. Logs: reading them
- journald holds most logs.
journalctloptions, VERIFIED (journalctl(1)):-bthis boot;-b -1the boot before last (previous boot).-ppriority, single level or rangeFROM..TO(for example-p err; also-p warning..err).-u <unit>one unit (repeatable);--userand--user-unit=for user services.-ffollow live;-n <lines>last lines.--since=and--until=(short-S,-U) for a time window.-kkernel messages only.--disk-usage,--vacuum-size=,--vacuum-time=to see and trim log size.
- Previous boot logs only exist if the journal is persistent (
/var/log/journal). COMMUNITY. - Reading an error:
- Find the first error, not the last. Later errors are often consequences. COMMUNITY.
- Look for words: "failed", "denied", "not found", "timeout", "no space". COMMUNITY.
- "Permission denied" can be file permissions OR SELinux; check
sudo ausearch -m avc -ts recentorjournalctl -t setroubleshoot. COMMUNITY. Never turn SELinux off (seebazzite-kde-linux). - "No space left" can also mean out of inodes:
df -handdf -i. COMMUNITY. - Copy exact text into a search, with distro name and version.
- App logs: run the app from a terminal to see its output; for Flatpak,
flatpak run <app>. COMMUNITY. Flatpak and Steam also keep logs under~/.var/appand~/.steam: UNVERIFIED paths.
11. Troubleshooting method
Ask first (COMMUNITY):
- Distro, version, image name (
cat /etc/os-release,rpm-ostree statuson Atomic). - What changed just before: update, new hardware, new app, settings.
- Exact error text or what happens. Photo of the screen is fine.
- Does it happen every time? Which user? After reboot?
- Is there a known-good state (older deployment, other user, live USB)? Then follow this loop: reproduce, read-only checks, one change, test, undo if no help, note what you did.
Tree: it will not boot to desktop
- Does the firmware logo show? No: hardware or power; try another boot device.
- GRUB menu shows? No: ESP or boot order problem. Try the boot menu key.
- Menu shows, then black screen: try the previous deployment entry (Atomic). COMMUNITY. If that works, the update caused it; rollback per
bazzite-kde-linux. - Still black: one-time add a kernel argument (section 9), try integrated graphics, check GPU cable.
- Emergency shell:
journalctl -xb -p err, check disk space and fstab.
Tree: app will not start
- Start from a terminal; read first error.
- Flatpak:
flatpak update; check permissions (Flatseal); tryflatpak run --verbose(flag UNVERIFIED); reinstall; remove data in~/.var/app/<app>only after backup. - Native: missing library = wrong package source; try a Distrobox.
- Windows app: see
wine-proton-bottles.
Tree: no sound, no network, slow system
- Sound:
linux-audio-production. Network: section 7 steps in order. - Slow:
top(CPU/memory),df -h(disk full),systemctl list-units --failed,journalctl -b -p err,systemd-analyze blamefor boot time. COMMUNITY.
Tree: update failed on Atomic
df -h(need space; Bazzite wants 3 percent free perbazzite-kde-linux).rpm-ostree statusand look for layered packages that block.- Remove layering one package at a time, retry. See
bazzite-kde-linux.
When stuck: give the reader a short "what I know / what I tried / next" note to paste into a forum. Forums: Universal Blue and Bazzite Discord/forum for Bazzite; r/linux4noobs and r/linuxquestions are common places (could not be fetched, quality UNVERIFIED). Never run commands from a forum post that you cannot explain.
12. Safe-practice rules
- Back up before any disk, boot or system change: 3-2-1 backups per
linux-security-hardening. Test a restore. - Never
curl ... | bashorsudo sha script you have not read. Download, read, then run. COMMUNITY. Prefer Flatpak, Homebrew or distro packages over installer scripts. - Test on a copy: Distrobox container, a spare disk, or a live USB. Distrobox is not a sandbox, it sees your home. VERIFIED.
- Check a command before pressing Enter:
rm -rf,dd,mkfs,chmod -R,chown -R, and anything withsudoand a wildcard. COMMUNITY. - Prefer read-only checks first (
status,list,show,-ndry-run flags where they exist). - Do not copy a Stack Overflow or forum fix for another distro without translating it (section 5 table).
- Keep one working path to a desktop: do not remove your only kernel, boot entry or user.
- Update regularly; reboot to apply on Atomic systems. VERIFIED for reboot requirement (rpm-ostree handbook).
13. Distro families and which to pick
Use this to answer "other distros I will meet" (all COMMUNITY unless marked; I did not fetch the distro project pages):
- Fedora family: Fedora Workstation/KDE, Fedora Atomic (Silverblue, Kinoite), Bazzite, RHEL, Rocky, Alma. dnf/rpm. Fast release rhythm for Fedora.
- Debian family: Debian, Ubuntu, Linux Mint, Pop!_OS. apt/dpkg. Debian stable moves slowly and is very stable.
- Arch family: Arch, EndeavourOS, Manjaro, CachyOS, SteamOS 3. pacman and AUR. Rolling; needs attention. The
Distroboxpage lists SteamOS 3 as a supported host, VERIFIED. - openSUSE: Tumbleweed (rolling), Leap, Aeon/Kalpa (immutable). zypper. YaST tools. Aeon/Kalpa named on distrobox.it as immutable hosts. VERIFIED.
- Immutable ones named on distrobox.it: Fedora Atomic Desktops, Vanilla OS, Endless OS, ChromeOS, SteamOS 3, openSUSE Aeon/Kalpa. VERIFIED. Pick guide:
- PC with easy rollback and gaming: Bazzite (see
bazzite-kde-linux). - Server or NAS-like box: stable Debian/Ubuntu LTS or the appliance OS the project recommends (Unraid is its own product, see
unraid-specialist). COMMUNITY. - Support policy matters more than looks: how long updates last, who maintains it. COMMUNITY. Check the project's own page before recommending a distro: UNVERIFIED claims about release dates and support periods.
14. Common beginner mistakes
- Following a tutorial for another distro (
apton Bazzite). Check the family first. - Using
sudofor everything, including GUI apps. chmod -R 777to "fix" a permission error.- Piping an install script from the web into a shell without reading it.
- Layering packages on Atomic systems because it feels like
apt install. - Editing
/etc/fstabwithout a backup or without testingmount -a. - Using
/dev/sdXnames in fstab instead of UUID. VERIFIED as discouraged (fstab(5)). - Formatting or partitioning the wrong disk (check
lsblktwice). - Putting game libraries or system data on NTFS or exFAT.
- Leaving Windows Fast Startup on, then mounting its NTFS drive. COMMUNITY.
- Partial upgrades on Arch (
-Syalone) and mixing releases on Debian. - Disabling SELinux or the firewall to "make it work".
- Ignoring updates for months, then updating with a full disk.
- Not reading the first error line. Fixing a symptom, not the cause.
- Making several changes at once, so nothing can be undone cleanly.
- Skipping backups and a live USB until after something breaks.
- Assuming a container isolates you: Distrobox shares the home folder. VERIFIED.
Learning resources
- The Linux Command Line by William Shotts: free PDF download, 596 pages, aimed at new command line users, license BY-NC-ND. VERIFIED (linuxcommand.org). Chapter list not fetched.
- man pages: man7.org online,
man <cmd>locally;<cmd> --helpfor a short list. COMMUNITY. - Red Hat Enterprise Linux documentation (docs.redhat.com) is a deep, accurate source for systemd, storage and networking, even for Fedora. Title list VERIFIED, content mostly not read.
Not verified
- Blocked or failed fetches: docs.fedoraproject.org (dnf, Silverblue, Toolbx, nmcli, GRUB2: Anubis "Access Denied"), wiki.archlinux.org (pacman), wiki.debian.org (Apt, DontBreakDebian: challenge page), reddit.com, smartmontools.org, firewalld.org detail pages (only the overview read), refspecs.linuxfoundation.org (FHS 3.0), linuxfoundation.org, nixos.org manual, fsck(8), loginctl, systemd-analyze, cgroups, ps man pages (hourly fetch limit).
- Therefore UNVERIFIED or COMMUNITY: all dnf, apt, pacman commands; Toolbx; Nix details; GRUB commands;
rpm-ostree kargs;nomodeset; smartctl; fsck options;enable-linger;systemd-analyze blame;lspci,lsusb,lsmod,ip,ss,resolvectl,nmclicommand details; SELinux commands; distro family and pick guidance; filesystem defaults for Bazzite and Fedora; community forum quality.
Sources (fetched 2026-10-23)
- https://man7.org/linux/man-pages/man7/hier.7.html
- https://man7.org/linux/man-pages/man1/chmod.1.html
- https://man7.org/linux/man-pages/man7/credentials.7.html
- https://man7.org/linux/man-pages/man5/sudoers.5.html
- https://man7.org/linux/man-pages/man5/fstab.5.html
- https://man7.org/linux/man-pages/man8/mount.8.html
- https://man7.org/linux/man-pages/man8/lsblk.8.html
- https://man7.org/linux/man-pages/man8/modprobe.8.html
- https://man7.org/linux/man-pages/man1/dmesg.1.html
- https://www.freedesktop.org/software/systemd/man/latest/systemctl.html
- https://www.freedesktop.org/software/systemd/man/latest/journalctl.html
- https://www.freedesktop.org/software/systemd/man/latest/systemd.unit.html
- https://www.freedesktop.org/software/systemd/man/latest/systemd.timer.html
- https://www.freedesktop.org/software/systemd/man/latest/systemd-boot.html
- https://www.kernel.org/doc/html/latest/admin-guide/README.html
- https://www.kernel.org/doc/html/latest/admin-guide/kernel-parameters.html
- https://www.kernel.org/doc/html/latest/admin-guide/initrd.html
- https://www.kernel.org/doc/html/latest/filesystems/ntfs3.html
- https://btrfs.readthedocs.io/en/latest/Introduction.html
- https://coreos.github.io/rpm-ostree/administrator-handbook/
- https://docs.flatpak.org/en/latest/introduction.html
- https://distrobox.it/
- https://docs.brew.sh/Homebrew-on-Linux
- https://en.opensuse.org/SDB:Zypper_usage
- https://help.ubuntu.com/community/UFW
- https://firewalld.org/documentation/
- https://linuxcommand.org/tlcl.php
- https://docs.redhat.com/en/documentation/red_hat_enterprise_linux/9/html/configuring_basic_system_settings/index
- https://docs.redhat.com/en/documentation/red_hat_enterprise_linux/9/html/configuring_and_managing_networking/index
- https://docs.redhat.com/en/documentation/red_hat_enterprise_linux/9/html/managing_file_systems/index
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

