r/cachyos • • Oct 14 '26 Bravo Mindblown

Announcement Announcement: Framework Is Tripling Its Support for CachyOS

1.9k Upvotes

Hey CachyOS Community,

We have more great news to share. Framework is increasing its support for CachyOS. The donation goes from $250 per month to $10,200 per year ($850 per month), more then three times the original amount.

When Framework first started sponsoring us, they sent us a Framework Laptop 16 for optimizing our kernel and packages, and committed to a monthly donation. You can read the original announcement here:

https://discuss.cachyos.org/t/framework-sponsorship-for-cachyos/19376

Having Framework triple its support says a lot about how much they care about Linux on their hardware and about the open-source projects their users rely on. For a community-driven project like ours, this kind of steady funding makes a real difference. It helps us:

  • Keep our build servers, mirrors and infrastructure running reliably

  • Spend more time on kernel optimizations, packaging and hardware support

  • Move closer to our long-term goal of working on CachyOS full-time

A big thank you to Framework for believing in CachyOS, and to every one of you who uses, tests, reports bugs, and donates. You keep this project going.

If you’d like to support CachyOS too, take a look at our donation page: https://wiki.cachyos.org/support/donation/

Thanks to Framework, and thanks to all of you for using CachyOS!

— The CachyOS Team


r/cachyos • • Sep 16 '26 Bravo Mindblown

CachyOS Troubleshooting First Steps

174 Upvotes

CachyOS is a rolling release. Updates arrive continuously instead of in one big yearly jump, which is why you get new kernels, drivers and gaming improvements so fast. It also means that occasionally something breaks. Most of the time the cause is boring and the fix is one of the same handful of steps.

This might seem like a lot and could feel daunting. Help is available, but it requires some information.

In order for folks to help you out, you need to supply some information. Here is a step-by-step plan. Work through it in order.

How to ask so that people actually help

When you post, include:

  • The four answers from Step 1

  • The paste.cachyos.org link from Step 3

  • What you've already tried, honestly, including any case of working with AI without understanding what you were asking, or what the AI was saying

  • The Step 7 result if you got that far

Rule zero: stop running commands you don't understand

Many badly broken installs weren't broken by an update. They were broken by three or four half-applied "fixes" from Google, an old forum post, and working with AI without understanding what was being asked or what the AI was saying, stacked on top of each other. Each one silently changed something. By the time help is requested, nobody can tell which change caused which symptom, and the actual problem is buried under the attempted repairs.

So: from the moment something goes wrong, stop applying fixes found somewhere else. Work through the steps below instead.

If a pile of commands has already been pasted into a terminal, that's fine, it happens. Just mention it when asking for help and try to recall what was run. That's far more useful than pretending the system is untouched.

Step 1: Describe the problem properly

Before touching anything, write down four things:

  • What exactly goes wrong? Be specific. "The screen goes black when launching Steam and the power button has to be held" is useful. "Gaming is broken" is not.

  • When did it start? A date or "after last Tuesday's update" is enough.

  • What happened right before it started? Was it an update, a new game, a driver change, a setting toggled, or a fix applied?

  • Does it happen every time, or only sometimes?

That last question is more important than people expect. Something that fails every single time is usually a configuration or driver problem. Something that fails randomly is more often heat, power, memory, or a background process interfering.

Step 2: Terminal survival basics

A terminal is needed for some of this. It's not scary, but may look like it is.

Open one with Ctrl + Alt + T. If that does nothing, open the start menu and search for terminal. When it asks for a password, nothing appears while typing. That's deliberate. Type it and press Enter. Copy text out of the terminal with Ctrl + Shift + C, paste in with Ctrl + Shift + V. The normal Ctrl+C means "stop the running program" here. sudo at the start of a command just means "run this with administrator rights".

Step 3: Generate a log bundle

CachyOS ships a single command that collects everything a helper needs, run from the terminal (see Step 2):

sudo cachyos-bugreport.sh

It gathers hardware details, kernel messages and recent system logs, then asks whether to upload the result. Type Y. A link to paste.cachyos.org comes back. That link is the single most useful thing to include when asking for help. Post it.

