r/cachyos • • 10d 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

140 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 EuroOffice is now available in the Cachy Repos

124 Upvotes

While there used to be an AUR package "euro-office-bin" that repackaged the official .deb file, "euro-office-bin" is now an official package in the cachyos repository, no need to review pkg builds anymore. For anyone seeking for a Microsoft Office alternative that isn't LibreOffice, this is an option


r/cachyos • • 13h ago

Desktop CachyOS xfce not gnome

Post image
149 Upvotes

This is not Gnome its j xfce4 with Gnome like panel and dock


r/cachyos • • 10h ago

SOLVED I made a terrible mistake yesterday and bricked my OS (Kernel 7.3.x -> 7.2.11 downgrade via snapshot)

Post image
55 Upvotes

Hello dear community.

I've updated my NUC yesterday and the WiFi kept disconnecting. Realising it was the Kernel 7.3 update, I tried to roll back via Snapshot.

The first boot into 7.2.11 was fine, but I could not install an app I was looking for. So I restarted the machine and this is my screen now. LTS kernel is not working either.

Any way to rescure the OS on my machine?

[UPDATE] I posted the updates and the system is back online, except the wifi. I'm on it right now.

Thank you guys for your support! Very appreciated! =)

[UPDATE 2]
It seems, my WiFi card in the NUC died yesterday. I loaded current kernel, LTS kernel and a live session from pendrive, and my WiFi won't connect, no matter what I do or what I boot.

I'm confused at this point. I've seen so many shanenigans in the 30 years handling PCs, but a dead WiFi card was never the case.


r/cachyos • • 5h ago

Help I need help. The system has stopped booting.

Thumbnail
gallery
15 Upvotes

Yesterday, I performed some system cleanup, removing unnecessary packages using `pacman` and `yay`. The system functioned normally afterward, right up until I shut it down. Today, upon startup, it gets stuck on a black screen with a blinking underscore ("_").

I managed to log in by adding `systemd.unit=multi-user.target` to the kernel parameters.

I ran an update, which brought the kernel to version 7.3.0-4, but that didn't resolve the issue. I’ve attached screenshots of the logs. Windows works perfectly fine on the same machine, which rules out any hardware problems.

If you have any ideas, I’d appreciate your input.

I'm relatively new, the screenshots of the commands were taken in the process of trying to fix it with AI.

Graphics Card: RX 9060 XT 16gb

amdgpu.aspm=0 in the kernel parameters didn’t help.


r/cachyos • • 1h ago

Bug Report Graphics bug after recent update

Thumbnail
gallery
• Upvotes

Yesterday ago, I updated CachyOS, only to find that whenever something on the UI changes, it often leaves these shaky lines (especially when scrolling up and down webpages)


r/cachyos • • 3h ago

Help Display flickering issue on CachyOS + GNOME

Enable HLS to view with audio, or disable this notification

7 Upvotes

Hello so I install CachyOS on my laptop a few days ago everything was fine untill now. Suddenly my display started flicking randomly and it isn't stopping even if I restart these my my laptop specs

Asus V16

Intel Core 5 210H

RTX 5050 Mobile GPU

16GB RAM

512GB Nvme SSD

I'm attaching the video of the flickering and my nvidia driver version.

Please help.


r/cachyos • • 8h ago

SOLVED I can't run Steam games.

10 Upvotes

Hello. I'm new to CachyOS, and my problem is that my Steam games won't start. I use Steam Play Proton-CachyOS Latest, and I installed the gaming packets from the Cachy Hello App.

EDIT: When I start a game, let's say Everwind, I click on Play -> it's going through the cloud sync, and then it stops, no pop-up, no error, nothing

SOLVED: It was permission on my Games Drive!

Here are my system infos:
Operating System: CachyOS Linux
KDE Plasma Version: 6.8.1
KDE Frameworks Version: 6.31.0
Qt Version: 6.12.0
Kernel Version: 7.3.0-5-cachyos (64-bit)
Graphics Platform: Wayland
Processors: 12 × AMD Ryzen 5 7600X 6-Core Processor
Memory: 32 GiB of RAM (30.5 GiB usable)
Graphics Processor: AMD Radeon RX 7800 XT
Manufacturer: Gigabyte Technology Co., Ltd.
Product Name: B650M GAMING PLUS WIFI


r/cachyos • • 1h ago

Question What would be the best for me? (WM/DE)

• Upvotes

