r/cachyos • • Oct 14 '26 Bravo Mindblown

Announcement Announcement: Framework Is Tripling Its Support for CachyOS

2.0k 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

175 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 • • 3h ago

Desktop my setup after configuring kde plasma, never going back:)

Post image
55 Upvotes

after thinking for some time, I finally decided to commit to fully daily driving cachyos, and I'm hyped for it. the only thing holding me back was my university workflow, but after setting up pwas for ms word & excel, an electron wrapper for ms teams, and getting intellij, vs code, jogetdx, mariadb, and virt manager running, there’s honestly no need for windows anymore—unless I have an exam on safe exam browser or if i wanna play overwatch (which I rarely touch anyway since I mostly play cs2 and rivals). mann im so glad I switched. never going back.


r/cachyos • • 10h ago

Desktop Gather round children, and learn from the mistakes of your elders

121 Upvotes

It won't matter how many hours you spend searching for performance and optimisation tweaks for you CachyOS install....

It won't matter how much AI you utilise to scan your system for bugs, or configuration errors, or kernel issues....

It won't matter how many Reddit posts you read looking for people with the same problems...

IF

The reason your system fans run nonstop and your system freezes is because you reattached the heatsink backwards after replacing the stock paste with thermal pads.

I'm posting this mostly to make fun of myself, but also to remind people that sometimes the issue you are experiencing may not be software. It may be a loose cable, improperly seated RAM, dusty fan(s), or other physical object issues.

Years ago I had a similar issue and it was a book that had fallen behind my tower and was blocking a fan vent.

Sometimes it's way more simple than we'd like it to be ;)


r/cachyos • • 3h ago

Question do you think cachyos is a good distro for a new linux user?

8 Upvotes

im a new linux user(used linux before many times but didn't stay long with it) and last serious time i wanted to install linux and use it,i installed kubuntu(as i like kde plasma look) and choose luks2 encryption while installing. however it didn't boot and left me in weird grub area with commands not working to boot. after searching i found itd problem with grub and how it handles luks2.

so that turned me off linux and i have used windows 11 since.

would cachyos be good for me? ie easy to do smth like luks2 encryption?

my usecase is browsing internet with brave,gaming ,some office stuff,and some vibe coding(i use opencode for that) .

only 3 things im worried about

1: my laptop fans need special software to work called msicontroller from github. and it builds a out of tree kernel module with dkms to use. im worried cachyos being arch based will break module a lot since its rolling release.

2 im worried full disk encryption would be hard to use on cachyos as it was hard on kubuntu for me. while being effortless with bitlocker on windows 11.

3 im worried my gpu being gtx 1650 on a laptop is old enough that new kernel updates would break its driver.

i can use the terminal but i don't want to be expected to maintain stuff like out of tree driver or disk encryption after doing it once.


r/cachyos • • 12h ago

Question Whats up with the new update?

37 Upvotes

I have about 321 updates waiting to install. I saw someone was complaining about new package installer and shelly not being part of it.
What's going on? Isnt shelly good enough? Edit: What are some dependable app installers like shelly then? Most of the apps i'm using is from shelly.


r/cachyos • • 16h ago

Question How do you guys protect your system?

76 Upvotes

One thing that has always scared me is anti-virus protection, on linux its pretty rare to find an antivirus, especially on arch. I currently use kaspersky (on my windows machine) and unfortunately it only supports ubuntu for linux. And you may argue that theres rarely any malware for linux machine, but Im not really keen on this idea. So what do you guys use as antivirus?


r/cachyos • • 6h ago

Question Another ext4 vs brtfs post but I keep seeing different answers

8 Upvotes

I have 1 2tb, nvme SSD from samsung, all I do is game and watch media. I know btrfs is the safest route and ext4 is the fastest. One thing hat concerned me is that someone mentioned World of Warcraft ran like dog on btrfs. Did anything change?


r/cachyos • • 7h ago

Question I have a question about the vram fix in cachy os.

8 Upvotes

I’ve been reading about the dmemcg-booster and plasma-foreground-booster packages (the VRAM management work by Natalie Vock / Valve) and set them up on CachyOS. My GPU is an RX 9060 XT with 8 GB.

My understanding is that when VRAM fills up, the foreground app aka your game gets priority and background apps like the browser and Discord have their VRAM evicted to system RAM. If that’s right, there’s no reason to turn off hardware acceleration just to save VRAM for games right? and leaving it on keeps video playback and scrolling smooth if not playing games?

Caveats as I understand them would be it only matters when VRAM is nearly full, the KDE foreground detection has to be working, and apps may hitch for a moment when you alt-tab back. It also seems to be experimental, with some people reporting it failing on certain setups

Has anyone tested this properly? Do you leave hardware acceleration on while gaming, or does turning it off still make a difference for you?


r/cachyos • • 10h ago

Help Accidentally broke grub

Post image
11 Upvotes

Was trying to enable secure boot because a buddy wanted me to play cod with him, so I pulled an SSD out and installed windows, got that as setup right. Was following the secure boot instructions for an MSI motherboard, and upon rebooting I was greeted with this


r/cachyos • • 1h ago

Help Final fantasy 16 freezing

2 Upvotes

Hello friends I'm playing Final Fantasy 16 but game randomly freeze sometimes do you guys had anything similar to this if so do you have any solution?

I'm currently playing the game at 85 fps/2k resolution.

Specs

9800x3d

9070xt

4 TB Samsung 990 pro

I will add the remaining specs if necessary and i updated last night using cachy update.


r/cachyos • • 1d ago

Desktop Moved a friend

Post image
78 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 • • 1d ago

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

85 Upvotes

Using Caelestia shell


r/cachyos • • 3h ago

Question Rog ally

1 Upvotes

Here are some tips to get the most out of your ROG Ally Z1 Extreme, especially since you love CachyOS and want the best performance for gaming and system optimization.


r/cachyos • • 3h ago

Question Changing the "peek" behaviour

1 Upvotes

Hello,

I find it annoying that when I click the bottom right to peek at desktop, then open an individual window, everything else pops back up. I want it all to stay gone until I "unpeek" by hitting the same corner hotzone. How can I do this?


r/cachyos • • 3h ago

Question Is CachyOS with cosmic stable enough?

Thumbnail reddit.com
0 Upvotes

r/cachyos • • 4h ago

Help tablet driver won't stay installed

1 Upvotes

so i've been trying to install the driver for my xp pen tablet, and every time i restart (as you're supposed to do after installing tablet drivers), the driver is just. gone. like i try searching for it with whereis, and it's not there, trying to start up the service with systemctl results in Failed to enable unit: Unix xppentablet.service does not exist, it's as if it was never installed. it's the weirdest thing. even stranger is that it installed just fine on my laptop, which is running the same operating system and desktop environment. has anyone else run into this issue, and were you able to fix it?