For anything the bug report doesn't cover, CachyOS also has a plain "send this to a pastebin" tool. Both of these work (run in the terminal, see Step 2):

  • paste-cachyos ~/some-file.txt

  • journalctl -b -1 -p err | paste-cachyos

The second one shows errors from the previous boot, which is what's wanted after a freeze or a crash that forced a reboot.

Two things:

  • Generate the log bundle before trying Step 6, because rolling back a snapshot also rolls back the logs.

  • The report includes hostname, hardware IDs and full log lines, and the paste is reachable by anyone with the URL. Fine for troubleshooting, but don't paste anything sensitive.

Step 4: Update fully, then actually reboot

Open Shelly, the package manager that ships with current CachyOS, let it check for updates and install them. Older installs may have Octopi instead, which is equally fine. Or do it in the terminal (see Step 2):

sudo pacman -Syu

Then RESTART the computer. No logging out, not closing the lid but an actual restart.

A genuinely large share of "my system is broken" reports are exactly this and nothing more. On a rolling release the kernel currently running and the drivers that were just installed can fall out of step. Everything looks updated, but the running system is still working with yesterday's parts. Typical symptoms: no graphics acceleration, Steam refusing to launch, external monitors not detected, unexplained crashes, etc. A reboot resolves this class of problem. It's a common misconception that Linux never needs a restart — that's not true. The OS cannot process kernel upgrades without a restart.

There's a second reason this step comes early. If some packages were updated and others weren't, the system is probably in what's called a partial upgrade state, and arbitrary unrelated things start failing. -Syu brings everything back in line. This is also why a single package should never be installed with pacman -Sy something. Always update the whole system.

Step 5: When one specific program won't start

If the problem is a single application rather than the whole system, run it from a terminal (see Step 2) to see why it fails. Type its name and press Enter:

steam

or firefox, or whatever it is. Let it fail, then press Ctrl + C. Copy everything the terminal printed and share it, or pipe it to the pastebin tool (see Steps 2 and 3).

For Steam games specifically: right-click the game, Properties, and put PROTON_LOG=1 %command% in the launch options. Run the game, let it fail, and a steam-<numbers>.log file will appear in the home folder.

Step 6: Roll the system back to before it broke

This is the feature most new CachyOS users don't realise they have.

If the system is installed on Btrfs, which is the default, CachyOS automatically takes a snapshot before and after every package install, update or removal. So when an update breaks something, there is almost always a restore point from a few minutes beforehand.

If the desktop still starts: open the start menu, search for Btrfs Assistant and open it. Go to the Snapper tab. A list of snapshots with dates will appear. Pick the most recent one from before the problem appeared, click Restore, and reboot. This GUI method works regardless of which bootloader is used.

If the desktop won't start at all: restart and tap Esc (or hold Shift) right after the machine powers on to bring up the boot menu. Look for an entry about snapshots, open it, and pick one dated before the problem. Unlike the GUI method above, this one depends on the bootloader: it works on Limine (which is a bootloader), which has been the installer default since the January 2026 release, and on recent GRUB setups. If systemd-boot was kept from an earlier install, there's no snapshot entry in the menu and a live USB will be needed, so ask for help rather than improvising.

Things worth understanding before doing this:

It only rewinds the system. Documents, photos and game saves live in the home folder and are not touched. That's reassuring, but it also means a rollback will not bring back a deleted file, and won't undo a broken configuration inside the home folder. Don't immediately re-run the update afterwards, or whatever broke it will be reinstalled. Ask first. If there's no Btrfs Assistant and no snapshot entry in the boot menu, the system is probably not on Btrfs and this section doesn't apply.

Step 7: Try the other kernel

If the boot menu lists an LTS kernel entry, boot it and see whether the problem goes away. Recent CachyOS installs ship both a current and an LTS kernel for exactly this reason.