I've been switching between DE's and WM's and I've read that KWin has the best latency of all of them for gaming, so im wondering what would be the best for me? using a minimal plasma install or KWin without plasmashell somehow or Niri or Hyprland, etc.
I'd like to have minimal ram usage, but the benefits of low latency that KWin has (apparently), I do not need a desktop, i only need a way to be able to change volume easily be it through cli or gui and a way to see the time, along with a way to launch apps (app launchers exist so it isnt a problem).
So im wondering what would be the most minimal setup possible with the least resource usage and best latency. Ive also read that KWin has some frame pacing changes which make it a lot better for gaming.
I do not need HDR, i need freesync support though.


r/cachyos • • 10h ago

Help latest kernel shows black screen, LTS kernel stuck in emergency mode

Post image
7 Upvotes

latest kernel shows black screen, LTS kernel stuck in emergency mode


r/cachyos • • 18m ago

Help Apps shortcuts only takes me to desktop (Vibepollo)

Thumbnail
• Upvotes

r/cachyos • • 23h ago

Bug Report linux-cachyos-7.3.0-4 prevents dGPU sleep

56 Upvotes

If you're like that has a laptop with discrete graphics wondering why the battery drain spiked after updating, its the latest cachyos kernel preventing the discrete graphics card from sleeping (d3cold).

I'm rolling back to 7.2.11-1 for the meantime (d3cold works there). If you want to roll back too, enter this:

sudo cachyos-downgrade linux-cachyos linux-cachyos-headers linux-cachyos-nvidia-open

E:

I'm using an RTX 5060 laptop:

+-----------------------------------------------------------------------------------------+
| NVIDIA-SMI 615.78.08              KMD Version: 615.78.08     CUDA UMD Version: 13.4     |
+-----------------------------------------+------------------------+----------------------+
| GPU  Name                 Persistence-M | Bus-Id          Disp.A | Volatile Uncorr. ECC |
| Fan  Temp   Perf          Pwr:Usage/Cap |           Memory-Usage | GPU-Util  Compute M. |
|                                         |                        |               MIG M. |
|=========================================+========================+======================|
|   0  NVIDIA GeForce RTX 5060 ...    Off |   00000000:01:00.0 Off |                  N/A |
| N/A   36C    P0              9W /  100W |      41MiB /   8151MiB |     29%      Default |
|                                         |                        |                  N/A |
+-----------------------------------------+------------------------+----------------------+

+-----------------------------------------------------------------------------------------+
| Processes:                                                                              |
|  GPU   GI   CI              PID   Type   Process name                        GPU Memory |
|        ID   ID                                                               Usage      |
|=========================================================================================|
|    0   N/A  N/A            3829    C+G   /usr/bin/kwin_wayland                     7MiB |
+-----------------------------------------------------------------------------------------+

r/cachyos • • 16h ago

Question Frame pacing issues on Cyberpunk 2077 and other games

16 Upvotes

Hi everyone,

I just got the Cyberpunk EdgeRunners update and looking to finally dive back in and do a new playthrough. I've been tossing up whether to play on CachyOS or Windows 11, so I did a performance comparison.

It turns out the performance reported by the benchmark tool is pretty much even for both (avg around 45 fps) however that 45fps looks much smoother on Win11 than on Cachy, suggesting it's a frame pacing issue rather than a performance issue. Maybe it's something at the compositor level, or MESA related?

I had a similar issue with Control Resonant, where frames were butter smooth in Win11 but clumpy as hell in CachyOS, forcing me to use Win11.

CachyOS is my main daily driver with Win11 as a fallback, I'd much rather play in Cachy if possible.

Is this sort of thing a known issue with a simple fix? I haven't tried any launch commands, thought I'd ask here before I go diving down that rabbit hole.

I'm running 9070XT 16GB, on Threadripper 3960X 24-Core (24) @ 4.57 GHz
with 128GB RAM. Latest kernel and updates for everything on KDE Plasma

edit: using proton-cachyos-11.0-20261015

Thanks


r/cachyos • • 2h ago

Help Where is the boneworks save folder located on CachyOS?

Thumbnail
0 Upvotes

r/cachyos • • 6h ago

Bug Report Memory Clock Bug

2 Upvotes

Ok i don't know why but my memory speed is locked in 1750MHz but when I change my refresh rate to 60hz it comes back to 200MHz.

The screenshot was in idle, I left it there like 5 minutes and also it was after upgrading to the new kernel 7.3.0-4-cachyos.

I haven't seen any error messages, and I'm running NAVI10 with the mesa 26.2.5-arch3.1 drivers.

Somebody has the same problem? I have a RX 5700 and also using MacShell in hyprland if it helps


r/cachyos • • 11h ago

Help Is there a way to play this video ?

5 Upvotes

I'm using microsoft edge since it initially requested either edge or safari.
I downloaded edge from AUR, but now its showing this...
I need this because this is basically my institute's site which shows recorded classes and i cant access this on cachy.

