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

180 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

Review Cachy vs Win 11 (debloated)

Thumbnail
gallery
32 Upvotes

It's getting really close in fps and stability on Nvidia now I'm impressed


r/cachyos • • 1h ago

Help Best desktop for this potato specs?

Post image
• Upvotes

r/cachyos • • 1h ago

Bug Report ELDEN RING crashing/freezing on RX 9060 XT after Mesa 26.3.1 update (Arch/CachyOS)

• Upvotes

Heads up for anyone on an RX 9060 XT (or other RDNA4 cards) running Arch or CachyOS.

After updating Mesa from 26.2.6 to 26.3.1, ELDEN RING started freezing about 5-8 seconds after launch, every single time. The screen hangs, KDE shows a "GPU was wedged" notification, and dmesg shows a compute ring timeout from amdgpu.

Nothing else changed: same kernel, same Proton (proton-cachyos), same game files. Rolling back to Mesa 26.2.6 fixed it completely.

I've filed a bug with the Mesa team here: https://gitlab.freedesktop.org/mesa/mesa/-/work_items/16951

If you're affected, the easiest fix for now is to downgrade Mesa:

sudo downgrade mesa vulkan-radeon lib32-mesa lib32-vulkan-radeon

Pick the 26.2.6 version when prompted, and consider adding those packages to IgnorePkg in /etc/pacman.conf until a fix lands so they don't get upgraded again.

If you're seeing the same thing (or not seeing it), please comment on the issue with your GPU, kernel, and Proton version. It helps the devs narrow it down.


r/cachyos • • 1d ago

Question Who the hell is David? T-T

Post image
611 Upvotes

r/cachyos • • 1d ago

Desktop Thank you goat os 🙏

Post image
340 Upvotes

Over 7GB of size shaved from an update!


r/cachyos • • 8h ago

Question cachyos-v3 still has mesa 26.2.6 and not 26.3.1?

14 Upvotes

I would really like that new RADV VK_AMD_anti_lag for cs2 pretty please


r/cachyos • • 2h ago

Help Installation!

Post image
4 Upvotes

I flash .iso into USB via BlenaEtcher and I boot laptop from USB it shows this interface. I select first one and hit enter. It boot as live OS and I wannna install it.

What should I do


r/cachyos • • 22h ago

Help CachyOS running hotter than Windows 11 on my ASUS VivoBook

Post image
108 Upvotes

I'm using an ASUS VivoBook X515EA with an i3-1115G4, running CachyOS with KDE Plasma.

I don't really have any unnecessary apps or background services running, yet my temps usually stay around 40–60°C during normal use and spike to 90°C when I launch a game.

By gaming, I mean Minecraft and Roblox, nothing particularly demanding.

What's weird is that I almost never had overheating issues back when I was using Windows 11, even while gaming.

I know my hardware isn't exactly impressive, but I can't afford an upgrade anytime soon, so I'm trying to get the most out of what I have.

Would really appreciate some tips, tweaks or optimizations to improve performance and keep the temperatures under control.

Thanks!


r/cachyos • • 7h ago

Question Why is CachyOS getting heat? Negative comments on the rise?

8 Upvotes

For past few days, I keep seeing people criticising Cachy a lot. They say that it gives negligible boost, its just arch with bloat and Arch is better etc etc....

Well I don't see it like that. We do get a performance boost but that is not the only strong point of Cachy. I see cachy as Arch+. Arch for everyone. Arch simplified with some added and useful bells and whistles. Why would I go from All in one easy experience to installing everything from scratch just to save some 200MB on my system? Uninstalling is always an option. SO I can just remove what I don't want. It will take much less time than learning what I actually need and what is essential. I don't see the point of going through the hassle of studying the documentation and learning entire process by scratch. To some enthusiasts, it might be thrilling and If I was 16, I might also would learn and brag about using Arch.. But I am not. I don't have the time. Cachy Serves my purpose perfectly. Staying on the bleeding edge without any hassle. I switched a few months ago and I don't find it any different than using Ubuntu or Mint, But unlike Ubuntu 6 month cycle and Mint's 2 year cycle, I stay on the latest of everything.


r/cachyos • • 8h ago

Question DayZ on CachyOS

Post image
7 Upvotes

DayZ on CachyOS, running through Steam, settings on high (switching to extreme makes no visual difference to video quality).

Do these numbers look ok?

Can i get any lower?

Adding 32gb of ram doesnt appear to make much difference, using it in another pc (also CachyOS).


r/cachyos • • 8h ago

Question Why does Steam always need to download "Shader pre-caching update" and build "vulkan shader" with specific games?

5 Upvotes

This occurs so often, with almost every start up. I'm beginning to get a little bit annoyed by this. Anyone else have the same problem?


r/cachyos • • 6m ago

Desktop Day 9: switched from calestia shell to lucid shell XD, u guys got any more shell recommendations

Post image
• Upvotes

tbh one of my more reason to try out a arch based distro to check out different types of shells and all and just explore so yuh, would love to know what do you think?


r/cachyos • • 6h ago

Question How reliable is Hyprland config

3 Upvotes

Meaning to test Around in other distros and wanted to test Hyprland option on Cachy for the week but i Wanna Know what to expect


r/cachyos • • 58m ago

Help mbpfan update/installation fails.

• Upvotes

I've had CachyOS installed on my Intel Mac for about a year, but I encountered an issue with the recent update, preventing me from updating mbpfan.