This takes two minutes and reveals a lot. If the problem disappears on LTS, it points to a kernel or driver regression. If it's identical on both, the kernel may not be the culprit and attention moves elsewhere. Either answer narrows things down enormously, so mention the result when asking for help.

Step 8: When updates themselves fail

If the update in Step 4 refuses to run and throws an error, open CachyOS Hello, the welcome window, and look at its Troubleshooting section. It has buttons for the common package system problems: keyring trouble, a stale lock file, a corrupted cache. Try those before running anything found online. These specific failures attract a lot of bad advice that makes things considerably worse.


r/cachyos • • 4h ago

Desktop Day 5 in CachyOS, how's the desktop coming together? :)

32 Upvotes

Using Caelestia shell


r/cachyos • • 2h ago

Desktop Moved a friend

Post image
19 Upvotes

I convinced my gaming buddy to ditch windows last week, I completely forgot to upload this post. So far he’s customised his desktop and got his second monitor installed today. He’s had no issues at current and has already said he won’t be going back to windows. I need to convince my other 2 gaming bros to switch but they are reluctant to move even seeing that 2/4 have already moved over.


r/cachyos • • 15h ago

Review One year no re-install

Post image
171 Upvotes

I have been using Cachy for about two years. Finally have a machine I haven't re-installed on in that time.


r/cachyos • • 5h ago

Question Real talk: Is there actually a way to get a massive performance boost (20%+) on CachyOS, or are minor tweaks just placebo?

23 Upvotes

Hey everyone,

I’m running CachyOS on a laptop setup (Lenovo LOQ, Ryzen 7 7000HS series, RTX 4050, 24GB RAM, 1TB SSD) and while the system already runs great and feels super snappy, I keep seeing people posting about random micro-tweaks or kernel flags promising "huge performance gains."

Most of the time when I test them (like those random GPU/modprobe tweaks), it's either a total placebo or yields maybe a 2–3 FPS difference in benchmarks.

I’m not talking about minor 5–10 FPS or 2% improvements here. Is there actually a proven, heavy-hitting strategy, kernel parameter, or optimization combo on CachyOS that genuinely pushes performance significantly higher (like a real 15–20%+ jump in games or heavy loads), or is this hardware already maxed out by default and everything else is just snake oil?

Would love to hear what you guys have actually tested and verified on similar modern laptop setups. Thanks!


r/cachyos • • 7h ago

Review Didn't use the computer for 3-4 weeks ish

26 Upvotes

I had 410 Updates! I almost went panick mode after doing the update, then rebooted. Everything went smooth.

Sure, I have an AMD CPU & GPU, maybe that helped a bit in the way. But it's truly amazing how stable Cachy OS is.


r/cachyos • • 19h ago Bravo

SOLVED HUGE PERFORMANCE UPLIFT FOR RDNA4

206 Upvotes

so i put options amdgpu moverate=0 in /etc/modprobe.d/amdgpu.conf (and rebuilt initramfs + rebooted) and honestly the difference is wild. games feel way more responsive with noticeably less input lag, and in deadlock on latest ge-proton via vulkan i went from 250-430 fps straight up to 350-600 fps (9800x3d + 9070 xt + cachyos kernel 7.4). From what the kernel docs say this removes the driver bottleneck on buffer migration speed between ram and vram, can someone else test this out on their setup and let me know if im tripping or if its actually legit?

If you're not how to do this there is a guide

  1. Create conf file -> sudo nano /etc/modprobe.d/amdgpu.conf

  2. Add this -> amdgpu options moverate=0 and save and exit

  3. Rebuild initramfs by doing sudo mkinitcpio -P and restart computer.

  4. Play , i suggest to test on cpu heavy games like cs2, dota or deadlock.

Can someone confirm i'm not tripping ?

it would be nice if this value is exposed / implement in windows registry too in future. Its so much smoother than Windows even without it , but once i've add this, everything feels super coherent

Please tell me i'm not alone


r/cachyos • • 1h ago

Desktop Y'all I did it finally

Post image
7 Upvotes

