r/cachyos • • 13d ago

Announcement Announcement: Framework Is Tripling Its Support for CachyOS

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

CachyOS Troubleshooting First Steps

142 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

Review The "Powered by CachyOS" stickers inspired me

Post image
102 Upvotes

Yea so the title speaks for itself, took inspiration from both the previous creators.
Link for both .svg, high quality .png (if someone would be nice enough to host the files somewhere else, on this site they expire in 3 days) u/dereckgcc , u/Dear-Level-9404


r/cachyos • • 10h ago

Review Powered By Cachyos Sticker (My rendition)

Post image
351 Upvotes

Wanted to share my take (Originally envisioned by u/Dear-Level-9404) on the powered by Cachyos logo. Thanks for the inspo to OP!

Link to the PNG and SVG files https://we.tl/t-p4ji5A0e2yd8YjR3

Edit: I fixed the black space above and below the “powered by CachyOS“ as suggested, the fixed file can be found in the shared documents.


r/cachyos • • 1h ago

Desktop Finally got around to ricing fastfetch

Post image
• Upvotes

A little more eye candy in my life :D


r/cachyos • • 21h ago

Review Powered By CachyOs Files

Post image
622 Upvotes

Hi there I'm the guy who posted the powered by CachyOs stickers
There you have the files

Feel free to use it, print, share with your friends and community
I suggest you to download the SVG format

Thx for your comments

https://drive.google.com/drive/folders/1zeVejFlUXGdeBlv_i3Y4t4cawL_S4TXW Here is a file where you can find the SVG and PNG if you don't want to use canva


r/cachyos • • 13h ago

Review Got The Best Linux Distro Ready For Wow Forever!

Post image
131 Upvotes

r/cachyos • • 1d ago

Review CachyOS is adding a dedicated EACv2-compatible kernel (`linux-cachyos-eac`) plus a Secure Boot setup guide so users can optionally meet Epic’s new Easy Anti-Cheat Linux v2 requirements without changing their normal optimized kernel.

Thumbnail
github.com
830 Upvotes

r/cachyos • • 22h ago

Review Powered by CachyOs

Post image
433 Upvotes

I just made these stickers for my PC and laptop

What do you think?

Here are the design for you!!!

https://canva.link/s380nkoa3298592
Feel free to use it, print or share with someone!!!

If you want to download it I suggest you to save as SVG

https://drive.google.com/drive/folders/1zeVejFlUXGdeBlv_i3Y4t4cawL_S4TXW

Here is a file where you can find the files if you don't want use canva


r/cachyos • • 6h ago

Help CachyOS seems to have bricked itself.

21 Upvotes

I'm not sure what to say here, but my system all of a sudden broke while I was playing Subnautica 2. First the lockscreen broke, then I tried restarting KDE and that failed. I tried restarting my computer but it'd lock up as soon as plasmalogin loaded, none of the TTY's would work, so I decided to chroot from my live USB to run a pacman update. I got this when I tried running it: fish: Job 1, 'pacman -Syu' terminated by signal SIGBUS (Misaligned address error). I am kinda at a loss of what to do.

Linux Kernel 7.2.11-1-cachyos
KDE Plasma 6.7.11(?)
AMD Ryzen 5 2600X
32GB DDR4 2666
RTX 4070 TI
BTRFS filesystem with 20 GiB unallocated space 37GiB Free (from df -h)
Pretty new to CachyOS (and Arch)

If you need more info, I will gladly share it, I just didn't know exactly what I needed to share.

Edit: Forgot to mention flatpak does the same thing, so it seems whatever happened is affecting a lot of utilities on my system.


r/cachyos • • 4h ago

SOLVED Solved Random Freezing!

10 Upvotes

TL;DR: If you're getting random freezes, memtest your EXPO profile and try disabling global C-state control in your BIOS.

Relevant Specs: Ryzen 7 9800X3D, ROG Strix B650E-I, RTX 5070 Ti, Corsair SF750, 32GB (2x16GB) G.Skill Flare X5 DDR5-6000 CL30

I've been running CachyOS for a few months now and overall it's been great. I like to tinker, so it's a good fit. I mainly use it as a daily driver for YouTube, web browsing, and quite a bit of gaming (007 First Light has been smooth as butter).

Recently I moved and had to store my PC for a few weeks. The CMOS battery must have drained or something, because my BIOS settings got reset. No biggie, I just re-enabled EXPO and booted back up.

