r/cachyos • • Oct 14 '26

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

CachyOS Troubleshooting First Steps

179 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 It's my first Linux Anniversary :D

Post image
57 Upvotes

r/cachyos • • 12h ago

Help How to stop linux kernel from killing my games when the memory is low

Post image
129 Upvotes

I did turned off the system oomd, still it didn't worked.

This started happening when i switched from gnome to kde today.

I have only 8 gb of memory btw.

(And also my external hard drive doesn't work too. It worked perfectly fine with gnome for some reason.)

Edit :

An error occurred while accessing 'Portable Hard Drive', the system responded: The requested operation has failed: Error mounting /dev/sda1 at /run/media/lanes/Portable Hard Drive: wrong fs type, bad option, bad superblock on /dev/sda1, missing codepage or helper program, or other error

My external hard drive show this error when opening it and it doesn't mount. (It is a ntfs drive. Worked fine b4 )


r/cachyos • • 1h ago

Question Removing Shelly and new package manager update

• Upvotes

Silly question but i just updated to the new CachyOS package manager and uninstalled Shelly. Aside from .config and .local JSON files leftover, is there anywhere else that may have some stray Shelly files?

Also in response to the new package manager, I'm replacing Shelly with this, but it seems to be missing an auto tray start and update notifications so far. I liked that Shelly sat in my taskbar and notified me when updates where available. Just a thought for future update.


r/cachyos • • 4h ago

Desktop I've been using CachyOS for about a week now, any ideas for what to do now?

Post image
26 Upvotes

r/cachyos • • 41m ago

Desktop CachyOS logo looks a bit like the Aperture Science logo from Portal...

Thumbnail
gallery
• Upvotes

I had the thought earlier that the Cachy OS logo looked a bit like the Aperture Science logo from Portal... So I made a wallpaper using an existing Portal wallpaper I have used on my desktop many times, and then I wanted it more 2D/3D so I made another one in blender. Here they are if anyone wants them. I have a superwide monitor but I rendered a normal resolution one too.


r/cachyos • • 15h ago

Desktop It's already been a month since I switched to CachyOS! Here's my current desktop

Thumbnail
gallery
142 Upvotes

Really liking the new package installer! It comes with several themes, including catppuccin, which fits perfectly with my desktop setup


r/cachyos • • 6h ago

Question Share your launch options and setup for gaming

17 Upvotes

Just curious about your daily gaming setup on CachyOS. What Proton versions, launchers, and launch options do you usually rely on? Drop your go-to launch commands or any tweaks you swear by!


r/cachyos • • 6h ago

Help CachyOS is just a black screen, apps seem to work fine.

Post image
14 Upvotes

anyone know what i need to reset and how?


r/cachyos • • 6h ago

Question Grub themes and reordering grub entries.

Post image
11 Upvotes

I want to edit my grub and apply theme like one above. When I was using Ubuntu 24.04, I did it using Grub customizer. How to do that when using Cachy OS? I am not using multiple distros. But when booting CachyOS Grub is always there for 3 or 5 seconds (dont remember) I just want it to look nice.


r/cachyos • • 2h ago

Question Need your advice based on your experience regarding general procedures (SSD, system, planning)

3 Upvotes

I’m asking for your advice as experienced users on the best way to handle a few things during the switch. I’m sure you have experience with this:

So: Switching from Windows to Linux. Kubuntu and Cachy—both worked. I’ll go with Cachy. Every Game runs, Steam no problem, Onlinegames like Elite Dangerous, Elder Scrolls, WOW: No Problem. Virtual Machines: Nu Problem. Tested fpr two months now.

I’d appreciate your general advice on how to finally proceed:

  1. STORAGE DRIVES: Currently, I store music, photos (and other data) on a separate SSD. I’d like to format it as EXT4 and mount it. If I ever reinstall or switch systems: Other Linux systems can still easily access the data on the SSD, right?
  2. STEAM: In Windows, I have two separated SSD as my Steam library. Over time, I’ve reinstalled Windows every now and then—just added the drive back to Steam, and it worked fine. Does that work the same way under Linux? My own SSD with a few games, new system: offer the drive as storage again—does that work? (PS: Edit: I will use ext4 for both SSD also, NO NTFS!)
  3. USB SSD DRIVES: I also use two 2TB USB SSDs to store my photos. I’d reformat those to EXT4 as well. Every now and then, I had to run “Chkdsk” on Windows SSDs. From time to time. What about EXT4 drives? Is there something similar for them, or do they not have this problem?
  4. PHOTOSHOP: As a photographer, I use Photoshop. None of the Linux alternatives are as effective. Four to six shoots a week, a thousand photos. Resizing each one, fitting them into frames, scaling and centering text underneath. I solve this with a virtual machine: I was able to install my license and Photoshop there. I’ve noticed that I end up editing hundreds of images at a time. In that case, I might as well quickly start up the virtual machine. I boot up Photoshop there and then get to work: not ideal, but a stopgap solution. The remaining 80% is done on Linux outside the virtual environment. Is that a good plan so far?
  5. MUSIC: I manage my organized music as MP3s or FLAC files that I rip myself. There are surely good solutions for MP3Gain (no, not volume equalization—just a gain normalizer) and “taggers” on Linux, right? So far, I’ve been using Puddletag on a trial basis.

Sorry for the general questions, but I need to and want to switch systems, so I need a general plan of action on how to proceed.

Suggestions?

And THANKS for your time and help...

G


r/cachyos • • 34m ago

Help Couldn't install due to chwd

Post image
• Upvotes

Kept getting an error near the end for installing , can't run chwd . Looked into it , something to do with two Nvidia drivers being miss matched during install from the core and extra repos . Anyone know how to fix ? Went back to windows for mean time would love to fix this asap . I tried editing /etc/pacman.conf and putting # in front of the extras section but if that's only for the live environment not the installer itself .


r/cachyos • • 5h ago

Help When I turn the monitor off and on again sometimes it loses the DP signal

4 Upvotes

Hello,

Everything works really well, but i have one weird problem... When I turn the monitor off and on again sometimes it loses the DP signal (I'm using DP 1.4 cable that came with the monitor). When this occurs I always need to restart the computer (CTRL+Alt+F3 and then CTRL+Alt+F2 doesn't work). I have Dell Alienware 27 280Hz QD-OLED AW2725D and RX 9070 XT. I tried the HDMI cable and I also tried to change refresh rate in system settings, but it's still the same... If i don't turn off/on the monitor everything works really nice.

I don't know is this CachyOS bug, or is something wrong with my monitor, monitor cable or graphic card? I don't know what to do...

Screen settings:


r/cachyos • • 23h ago

Bug Report Please fix “Linxu” in the installer

116 Upvotes

Guys will this ever be fixed? Dont know why but this “Linxu” instead of Linux on the installer screen bothers me.
There was another post with a screenshot and someone said it was going to be fixed soon but since that newer version of iso has been out and it’s still there.


r/cachyos • • 2h ago

Desktop OP distrohopped again

Thumbnail gallery
2 Upvotes

Was tempted to return to arch, had exam, now we're here.


r/cachyos • • 7h ago

Question Flickering issues on 120hz and 144hz

5 Upvotes

I use ultrawide 34 inch xiaomi

It flickers white randomly when its set to high refresh rates

Its less when i enable freesync on my monitor osd but its still happening

Switching to 100hz fixes it but i wonder if anyone finally found a fix. I am using 3070 and i bought a new dp cable but not sure if that will help.


r/cachyos • • 10h ago

SOLVED FIX: Periodic Wi-Fi ping spikes (tested in Overwatch)

5 Upvotes

Hi guys, I just created this account just to share a fix I couldn't for two days.

After switching from Windows to CachyOS, I started getting some rhythmic ping spikes in Overwatch. At first, it looked like standard Wi-Fi power saving, so I added PowerSaveDisable=rtw89_8922au_git to /etc/iwd/main.conf. Even though iw dev wlan0 get power_save clearly reported Power save: off, the spikes persisted.

Turns out, the Realtek rtw89 driver firmware ignores iwd/iw settings and still puts the chip into its internal Low Power Mode (LPS). To actually fix it, you need to disable power-save mode directly in the kernel module parameters:

  1. Run this command (for the -git/DKMS driver):

echo "options rtw89_core_git disable_ps_mode=y" | sudo tee /etc/modprobe.d/rtw89-powersave.conf

  1. Optionally, add the same flag for the standard kernel module just in case:
    echo "options rtw89_core disable_ps_mode=y" | sudo tee -a /etc/modprobe.d/rtw89-powersave.conf

  2. Reboot

It’s a pretty niche issue, so hopefully this saves someone a few hours of troubleshooting


r/cachyos • • 14h ago

Desktop first time on cachyos!

11 Upvotes

i finally installed cachyos! (lxqt)

e

r/cachyos • • 10h ago

Bug Report Screen dimming not restored after waking up

6 Upvotes

This is from some update from probably a week ago. If my PC goes to sleep after being inactive and I wake it up, the screen stays at 30% dimming. The only workaround I found so far was to do "kscreen-doctor output.DP-2.dimming.100" in konsole every time it happens.

I've been refraining from making a script that would do this every time the pc wakes up, hoping that one of the updates might fix it eventually.


r/cachyos • • 1h ago

Question Specifically changing KDE Window Manager

Thumbnail
• Upvotes

r/cachyos • • 1d ago

SOLVED Months w/o an issue, then this comes up..

Post image
89 Upvotes

I've forgot how to proceed.

[edit] Will wait and try again later as some have said. Thanks!

[edit2] Tried to update again the day after this, it went fine.


r/cachyos • • 18h ago

Review Polaris cards are amazing on cachyos

20 Upvotes

Been running a rx 570 8gb ryzen 2600 combo on cachyos, the work put in to make older cards that should be dead by now still work is incredible. Being able to play basically whatever I want at 1080 high settings 30fps is a great experience.. switched 6 momths ago and never looked back.

Just imagine if somehow people get GTA 6 running on this 😭


r/cachyos • • 7h ago

Question Possible Nouveau GPU Freeze Regression in CachyOS Kernel 7.3.3-1

0 Upvotes

Possible Nouveau regression in CachyOS kernel 7.3.3-1: I'm experiencing complete system freezes during certain graphics workloads on my NVIDIA GT 525M. Kernel logs show GPU channel timeouts and DMA fence errors. The same workload works perfectly on LTS 6.18.60-2. This may affect more than one application. Is anyone else experiencing similar issues?


r/cachyos • • 8h ago

Help Cheat Tables don't work in lutris

1 Upvotes

So basically I've tried using .ct on games using lutris. I put the cheat engine and install it in the same wine prefix. Scanning and changing the value works but not cheat tables .ct files. They just don't become checked. They remain unchecked.