Idk why it took me so long, and I am an avid Linux Enthusiast, have used 14 distros and finally had the courage to dual-boot CachyOS on my 2019 Intel Mac. Sure, the wifi was a bit sketchy and I had to do some tweaks but I got it working, so hell yeah 🔥


r/cachyos • • 8h ago

Question Any cleaner app to not get my root partition full?

20 Upvotes

Hi, it's been some months since I switched to Cachy, great experience overall, but my root partition (which is 100GB, only for the system, my personal files are placed elsewhere) is getting full update after update. I think it may be all those libraries that get updated every now and then, but I don't know really. Is there any app that can help me free some space up there?


r/cachyos • • 2h ago

Desktop NIRI IS AWSOME!

Thumbnail reddit.com
3 Upvotes

r/cachyos • • 8h ago

Question Is there a downside switching from limine to grub?

9 Upvotes

I've been using Cachyos for while now and suddenly im having issues with limine getting stuck on black loading screen, i google the issues and look it up on cachywiki/forum and the culprit was plymouth so just remove it base on the instruction and now everything is white, so should i just switch to grub or is there a fix for this?


r/cachyos • • 4h ago

Desktop Dual Booted CachyOS With Windows; First Time Linux User

3 Upvotes

Hello! I am a first-time Linux user who just migrated from Windows. I would have loved a full OS swap, but a lot of my important files are on Windows, and since I have two drives, I decided I may as well switch to Linux. Prior to this, I tried out (on a VM) Ubuntu, Debian, Fedora, and of course, CachyOS. Debian and CachyOS were my favorites. I loved Debian's simplicity, but I also got to tinker around, and it was surprisingly fast especially since all other distros were slow on my VM. However, I decided I wanted to do more, as my VM was very limiting, so I decided to dual-boot. I chose CachyOS because of how optimized it is for gaming, and I love tinkering and customizing things to a T.

The reason I even switched from Windows is because Windows was very limiting, and without third-party modifications like Windhawk, I couldn't customize much. Not to mention, I got 40–50% RAM usage on Windows with my browser and apps open, while I get ~26% on CachyOS with the same apps open (and then some).

As you can see, I am using GNOME. I know it's odd to see Arch combined with GNOME, however, I couldn't figure out how to make KDE look "better," and Hyprland... didn't work. Every time I tried Hyprland on both my VMs and my actual desktop, I always encountered a huge scaling issue where I would be extremely zoomed in and effectively couldn't fix it. It was the same as having no display. GNOME looks very simple and very familiar because I am used to taskbars, and I love top bars (which weren't an option on Windows). I don't know how I can beautify my desktop further, nor do I know how to make my standard terminal look good like those posts online of people showing off their god-gifted desktops.

That is basically all. I don't have much else to say, and I apologize if some things look strange or are weird combinations. I don't really know Linux THAT well since I used a lot of Gemini combined with reading documentation it's how I even got to dual-boot (I am 13 FYI, and I want to spend my time having fun).

If anyone has any recommendations on what I can do next, please let me know. I know I'm not using Linux to its full potential, which is why I need help from the best.


r/cachyos • • 1d ago

Desktop finally made the switch to cachyos and i’m loving it.

Post image
245 Upvotes

i just got a 2tb wd black sn850x ssd to dualboot linux and im lovinn linux. its so smooth already, i cant wait to daily drive it. are there any suggestions yall got for me to customize my set up and to make it more efficient? maybe if ya’ll could share your setups and provide your .dotfiles that would be great:)


r/cachyos • • 42m ago

Question Xbox Controller wont connect to bluetooth

1 Upvotes

My computer sees the device and is able to connect but the controller keeps flashing and cant be used. What can i do to fix this


r/cachyos • • 52m ago

Help FreeCAD crashes with SpaceMouse

Thumbnail reddit.com
1 Upvotes

Does anybody know which driver I should use?


r/cachyos • • 3h ago

Help Sometimes when locked, brightness goes down to ~50% but reports back as 100%

1 Upvotes