Then I started getting random hard freezes in a couple of scenarios. First, it would lock up during regular browsing, and the only fix was a hard reset. Later, I'd see freezes on the lock screen, or the PC wouldn't wake from sleep. Troubleshooting revealed my memory was failing MemTest. My heart sank. The RAM kit is still under warranty, but I was super frustrated.

I tested a bunch of configurations (EXPO off, individual sticks in different slots, BIOS update) and figured out the profile was the problem. There were two, and I'd picked an unstable one by accident. That fixed the freezes during regular use, but not the lock screen ones.

So I kept digging until I remembered another BIOS setting. Back on Windows I'd disabled C-states, hoping it would help with coil whine (turns out the whine was coming from the GPU). The BIOS reset put that setting back to default, so I disabled C-states again to test, and voila! No more freezes on the lock screen for the past couple of weeks, and the PC sleeps as expected.

Definitely a rollercoaster bouncing between troubleshooting and spiraling over potentially needing to RMA the RAM. Figured if other people were experiencing similar issues I would just share what worked for me.


r/cachyos • • 29m ago

Desktop What is the top kernel level AC game you would play if it came to Linux?

• Upvotes

With the discussions of EAC becoming more linux friendly and CachyOS making an option for kernel level AC, what is the one game you would pick up immediately if it makes its kernel anti-cheat work on Linux?

I'll start with a game I pray never comes to Linux. League of Legends. I hope to all that is holy that Riot has some phobia of Linux users for forever because if that game comes over here, then I know for a fact my addiction will return with a vengeance, and I have finally had a year of being able to sleep properly, something I haven't had in quite awhile XD


r/cachyos • • 3h ago

Question NTFS to BRTFS

4 Upvotes

Hi everyone,

Im one of those people who uses Windows, but every now and then feels the urge to switch back to Linux - and then switch back again. Right now Im still missing the full range of features when it comes to Game Pass (I know Xodus does a great job).

The question thats giving me a headache right now: Is it possible to convert NTFS to BFS without constantly copying data back and forth?


r/cachyos • • 2h ago

Question Does CachyOS leave unsupported Kernels in there Kernel manager?

Post image
3 Upvotes

I migrated to CachyOS from mint, so I'm used to seeing unsupported kernels in the kernel manager.


r/cachyos • • 44m ago

Help Discord issues.

• Upvotes

Discord through pacman has been running quite fine for me for the last month or so. When i watch others streams, it would stutter so i turned off gpu acceleration and its been running very smooth. Now this morning, it wont load anyones streams. If i turn gpu acceleration back on, i can see, but the stutter persists, while turning off i cant load stream at all.

Not sure what changed. I updated everything thinking maybe it would fix but yea, nothin.


r/cachyos • • 8h ago

Bug Report Mesa update in cachyos repository still in version 26.2.4

8 Upvotes

My CPU is v4 capable and I don't understand why there is no mesa in cachyos-v4 repository (and there is in cachyos-v3 ??), so my mesa driver is updating from cachyos repository, but the version there is stucked at 26.2.4 while all other repos has already 26.2.5. In Arch extra repo there is already 26.2.5 so why it doesn't update from there? Can anyone explain how does it work?


r/cachyos • • 10h ago

Question I’m thinking about switching to CachyOS.

11 Upvotes

Hello. I’ve never used Linux, but I’m becoming increasingly tempted to try it because Windows keeps throwing random errors at me—most likely due to my aging processor. My setup includes an i5-6600K, a GTX 1080, and 16 GB of RAM; will I run into any issues with CachyOS? I ask because I’ve heard that NVIDIA hardware can be problematic on Linux, and, well, my CPU only has 4 cores. Also, is there a truly noticeable improvement when switching from Windows to Linux? For context, I primarily use this computer for gaming.


r/cachyos • • 3h ago

Question noctalia setup wizard

2 Upvotes

i want to open the noctalia setup wizard as i accidently closed it on my first session(mostly just for just in case and a full experiance) since i closed it .setup-complete wasn’t made but no matter what i do i cannot seem to open the wizard again
also can someone confirm if there should be any inbuilt wallpaper and themes
was rlly hoping for the emerald one cachyos docs showed


r/cachyos • • 1h ago

Help Discord 2012 error while trying to view streams or camera

• Upvotes

Hello, I encountered a problem which I can't seem to fix, discord doesn't let me view my friends streams or camera, only while viewing through the browser it works.

I'm on KDE Plasma and I've updated my system fully, I'm using official Discord app.


r/cachyos • • 2h ago

Help CachyOs cannot be booted

1 Upvotes