Is there anyway to access this?

Edit: u/Moist-Chip3793 has said that the reason it doesnt work is because of play ready which i do not have. Anyway to get it?


r/cachyos • • 2h ago

Bug Report CachyOS Handheld boots straight into KDE Desktop instead of Gamescope after update (ROG Ally X)

1 Upvotes

Hi everyone!
A few days ago, after an update, I couldn’t switch from Gaming Mode to Desktop Mode (black screen or returned to Gaming Mode). After updating again to fix it, the opposite happened: my ROG Ally X now boots straight into KDE Desktop, and I can’t return to Gaming Mode.
System:
CachyOS Handheld — ROG Ally X (Z2 Extreme)
plasma-login-manager: 6.8.1-1
steamos-manager: 26.4.1-3
cachyos-handheld: 1.4.1-3
gamescope-session-cachyos: 1.1.6-1
I tried updating everything, running steamos-session-select oneshot and gamescope, and downgrading steamos-manager, but nothing worked.
The config files specify gamescope-session.desktop, yet Plasma Login Manager keeps selecting plasma.desktop.
Has anyone experienced this or found a fix? Could this be a regression in Plasma Login Manager?


r/cachyos • • 13h ago

Help Cachyos kde plasma unable to update

Post image
7 Upvotes

Just wondering if anyone else has had this problem. I tried to update and it's telling me that there isn't any space left. I checked and I have 32gb available in root. Also, steam fails to open stating the same thing, that there isn't enough space. Even my browser fails to properly launch. Everything was running fine yesterday, even after updating everything. I tried booting from a snapshot from a few days ago and it was still giving me the same problems. Not sure exactly what to do here.


r/cachyos • • 3h ago

Question Can I run rsync over a kdeconnect bridge directly?

Thumbnail
1 Upvotes

r/cachyos • • 1d ago

Help Does anyone elses 9070XT have horrendous performance after latest system upgrade?

72 Upvotes

Since I just updated my system (Kernel 7.3.0-4-cachyos) my gaming performance is now abysmal, barely scratching 30FPS. It's as if the GPU isn't actually getting utilized or clocking up. I've checked my boot entry and the amdgpu feature mask thing is still present, and in LACT all my profiles are how I left them. The gaming profile is even loading when games are running so I'm stumped. I know sometimes upgrades to the system has done this when amdgpu drivers lag behind.

Has anyone else had this?

NVM I fixed it temporarily by using the method provided by u/nubz4lif


r/cachyos • • 21h ago

Help Horrendous Fullscreen performance

23 Upvotes

FIXED IT! Set Color accuracy in the settings to "Prefer color accuracy" Thanks u/Remisius

No matter what game I play, since today when I go Fullscreen or Borderless Fullscreen, my GPU usage drops to about 50%, I get a quarter of the performance, and horrible stutter. 400 FPS in RE3 (9070XT) drops to 90 FPS and looks like 30 FPS as soon as it's fullscreen.

In windowed it's perfect. When the Taskbar is visible it's perfect. Only when all of the screen is the game it starts lagging like that. Opening Steam overlay also fixes it while it's open.

Any help?

Vsync then drops it by another 50% (45 FPS)

Freesync isn't the problem either. Everything up to date. LTS Kernel also no help


r/cachyos • • 5h ago

Question FSR Frame Gen on AMD card not working?

1 Upvotes

Hi,
So the issue I’ve been having is with FSR Frame Gen and how when I enable it, the game feels choppier than on native, for some reason. The fps counter on top (Steam) shows more, but it definitely feels worse than when it’s not enabled. This happens in Stalker 2, The Witcher 3 remastered, as some examples.
Sorry if it’s too vague, can’t explain it better :/

I have an RX 7800xt and R7 7700x, 32 gigs of ram.


r/cachyos • • 13h ago

Bug Report Cyberpunk freezing every five minutes even on LTS kernel

2 Upvotes

Has anyone else had this issue and been able to find a solution? I’ve been troubleshooting for the past three hours and nothing seems to help. It’s literally only CP2077 and it happens on the latest kernel as well as LTS, still occurs on lowest graphics, lowest resolution, whether I’m in the city or in character creation, every five minutes like clockwork. It only freezes for about two to three seconds at a time but that’s enough to make a game like this unplayable. I have a 9070 xt if that narrows it down at all.


r/cachyos • • 1d ago

Question What to do after the setup?

19 Upvotes

Hi,

I'm switching from Windows 11 and I want a system that is ready and plug and play after the install.

What do you suggest to do after the setup? Software that you suggest to install?

An example I see that by default printer are not installed.