When I leave my computer but plan on returning soon after, I lock the session with Super+L and then ESC so it doesn't constantly render my animated wallpaper. If I return to my computer within a few minutes it's fine, but if I'm gone for any longer my brightness goes down to what looks like about 50%. System Settings -> Display & Monitor -> Display Configuration reports brightness as 100% though.

Using KDE on Linux 7.3.4-1-cachyos.


r/cachyos • • 3h ago

Help logged out after shelly updates

1 Upvotes

For the past few days, whenever I install updates via Shelly GUI, I get logged out of CachyOS. Is this happening to anyone else? Or false settings?!


r/cachyos • • 1d ago

Desktop All that time spent customizing just to end up with this lol, at least I'm having fun

Thumbnail
gallery
73 Upvotes

r/cachyos • • 1d ago

Desktop Day 4 in CachyOS loving it so far

Post image
56 Upvotes

r/cachyos • • 1d ago

Review Switched to Cachy last month. Never going back to Windows again.

Thumbnail
gallery
107 Upvotes

Last month, I tried CachyOS as an absolute Linux beginner and I learned pretty quick. I was going with Plasma because it looks beginner friendly and easy to adapt. I llike how you don't have to install a lot of things just to customize something, like no windhawk or random things to install that slows down your windows install.

I'm really loving it now, since the OS itself doesn't eat all my space, the updates didn't break anything (yet...), Cachy-update also can be disabled which I really like since I prefer updating things manually when it is required to.


r/cachyos • • 7h ago

Question Running FreeCAD

0 Upvotes

I've broken into learning 3d modeling and FreeCAD is a great option to try. However, it refuses to run without opening it through terminal and running a command beforehand, which is then followed by a bunch of errors about fonts. Anyone able to help? I found the preload code on another forum, but its just frustrating to have to do this every single time. I don't really care about the font errors unless they're important (I don't think they are).

❯ LD_PRELOAD=/usr/lib/libdrm_amdgpu.so.1 ./FreeCAD_1.1.4-Linux-x86_64-py311.AppImage
FreeCAD 1.1.4, Libs: 1.1.4R20260928 (Git shallow)
(C) 2001-2026 FreeCAD contributors
FreeCAD is free and open-source software licensed under the terms of LGPL2+ license.

