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

176 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 Thought I got GNOME'd for a second after an update. Turns out it was just a theme change in shelly.

Post image
64 Upvotes

Changed it back to GTK and it is back to normal. IDK what to put as a flair. Also, what is with the recent news about Cachy dropping Shelly? Can someone educate me about it?

Edit: Come to think of it, we need a humor tag.


r/cachyos • • 10h ago

Question HDR Gaming Woes - advice needed

Post image
52 Upvotes

I installed CachyOS last week after spending some mixed time with Nobara this year, and have been pleasantly surprised by how much things just worked without much friction.

That is until I tried to play Control Resonant, which is the game I have happily been playing on Windows for a couple of weeks without any issues. I have a Ryzen 5800x3d and an RX 9070.

Ray traced performance in Control seems much, much worse on CachyOS than on Windows, but that's not as annoying as trying to get HDR to work without making sacrifices.

Here are the main players:

  1. I have an Alienware AW2725DF OLED panel which looks incredible when gaming in HDR on my PC and Switch 2. Control Resonant in particular looks fantastic.
  2. I also have a Steam controller, which I love using. I've even got it working on my Switch 2.
  3. Finally, I use a Stream deck mini for controlling my gaming room lights, audio inputs, shortcuts for recording videos or taking screenshots, and buttons for opening apps. (I've not finished setting it all up yet on Cachy, hence the blank spaces).

The issue is that it seems like HDR gaming on CachyOS, using Proton-CachyOS or Proton-GE, means I can only pick 2 of the 3.

It I don't use any proton commands, I can use my Steam controller and Stream deck exactly as I do on windows. Ray Traced performance is about 15-20fps lower, and HDR doesn't work (the option is greyed out) so I can't take advantage of my OLED panel, but the hardware works and the game runs.

If I enable HDR using the proton_enable_Wayland=1 command, I can't use my steam controller at all (the button inputs are wrong, the keyboard button prompts are shown), and I lose the steam overlay, steam menu and quick settings. I guess that's just how Wayland works, but it's literally unplayable with my controller. At least HDR works now.

I was initially very pleased when I tried using Gamescope, because I get HDR and full Steam controller support. Then I realised I can't use my Stream deck or alt-tab if I need to. It essentially becomes a console, which means I can game fine (just not at the max performance of my hardware), but have to reboot every time I want to game or use my PC as a PC. Very limiting.

Any advice is welcome as I've spent a few hours on this to get to this point.

I like my general CachyOS experience, but things like this actively stop me from gaming, and instead waste my time troubleshooting something that just works on Windows.


r/cachyos • • 22h ago

Desktop Safe to update?

Post image
238 Upvotes

Bit scared guys XD


r/cachyos • • 21m ago

Question How to update everything using cachy-update?

2 Upvotes

Okay so generally I run cachy-update on a weekly basis. I generally do not pay attention to whats being updated (do read the arch news of it's available).

Today I opened Antigravity CLI for some work and noticed that it was not updated. I had installed antigravity CLI using the curl command available on their website.

I thought it automatically got updated via cachy-update? I had to run agy update to update it.

So my 1st question is - how to make sure that cachy-update actually updates everything?

I asked AI for a solution and it suggested me to add a source in full_upgrade.sh file present in /usr/share/arch-update/lib

# Update Antigravity CLI
main_msg "Antigravity CLI update"

# Ensure the default Antigravity CLI binary location is available
export PATH="${HOME}/.local/bin:${PATH}"

if command -v agy > /dev/null 2>&1; then
    info_msg "Checking for Antigravity CLI updates..."

    if agy update; then
        info_msg "Antigravity CLI update completed"
    else
        warning_msg "Antigravity CLI update failed"
    fi
else
    warning_msg "Antigravity CLI (agy) not found. Skipping update."
fi

I know for a fact that if I modify anything in /usr it will get overridden on a next update.

My 2nd question is - is it possible to implement this such that the above code runs after every cachy-update and doesn't gets overridden after an update?

And my last question is - how to find other things which are being left un-updated by cachy-update?

I know about topgrade (I used it on my fedora) but I want to explore inbuilt solutions. I am fairly new to code side of linux and I am trying to understand what a code do - that's why I don't want to use a readymade solution like topgrade.


r/cachyos • • 22h ago Regret

Desktop Shelly 3.3.0 now looks broken

Thumbnail
imgur.com
84 Upvotes

r/cachyos • • 16h ago

Question is there any way to play microsoft store games

30 Upvotes

I have many games on microsoft store but I'm using linux so is there any way to play them?


r/cachyos • • 7h ago

Bug Report Shelly 3.3 update has no window decorations on right side.

Post image
5 Upvotes

As shown the buttons are blank. Using default Breeze Dark theme. Only shelly is broken.


r/cachyos • • 1d ago

Desktop I'm in love with CachyOS, so I want to share my Desktop! ❤️

Post image
188 Upvotes

Do you want to share yours too? I'd love to see what you're doing and find some inspiration.

Also, I wanna add something. I'm using Linux for nearly 15 years. Never have I experienced such a stable distro. I work with CachyOS since months and never had any problems. I do play games like CP77 too. Works just perfectly.

Have a nice evening everyone! ❤️


r/cachyos • • 18h ago

Desktop Sleek and snappy : My daily Cachy 💻

Thumbnail
gallery
21 Upvotes

r/cachyos • • 2h ago

Help Need Help Improving Gaming Performance and Reducing Temperatures

0 Upvotes

Hey everyone!

I'm looking for some help optimizing gaming performance and reducing CPU/GPU temperatures on CachyOS.

I'm currently using CachyOS on my laptop, and although everything is working well, I'm having some difficulties getting the same gaming performance and temperatures I had on Windows.

One example is Dark Souls 3. On Windows, the game ran at a stable 60 FPS without making my laptop run excessively hot. I'd like to achieve the same experience on Linux, maintaining 60 FPS while keeping temperatures as low as possible.

I'm not necessarily looking for overclocking or extreme performance tweaks. I just want to get the most out of my hardware without overheating my laptop.

My laptop specifications:

  • Laptop: Dell Inspiron 15 7000 Gaming
  • CPU: Intel Core i7-7700HQ (4 cores / 8 threads)
  • GPU: NVIDIA GeForce GTX 1050 Ti (4 GB VRAM)
  • RAM: 16 GB DDR4 (2x8 GB)
  • Operating System: CachyOS (Arch Linux-based)
  • Laptop cooling: Stock cooling system

r/cachyos • • 2h ago

Help Why is it doing this

Post image
0 Upvotes

Today when I booted my pc after the boot selector screen this showed up before sddm it satyed for like 5-7 sec before going to sddm

Wm- Niri

Shell- Serpantinum


r/cachyos • • 6h ago

Question Linux woes (multimonitor + audio over HDMI/USB Speakers)

Thumbnail reddit.com
2 Upvotes

r/cachyos • • 15h ago

Desktop Lenovo Chromebook 2nd Gen 😎

Thumbnail
gallery
9 Upvotes

CachyOS on my Lenovo Chromebook 2nd Gen


r/cachyos • • 4h ago

Bug Report KDE Plasma fails to power off after gaming and laptop stays on until battery drains

0 Upvotes

Hi everyone,

I've been experiencing a recurring shutdown issue and it's getting increasingly frustrating. The issue seems to happen after extended gaming sessions through heroic, usually around 3-4 hours. After finishing a game, I initiate shutdown through KDE. The graphical session terminates and the screen switches to a blank console, but the laptop never actually powers off.

I noticed it at times, so i just press the power button again, and it sent me to the login screen where i have to shut it down manually again. But this time, after finishing my gaming session, I shut down the laptop as usual and left it unattended, assuming it had powered off.

About two hours later, I realized the laptop was still powered on. It had apparently failed to complete the shutdown again, and eventually the battery drained rather than the machine shutting down properly.

Here's my rig specs :

Here's the pasted sudo journalctl -b -1 --no-pager, and though there are lots of nvidia-powerd errors, atp i couldn't care less for those other than this frustrating bug :

https://paste.centos.org/view/5371e382

I've been looking for related reports, but this is the only thing i've found and it's related to KDE :

https://bugs.kde.org/show_bug.cgi?id=528771

Please i really need some help to get through this. Thank you in advance. Before you're asking, yes, i'll post it to r/kde as well


r/cachyos • • 4h ago

Help Pc stuck in emergency mode

1 Upvotes

I run a dualboot with windows 11 and cachyOS (Limine), and for a while I havent used cachyOS much as ive been playing fortnite, yesterday I went back to using cachyOS to play steam games, and everything was alright. Today I boot my pc to find out whenever I boot onto CachyOS Im on emergency mode. Logs are huge, and sudo cachyos-bugreport.sh says "curl: (6) Could not resolve host: paste.cachyos.org". sudo pacman -Syu doesnt work either, Booting into LTS brings me to emergency mode too. I havent done any update from what I know. What do I do?


r/cachyos • • 7h ago

Help Adding Ente Auth Appimage

2 Upvotes

Do anyone know how to add Ente Auth TOTP app image github lin to the new CachyOs Package Installer and Shelly . https://github.com/ente/ente#ente-auth if i add https://github.com/ente/ente it just list ente photos not available as appimage error


r/cachyos • • 1d ago

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

Post image
154 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 • • 6h ago

Help Need help

1 Upvotes

I use cachyos and my fury fukiya headphones when i use bluetooth mode its like laid back qnd tge quality is bad


r/cachyos • • 13h ago

Bug Report File upload not working after the update

4 Upvotes

I recently updated cachyos. File upload is not working for me. It doesn't matter which website it is. I tried different browsers like chromium based browsers and Firefox. The issue is not with the browsers. File upload was working before but I haven't checked it in the last 5-6 days. But when I'm trying it now I just can't upload it anywhere. I'm not sure which update caused it or why this is happening. Can someone help with this. I have some work pending. Anyone experienced the same or im the only one facing this issue


r/cachyos • • 8h ago

Help CachyOS black screen.

1 Upvotes

Hi im thinkingn going back to cachyos for good this time. Last time what i did to get myself familiar with Linux, i installed cachy while stil having Windows AS a second system. After some testing i realised that cachy isn't 100% perfect based on my setup which is - laptop with hybrid intel/ dgpu nvidia rtx 5060 connected to an AVR with hdmi which is then connected to my TV. So here's where my problems started to show on cachy. I use it mainly for gaming/watching movies with my denon 5.2.4 audio system. So first problem was allways struggling to get the audio passthrough, but I managed it myself with propper mpv config. Second one is unresolvable, but I'm willing to sacrifice. Its league of legends...do inhave to say more? But the third problem i would ask you, is there a permament solution to a black screen on my TV that is happening when i change the source of video signal. For example i got xbox plugged into denon along with laptop l. So after i play some xbox and want to go back to my laptop the TV screen is black and i can't do shit because I'm turning off my laptop screen/make my TV screen as main and do a "display only on second monitor". So my question is - is there any 100% bulletproof solution to this black screen. As far as I red its some edid problem or dgpu nvidia losing connection with my TV while beeing idle for a while.


r/cachyos • • 1d ago

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

235 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 • • 10h ago

Desktop Auto-switching LG 39GX950B to Gamer 1 on game launch and back to sRGB on exit on Linux/Hyprland via DDC/CI

Thumbnail reddit.com
1 Upvotes