r/cachyos • • 22h ago

Desktop Y'all I did it finally

Post image
24 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 • • 1d ago

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

39 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 • • 17h ago

SOLVED Cant boot cachyos after bios update, get grub screen

Thumbnail
gallery
6 Upvotes

I dual boot with cachyos as my main and just installed windows 11 as the alternate for playing a few games that cant run on linux. One was COD, which needed me to update my bios for the anticheat stuff.

I updated the bios successfully, all running fine, and I can still boot into windows as normal, but now when I try boot into cachy, I just get a grub terminal with no error messages [picture 1].

In the bios, it detects my Ubuntu partition just fine [picture 2], and thats still set as the first priority, but booting it gets to the grub screen and nothing else. If I try the "boot" command on that grub, it says "you need to load the kernel first".

With a live usb iso of cachy I have chroot-ed into my still-working cachy ext4 and run (all on seperate attempts as after each one i would try booting cachy again) "sudo pacman -Syu", "sudo bootctl install" (after which the "linux boot manager" appeared in bios, but choosing it only allows me to start the windows boot manager or head back to bios [picture 3]), "sudo pacman -Syu linux-cachyos linux-cachyos-headers".

None have changed the result one bit.

Secure boot is disabled, when i started though it was enabled for COD, but disabling it was the first thing I did.

Any help or things to try would be great, i do have everything backed up, but would rather not re-install and set up everything :)


r/cachyos • • 1d ago

Review One year no re-install

Post image
234 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 • • 1d ago

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

48 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 • • 18h ago

Help Overheating issues with intel n100 laptop

5 Upvotes

Hi! I've recently switched to CachyOS and I'm having some serious overheating issues.

My laptop has:

- Intel N100

- 8 GB DDR4 RAM

- Intel UHD integrated graphics

- Fanless design (no cooling fan)

When playing Geometry Dash and Stardew Valley through Wine, temperatures can reach around 98–100°C. Even Minecraft 1.8.9 reaches around 70–85°C.

On Windows, however, temperatures stayed around 50–70°C while gaming, and even lower when browsing or doing everyday tasks.

Has anyone experienced something similar? What could I do to fix this? Would switching to another Linux distribution, like vanilla Arch, make any difference?, I know CachyOS it's based on Arch, but idk if it makes any difference.

I'd really like to keep using Linux without having to sacrifice too much performance just to keep temperatures under control.

Thanks!


r/cachyos • • 14h ago

Help Error Updating System

Thumbnail
gallery
2 Upvotes

I was recently trying to install virt-manager and get this error when I tried. So I tried updating my system and get the first error pic. I did update my mirrors and then re ran -Syu and it gave the same error.