Fontconfig warning: "/etc/fonts/conf.d/48-guessfamily.conf", line 19: invalid attribute 'xsi:nil'
Fontconfig warning: "/etc/fonts/conf.d/48-guessfamily.conf", line 20: invalid constant used :
Fontconfig warning: "/etc/fonts/conf.d/48-guessfamily.conf", line 23: invalid constant used : monospace
Fontconfig warning: "/etc/fonts/conf.d/48-guessfamily.conf", line 42: invalid attribute 'xsi:nil'
Fontconfig warning: "/etc/fonts/conf.d/48-guessfamily.conf", line 43: invalid constant used :
Fontconfig warning: "/etc/fonts/conf.d/48-guessfamily.conf", line 46: invalid constant used : sans-serif
Fontconfig warning: "/etc/fonts/conf.d/48-guessfamily.conf", line 68: invalid attribute 'xsi:nil'
Fontconfig warning: "/etc/fonts/conf.d/48-guessfamily.conf", line 69: invalid constant used :
Fontconfig warning: "/etc/fonts/conf.d/48-guessfamily.conf", line 72: invalid constant used : serif
Fontconfig warning: "/etc/fonts/conf.d/48-guessfamily.conf", line 88: invalid attribute 'xsi:nil'
Fontconfig warning: "/etc/fonts/conf.d/48-guessfamily.conf", line 89: invalid constant used :
Fontconfig warning: "/etc/fonts/conf.d/48-guessfamily.conf", line 92: invalid constant used : emoji
Fontconfig warning: "/etc/fonts/conf.d/48-guessfamily.conf", line 108: invalid attribute 'xsi:nil'
Fontconfig warning: "/etc/fonts/conf.d/48-guessfamily.conf", line 109: invalid constant used :
Fontconfig warning: "/etc/fonts/conf.d/48-guessfamily.conf", line 112: invalid constant used : math
Fontconfig warning: "/etc/fonts/conf.d/48-guessfamily.conf", line 120: invalid attribute 'xsi:nil'
Fontconfig warning: "/etc/fonts/conf.d/48-guessfamily.conf", line 121: invalid constant used :
Fontconfig warning: "/etc/fonts/conf.d/48-guessfamily.conf", line 124: invalid constant used : system-ui
Fontconfig warning: "/etc/fonts/conf.d/48-guessfamily.conf", line 132: invalid attribute 'xsi:nil'
Fontconfig warning: "/etc/fonts/conf.d/48-guessfamily.conf", line 133: invalid constant used :
Fontconfig warning: "/etc/fonts/conf.d/48-guessfamily.conf", line 136: invalid constant used : cursive
Fontconfig warning: "/etc/fonts/conf.d/48-guessfamily.conf", line 144: invalid attribute 'xsi:nil'
Fontconfig warning: "/etc/fonts/conf.d/48-guessfamily.conf", line 145: invalid constant used :
Fontconfig warning: "/etc/fonts/conf.d/48-guessfamily.conf", line 148: invalid constant used : fantasy
Fontconfig warning: "/etc/fonts/conf.d/48-guessfamily.conf", line 156: invalid attribute 'xsi:nil'
Fontconfig warning: "/etc/fonts/conf.d/48-guessfamily.conf", line 157: invalid constant used :
Fontconfig warning: "/etc/fonts/conf.d/48-guessfamily.conf", line 160: invalid constant used : ui-sans-serif
Fontconfig warning: "/etc/fonts/conf.d/48-guessfamily.conf", line 168: invalid attribute 'xsi:nil'
Fontconfig warning: "/etc/fonts/conf.d/48-guessfamily.conf", line 169: invalid constant used :
Fontconfig warning: "/etc/fonts/conf.d/48-guessfamily.conf", line 172: invalid constant used : ui-serif
Fontconfig warning: "/etc/fonts/conf.d/48-guessfamily.conf", line 180: invalid attribute 'xsi:nil'
Fontconfig warning: "/etc/fonts/conf.d/48-guessfamily.conf", line 181: invalid constant used :
Fontconfig warning: "/etc/fonts/conf.d/48-guessfamily.conf", line 184: invalid constant used : ui-monospace
Fontconfig warning: "/etc/fonts/conf.d/48-guessfamily.conf", line 192: invalid attribute 'xsi:nil'
Fontconfig warning: "/etc/fonts/conf.d/48-guessfamily.conf", line 193: invalid constant used :
Fontconfig warning: "/etc/fonts/conf.d/48-guessfamily.conf", line 196: invalid constant used : ui-rounded
Fontconfig warning: "/etc/fonts/conf.d/48-guessfamily.conf", line 204: invalid attribute 'xsi:nil'
Fontconfig warning: "/etc/fonts/conf.d/48-guessfamily.conf", line 205: invalid constant used :
Fontconfig warning: "/etc/fonts/conf.d/48-guessfamily.conf", line 208: invalid constant used : fangsong
Fontconfig warning: "/etc/fonts/conf.d/48-spacing.conf", line 14: invalid constant used : monospace
Fontconfig warning: "/etc/fonts/conf.d/49-sansserif.conf", line 10: invalid constant used : serif
Fontconfig warning: "/etc/fonts/conf.d/49-sansserif.conf", line 18: invalid constant used : sans-serif
Fontconfig warning: "/etc/fonts/conf.d/49-sansserif.conf", line 26: invalid constant used : monospace
Fontconfig warning: "/etc/fonts/conf.d/49-sansserif.conf", line 34: invalid constant used : emoji
Fontconfig warning: "/etc/fonts/conf.d/49-sansserif.conf", line 42: invalid constant used : math

r/cachyos • • 1d ago

SOLVED "Add To Steam" suddenly doesn't work anymore?

Post image
84 Upvotes

Out of no where today it started giving me this error in the picture.

I tried exiting and opening steam, and tried rebooting the pc as well, same issue.

Any idea about what could've caused this?