Common Issues: Windows-to-Linux Transition FAQ
Symptom → Cause → Fix patterns for the most common issues encountered when switching from Windows to Linux.
What This Guide Covers
An aggregated FAQ of the most common issues encountered during a Windows-to-Linux transition. Each entry follows a Symptom —> Cause —> Fix pattern so you can quickly diagnose and resolve problems without searching multiple forums.
System & Desktop
| # | Symptom | Cause | Fix |
|---|---|---|---|
| 1 | Missing user directories (Music, Pictures, etc.) | Can happen for any reasons or mishandling things | mkdir -p ~/Desktop ~/Downloads ~/Templates ~/Public ~/Documents ~/Music ~/Pictures ~/Videos && xdg-user-dirs-update --force |
| 2 | Theme still shows in Settings after “uninstalling” | You deleted the source folder, not the installed files | Remove the theme from ~/.local/share/icons/ or /usr/share/icons/ (same applies to ~/.local/share/themes/ for GTK themes) |
| 3 | App doesn’t appear in the app menu after install | Desktop database not updated | update-desktop-database ~/.local/share/applications |
| 4 | Icon cache stale after changing icon theme | Icon cache needs to be rebuilt | gtk-update-icon-cache ~/.local/share/icons/ThemeName or log out and back in |
| 5 | Seahorse/GNOME Keyring timeout in search | gnome-shell D-Bus timeout with keyring | Harmless warning — can be safely ignored |
| 6 | ”Buggy client sent _NET_ACTIVE_WINDOW message with timestamp 0” | An app tried to raise itself without a proper X11 timestamp | Harmless warning — can be safely ignored |
Package Management
| # | Symptom | Cause | Fix |
|---|---|---|---|
| 7 | sudo apt update shows “duplicate sources” | Both a .list and .sources file exist for the same repo | Remove the older .list file, e.g.: sudo rm /etc/apt/sources.list.d/google-chrome.list |
| 8 | ”Skipping acquire of configured file…doesn’t support architecture ‘i386‘“ | A 64-bit-only repo is configured without an architecture restriction | Add [arch=amd64] to the repo entry in /etc/apt/sources.list.d/ |
| 9 | GPG key error: NO_PUBKEY | Repository signing key not imported | Import with: curl -fsSL <key-url> | sudo gpg --dearmor -o /usr/share/keyrings/<name>.gpg |
| 10 | apt remove wants to remove too many packages | Removing a package from a meta-package triggers a dependency cascade | Use sudo apt remove --no-autoremove package and then sudo apt-mark manual important-package to protect dependencies you want to keep |
| 11 | ”Unable to locate package” | Package name is wrong or the repo hasn’t been added | Run apt search keyword to find the correct name, or add the required PPA/repo first |
See also: package-management-basics.md for a full primer on
apt, PPAs, and.debinstalls.
Hardware
| # | Symptom | Cause | Fix |
|---|---|---|---|
| 12 | Fan running too loud at low temperatures | BIOS fan curve is too aggressive for Linux | Install thinkfan with PWM config — see fan-and-power-management.md |
| 13 | Laptop not sleeping properly (or wakes immediately) | IBus keyboard daemon loses state on suspend | Add a systemd sleep hook — see openbangla-keyboard.md |
Display & Graphics
| # | Symptom | Cause | Fix |
|---|---|---|---|
| 14 | wmctrl / xdotool / xclip don’t work | You are running Wayland, but these tools require X11 | Switch to an X11/Xorg session at the login screen. Look for a session option containing “Xorg” (e.g. “Ubuntu on Xorg”). |
| 15 | Stata window doesn’t resize properly | GTK rendering bug on Wayland | Force the X11 backend: GDK_BACKEND=x11 stata-mp |
| 16 | Screen tearing during scrolling or video playback | X11 compositor not syncing frames | Enable VSync in display settings, or switch to Wayland |
See also: display-server.md for a detailed comparison of X11 vs. Wayland and how to switch between them.
Software
| # | Symptom | Cause | Fix |
|---|---|---|---|
| 17 | Dropbox linking URL expires immediately | Running dropbox.py status generates a new nonce, which invalidates the previous URL | Visit the linking URL immediately after it appears — do not run dropbox.py status again before clicking it |
| 18 | RcloneBrowser AppImage doesn’t work / download 404 | The upstream AppImage download link was broken | Build from source: git clone the repo, then cmake + make |
| 19 | Spicetify install fails | Spotify must be installed before Spicetify can patch it | Install Spotify first (via apt, Snap, or Flatpak), then install Spicetify |
See also: browser-setup.md for browser installation and extension configuration.
Files & Paths
| # | Symptom | Cause | Fix |
|---|---|---|---|
| 21 | ”No such file or directory” but you can see the file | Linux is case-sensitive (README.md and readme.md are different files) | Check exact casing with ls |
| 22 | Can’t find config files | Hidden files and directories start with . (dot) | Use ls -a in the terminal, or press Ctrl+H in the file manager to toggle hidden files |
| 23 | ”Permission denied” on a script | File is not marked as executable | chmod +x script.sh |
| 24 | Unknown folder in home directory (javasharedresources, auto-cpufreq, RcloneBrowser) | Leftover build or source directories from git clone installs | Safe to delete after verifying the app is installed elsewhere: which appname |
When to Ask for Help
If you’ve tried the fixes above and are still stuck, these communities are active and beginner-friendly:
| Resource | URL | Best For |
|---|---|---|
| Ubuntu Forums | ubuntuforums.org | General Ubuntu-based troubleshooting |
| Ask Ubuntu | askubuntu.com | Specific technical questions (Stack Exchange format) |
| r/linuxquestions | reddit.com/r/linuxquestions | Informal help, broad Linux topics |
| Distro Forums | Search [your distro] forum | Distro-specific issues and customization |
Tips for getting good answers:
- Include your OS version (
lsb_release -a), kernel (uname -r), and hardware (lspci | head -20). - Paste the exact error message, not a paraphrase.
- Mention what you’ve already tried.
- Use code blocks when sharing terminal output.
Cross-References
- display-server.md — X11 vs. Wayland, switching display servers
- fan-and-power-management.md — Hardware-specific fan control and power tuning
- browser-setup.md — Browser installation and extensions
- package-management-basics.md — APT, PPAs, Snap, Flatpak fundamentals
Discussion