Usually, getting a true SteamOS experience on a PC involves installing a dedicated “distro” that wipes your drive or forces a console-only UI.
But with CachyOS, you can simply install the cachyos-handheld package on your existing desktop.
The problem? It tries to turn your multi-purpose desktop into a dedicated console by bypassing your login screen and launching Steam automatically. Here is how to get the features without the “hostile takeover” of your PC.
Note: This guide assumes you initially installed CachyOS as a standard desktop operating system (not the Handheld Edition) and are running it on a regular desktop PC, rather than a handheld gaming device.
The Prerequisites 🔗
Before you start, ensure your system is fully synced. Running a blind install often leads to 404 mirror errors if your databases are stale.
sudo pacman -Syu
sudo pacman -S cachyos-handheld
The “Desktop First” Configuration 🔗
When you install this package, it switches your display manager to plasmalogin and forces an autologin. To fix this, we need to poke a few configuration files.
1. Restoring the Login Screen 🔗
CachyOS Handheld uses Plasma Login Manager (PLM). It places override files in /etc/plasmalogin.conf.d/ that skip the password prompt.
To get your login screen back, comment out the lines in these two files by adding a # at the start:
# File 1: Force-disable the autologin trigger
sudo nano /etc/plasmalogin.conf.d/zz-steamos-autologin.conf
# File 2: Disable the 'deckify' defaults
sudo nano /etc/plasmalogin.conf.d/steam-deckify.conf
Your files should look like this:
#[Autologin]
#Relogin=true
#Session=plasma
#User=indra
2. Enable Persistent Sessions 🔗
You want the system to remember your last choice. If you reboot from the Desktop, you should land back on the Desktop. Run this command to stop the system from “forcing” Game Mode on every boot:
steamos-session-select persistent
3. Killing the Steam Autostart 🔗
Even on a desktop session, the handheld package insists on launching Steam. Since this is defined in a system-wide directory, we “mask” it for our specific user:
# Create your local autostart directory
mkdir -p ~/.config/autostart/
# Copy the system-wide entry and hide it
cp /etc/xdg/autostart/steam.desktop ~/.config/autostart/
echo "Hidden=true" >> ~/.config/autostart/steam.desktop
How to Switch Modes 🔗
The best part about the cachyos-handheld package is that it automatically creates a “Return to Gaming Mode” shortcut on your desktop.
- To Game: Double-click the “Return to Gaming Mode” icon. It will log you out and launch the Steam Deck UI.
- To Work: Use the Steam Power Menu > Switch to Desktop to return to your normal KDE Plasma environment.
Verification 🔗
Once you’ve rebooted, verify that:
- Login Screen: You are prompted for your password.
- Quiet Boot: Steam doesn’t pop up and steal focus immediately.
- FPS Sliders: When in “Gaming Mode,” the ”…” Quick Access Menu now shows the performance sliders (FPS limit, FSR, TDP) just like a Steam Deck.
Update (October 2026): Post-System Update Regressions & Fixes 🔗
Following the October 2026 system updates on CachyOS (sudo pacman -Syu), upstream changes to the cachyos-handheld scripts introduced several regressions that break this desktop setup. You might encounter three frustrating symptoms:
| Symptom | What Happened | Technical Cause |
|---|---|---|
| Autologin Loop & KWallet Prompt | Booting or logging out immediately triggers an autologin loop into gamescope or plasma; Google Chrome repeatedly prompts for a KWallet password. | Upstream package updates re-enabled [Autologin] with gamescope-session.desktop inside /etc/plasmalogin.conf.d/. Bypassing the login screen prevented PAM (pam_kwallet) from receiving user credentials to decrypt KWallet on login. |
| Desktop Shortcut Failure | Clicking Return to Gaming Mode fails with couldnt find program '/usr/bin/steamosctl' or D-Bus errors. | Upstream cachyos-handheld updated steamos-gamemode.desktop to call /usr/bin/steamosctl switch-to-game-mode instead of a generic logout. Standard desktop installations lack steamos-manager and the hardware-specific D-Bus interface (SessionManagement1) expected by the daemon. |
| “Switch to Desktop” Stuck | Selecting Switch to Desktop inside SteamOS Game Mode does nothing or crashes silently. | /usr/lib/steamos/steam-set-session hardcodes rewriting [Autologin] into zz-steamos-autologin.conf. If you locked the file with chattr +i, the script throws Operation not permitted and fails silently. |
Here is how to resolve them permanently:
1. Apply the Fish/Bash-Compatible Single-Block Fix 🔗
If you run fish shell (e.g., with the Tide prompt), Bash-style heredocs (<< 'EOF') fail syntax parsing. Run this single sudo sh -c block instead—it works reliably across Fish, Bash, and Zsh:
sudo sh -c '
echo "[1/4] Disabling steam-deckify autologin..."
[ -f /etc/plasmalogin.conf.d/steam-deckify.conf ] && sed -i "s/^[^#]/#&/" /etc/plasmalogin.conf.d/steam-deckify.conf
echo "[2/4] Disabling zz-steamos-autologin.conf..."
if [ -f /etc/plasmalogin.conf.d/zz-steamos-autologin.conf ]; then
chattr -i /etc/plasmalogin.conf.d/zz-steamos-autologin.conf 2>/dev/null || true
sed -i "s/^[^#]/#&/" /etc/plasmalogin.conf.d/zz-steamos-autologin.conf
fi
echo "[3/4] Ensuring steam-set-session remains patched..."
if [ -f /usr/lib/steamos/steam-set-session ]; then
grep -q "#\[Autologin\]" /usr/lib/steamos/steam-set-session || sed -i "s/^\[Autologin\]/#\[Autologin\]/" /usr/lib/steamos/steam-set-session
fi
echo "[4/4] Updating Return to Gaming Mode shortcut..."
SHORTCUT="/home/indra/Desktop/steamos-gamemode.desktop"
if [ -f "$SHORTCUT" ]; then
printf "[Desktop Entry]\nName=Return to Gaming Mode\nExec=sh -c \"steamos-session-select gamescope; qdbus6 org.kde.Shutdown /Shutdown org.kde.Shutdown.logout\"\nIcon=steamdeck-gaming-return\nTerminal=false\nType=Application\nStartupNotify=false\n" > "$SHORTCUT"
chown indra:indra "$SHORTCUT"
chmod +x "$SHORTCUT"
fi
echo "Done!"
'
Note: Replace
/home/indraandindra:indrawith your own username if different. Notice the desktop shortcut now runssteamos-session-select gamescoperight before triggering the KDE logout, ensuring Gamescope is cleanly queued up as the target session without needing autologin enabled.
2. Prevent Future Pacman Updates from Breaking It (Pacman Hook) 🔗
Every time cachyos-handheld, plasma-login-manager, or sddm updates via sudo pacman -Syu, upstream packages will reinstall their config overrides and re-enable autologin.
To make the fix survive future updates, create an ALPM post-transaction hook (also written using standard commands compatible with Fish):
sudo mkdir -p /etc/pacman.d/hooks
sudo sh -c 'cat > /etc/pacman.d/hooks/99-cachyos-handheld-fix.hook << "HOOKEOF"
[Trigger]
Operation = Upgrade
Operation = Install
Type = Package
Target = cachyos-handheld*
Target = plasma-login-manager*
Target = sddm*
[Action]
Description = Keeping CachyOS Handheld desktop-first (preventing autologin loop)...
When = PostTransaction
Exec = /usr/bin/bash -c "sed -i '\''s/^[^#]/#&/'\'' /etc/plasmalogin.conf.d/steam-deckify.conf 2>/dev/null || true; sed -i '\''s/^[^#]/#&/'\'' /etc/plasmalogin.conf.d/zz-steamos-autologin.conf 2>/dev/null || true; sed -i '\''s/^\[Autologin\]/#\[Autologin\]/'\'' /usr/lib/steamos/steam-set-session 2>/dev/null || true"
HOOKEOF'
3. Verification 🔗
Check that all autologin lines are commented out:
grep -rnEi "^\[Autologin\]|^Session=|^User=" /etc/plasmalogin.conf.d/
Verification: Output should return nothing.
- Login Prompt: Log out using your desktop shortcut. You will land cleanly on the login screen, allowing you to choose between Plasma and Gamescope.
- KWallet / Chrome: Entering your password at the login screen allows PAM (
pam_kwallet) to unlock KWallet automatically, preventing Chrome from asking for a wallet password on startup. - Game Mode Return: You can now double-click Return to Gaming Mode on your desktop, and it will set Gamescope and log out immediately. When inside SteamOS, opening the Power menu and clicking Switch to Desktop will hand control back to the login screen without getting stuck in Gamescope.