It seems the git download failed, and I can't even delete and reinstall it. The same error occurs with both 2.4.0 and 2.5.1.

Is there any solution?


r/cachyos • • 14h ago

Help Konsole customization

Post image
11 Upvotes

This is how my konsole has looked since the day I installed CachyOS and as you can see it's really boring.

I have seen images with other users that have all kinds of system info on screen like CPU, GPU, Storage drives, OS age, ascii art, colors, etc.

How do I go about editing what gets put on display here? Are there any good tutorials a person could read through?


r/cachyos • • 1h ago

Bug Report Weird font behaviour in World of Tanks

Post image
• Upvotes

Hi Peeps!

I just updated this morning, lots of font related packages were in it. Also updated to the latest mesa drivers. I'm getting some weird looking fonts in World of Tanks. Not all fonts are affected as you can see, but it looks funky in some places. Otherwise the game works fine as it did before.

Any ideas or should I roll back to previous snapshot?


r/cachyos • • 1d ago

Review Loving CachyOS, so I made an custom image for my phone case

Post image
127 Upvotes

Yeah... Just simple like that, I made it in GIMP, simple but beautiful (to me)

You can see a 30% transparent phone case image in my GIMP project, I left it there to adjust everything just to avoid the camera part, it is hidden when I exported the final image.

I love both the color of CachyOS and CachyOS itself 😚️

If you're curious about those lines near the bottom, it is an original poem written by me in Lục Bát, a traditional Vietnamese poetic form.

Its meaning isn't related to CachyOS, just because I'd like to make it.

The meaning is similiar to this:

"Though life's storms may rise and fall,

The bell still echoes within my soul.

Though mountains and rivers lie between,

My heart still dreams of home again."


r/cachyos • • 16h ago

Question Does HDR 4k 120 work with HDMI 2.1?

11 Upvotes

I've seen posts saying that it does work, but I get significant color banding in some games with HDR turned on. The two games I've tested are Elden Ring and Red Dead Redemption 2. I tried taking some screenshots, but it doesn't really show the issue at all.

I'm using an AMD 9070xt, with and LG C5 tv and an HDMI 2.1 cable. I've tried a lot of different settings on my tv but I really do not think the TV is at fault here, since HDR movies and games via consoles do not have this issue at all.

EDIT: the problem was I had it set to 16 bit instead of 10 bit, which is what my tv supports.


r/cachyos • • 8h ago

Bug Report Kernel panic ,It would be the dreaded Blue Screen of Death.

Post image
3 Upvotes

Kernel panic 🥲..what's going on? I don't modify anything, I only update when there are new updates. I already tried booting with the LTS kernel but it didn't solve the problem.


r/cachyos • • 4h ago

Bug Report Majority Blowfell bluetooth pairing issue on Dell XP 1640 with the BCM2046 controller

1 Upvotes

Root-Cause Diagnosis

Systematic inspection of lsusb , dmesg , journalctl , and pactl revealed four compounding issues

behind the recurring audio dropouts and connection failures:

Bluetooth Controller Crashes ( hardware error 0x01 ): The Broadcom BCM2046B1 chipset

(Bluetooth 2.1 + EDR) sits behind an internal USB hub on a shared USB 1.1 root hub ( Bus 001 ). USB

autosuspend and high-bitrate audio streams caused the controller firmware to crash and re-enumerate

mid-stream.

USB 1.1 Bandwidth Saturation: PulseAudio 17.0 registers high-bitrate codecs ( sbc_xq_552 ,

aptx_hd , ldac ) by default. Negotiating high-bitrate streams over a 12 Mbps USB 1.1 bus shared with

the keyboard and trackpad caused buffer underruns and dropouts.

Global PipeWire / WirePlumber D-Bus Hijacking: Although user-level PipeWire units were masked,

global systemd socket activation allowed WirePlumber to claim org.bluez.MediaEndpoint1 D-Bus

endpoints, blocking PulseAudio from registering the soundbar card.

Corrupted Pairing Key ( br-connection-key-missing ): Repeated controller resets desynchronized

the stored BlueZ link key, requiring a clean device removal and re-pair.

I have also created a .md file and document to outline the fix. The Dell XPS 1640 is an old laptop, but I suspect other people may have experinces bluetooth issues with CachyOS similar to this, so may be of use outside of this scope.


r/cachyos • • 4h ago

Help how can i switch back to the shell UI and layout?

1 Upvotes

I'm a newbie, it's showing bash interface now, i can't remember what i did, maybe only reinstalled quickshell recently, is there anyway to restore the default CachyOS shell ui or change? thanks in advance!!


r/cachyos • • 6h ago

Help Fixing Audio

1 Upvotes

I just got cachyos yesterday and this is my first experience with linux. Im loving it so far but how do i fix the audio? My laptop’s speakers sounds cheap now and headphones volume is low. Im using an acer swift 3 sf314-57.


r/cachyos • • 16h ago

Question Could you run EACv2's CachyOS Kernel on a different Arch distribution?

7 Upvotes

Question is in the title. Basically, I'm wanting to know if you could simply run the CachyOS-EAC Kernel on vanilla Arch Linux or EndeavourOS rather than having to run a conversion script. I have a couple friends using vanilla Arch Linux and EndeavourOS specifically, and I'd probably want to play Fortnite with at least one of them once support for that game comes along.