Friends, I haven't been updating for a week or so, I thought I'd do it accumulated because it was a kernel update, I did it because the reboot was real and it didn't boot, it fell into emergency mode and I threw the opening logs to the ship, I tried to solve it, it didn't work, I returned to the snapshot of the day 1 day ago with Lemine, it was solved, but the problem is still not solved, can someone knowledgeable help the problems that the ship said

  1. System Update and Emergency Mode: After a system update, CachyOS was not turned on due to missing module and kernel errors and fell into emergency mode.

  2. Lost EFI and Connectivity Issues: Since the correct EFI/boot partition (⁠nvme0n1p1⁠) is initially connected to the ⁠/boot⁠ directory, kernel and module updates cannot be written in the correct place, which led to errors such as not ⁠vfat file system or module found.

  3. ⁠mkinitcpio⁠ and ⁠sd-btrfs-overlayfs⁠ Hook Error: After connecting the partition and reinstalling the kernel, this time the initramfs image was created, an error was started to be received because of the hook named ⁠sd-btrfs-overlayfs⁠, which was no longer present in the system or remained as a residue in the configuration.

Logs

https://drive.google.com/drive/folders/1-u9-Np0_Goi9XoIbq2K1Zh4yMf903Zta


r/cachyos • • 8h ago

Question Newbie asking dumb question about distro hopping

3 Upvotes

So I am currently using Nobara with my root one drive and my home directory on a different drive. I have been considering jumping over to Cachy and wanted to know if there is anything I should take into consideration, be aware of, or do/not do before/after installing Cachy on my root drive overtop of Nobara?

I know I’ll have to reinstall my programs, but from what I think I know is the program files will be readable and most settings will set up appropriately.

My computer use is mostly gaming based. So the programs I have running are StreamContoller for my Elgato Stream Deck+, Steam, Brave, and really that’s about it.

I have never used the AUR. And my Linux knowledge and command line knowledge is mostly Fedora/RedHat based from my professional background. But love learning new things.


r/cachyos • • 6h ago

Question Quick access 2 button nil function on MSI CLAW EX 8ai+

Post image
2 Upvotes

Anyone know how to map this button to bring up steam home in cachy handheld edition? Spent 2 hours last night trying with input plumber and terminal commands wont do anything, tried rebinding it to keyboard as well, as far as I know in input plumber this is mapped as quick access menu 2 but I’ve tried the other quick access source also no luck, also tried F14,15 and 16 won’t do anything. Device name is MSI CLAW EX 8ai+ with the g3e chip

EDIT: Got it to work with chatgpt, inputplumber was expecting key_F15 and key_g and is only outputting g change mkdir -p /etc/inputplumber/capability_maps.d
source_events:
- keyboard: KeyF15
- keyboard: KeyG
target_event:
gamepad:
button: Guide

to:

    source_events:
      - keyboard: KeyG
    target_event:
      gamepad:
        button: Guide

r/cachyos • • 6h ago

Help Discord PTT not working as it should anymore

2 Upvotes

I have been using my mouse side button for push to talk since installing cachyos about 3 months back. Since updating to KDE plasma 6.8, I find the PTT deactivates whenever I push another key.

So it is bound to the mouse side button. This button is set to mimic the scroll lock button on the keyboard through a profile. I cannot change this profile without plugging into a Windows system and installing Icue software.

I push and hold the button in, and discord will transmit as it should. It does this even if the window is not selected. So I can be playing in game window and the key bind works. But as soon as I use another key, it deactivates the button. I then have to release any key I have pressed on the keyboard, and then release and repress the side button.

Any help with this is appreciated.

EDIT: I even went so far as reformatting this morning. This still has not fixed it.


r/cachyos • • 16h ago

Desktop So I just installed and setup CachyOS + Hyprland coming from Windows Game Dev background....

Post image
12 Upvotes

Yeah so just as the title says, and I don't want to love it. But I'm, loving it.
So as I said I do Game Development primarily on Windows in Godot, Unity, and Unreal. But recently, I though I needed a break from Windows. And given the OS was already deteriorating from 3+ years of projects and work. I thought I'd just see what was I was missing and download Arch Linux.

This post is just to get feedback from the community on if I made a good choice (posting this in a CachyOS subreddit probably would sway towards good ). But also I came to ask a few questions on software and programs I should get to make Hyprland / Waybar look good, and on what I can / can't download on linux ( like adobe software )


r/cachyos • • 1d ago

Question Anyone else running Linux as their only OS on a high-end PC?

Thumbnail
190 Upvotes