Unofficial CachyOS image for PS5. Flash it, boot it, play.
Credit: based on the official ps5-linux CachyOS image and its kernel patches. All credit for the base image, kernel patches, Wi-Fi driver, pairing import and first-boot setup goes to the ps5-linux project. PS5 Pro Bluetooth: QuartConz/ps5-pro-viola-bluetooth, WizGery/ps5-mediatek-fixes, and MastaG (port, PS5 OS address, testing). Report problems with this build here, not to them.
New in this release
- Kernel 7.3.5 with ps5-linux-patches
c8fe83a(was 7.3.4 +1472828): wired Ethernet VLAN fix, and PS5 Slim HDMI options (all off by default) - PS5 Pro internal Bluetooth works (adapter, DualSense, pairing). Tested on two PS5 Pros
- 75 Hz and more modes on monitors whose EDID has no max TMDS clock (e.g. 1080p 75 Hz monitors)
- HDR in Gaming Mode on the PS5 Fat and Pro (FLAVA3 HDMI chip), set up automatically on the first boot. Quick menu → Performance → Enable HDR. The PS5 Slim keeps sRGB
- Refresh rate and resolution in Steam (Settings → Display), live and remembered per screen; games see the real refresh rate. Replaces the "Gaming Mode Refresh Rate" icon
- No more Steam "update" on every switch between Gaming Mode and the desktop, and a performance overlay in Gaming Mode (Steam menu → Performance)
- Faster "Processing Vulkan shaders": Steam uses all 16 CPU threads
- A picture instead of console text while switching between Gaming Mode and the desktop
- Faster DualSense reconnects (Bluetooth fast connectable)
- Pairings from PS5 OS: with a loader that exports them (ps5-linux-loader newer than v2.5), controllers paired in PS5 OS work in Linux without pairing again
- Two PS5 Linux drives plugged in at once: the first boot gives this drive's boot partition its own ID, so it never mounts the other drive's one
- PS5 Pro first boot no longer loses the kernel (issue #5)
- "Update PS5 CachyOS" also updates system packages and Flatpaks, and keeps going if the kernel step fails
- All packages updated (KDE Plasma 6.8.3, Frameworks 6.32, Mesa 26.3)
Display
- 1080p, 1440p up to 144 Hz and 4K at 60 Hz. 4K at 120 Hz needs an HDMI 2.1 TV (untested)
- FreeSync / VRR, 1080p and 1440p without black screens (DP link lock)
- HDR on the desktop: off by default, turn it on in System Settings → Display. HDR at 4K needs Colour resolution set to 12 bits (the "12-bit Colour" desktop icon)
- HDR and 12-bit colour need the FLAVA3 HDMI chip (PS5 Fat and Pro); the PS5 Slim (VERDE) gets 8-bit RGB without HDR. Check yours with
sudo dmesg | grep "HDMI IC" - Tip: if you use desktop scaling above 100%, set System Settings → Display → Legacy Applications (X11) to "Apply scaling themselves". Otherwise games like CS2 run at a lower resolution and look blurry
Gaming Mode
- SteamOS-style Steam interface on boot
- Refresh rate, resolution and HDR in Steam's own settings
- Display and network settings in Steam
- Switch to Desktop from Steam's power menu, and back with the "Return to Gaming Mode" desktop icon
- No Steam update check hang (system updates: the "Update PS5 CachyOS" icon)
Hardware support
- Bluetooth: DualSense reconnects automatically, also on the PS5 Pro
- Wi-Fi: NXP IW620 driver
6e87c85 - USB: boots from a USB SSD in a rear port or the front USB-C port
- Quiet fan curve from boot, plus a "SoC Temp" reading in the panel
System
- CachyOS packages on Arch Linux, KDE Plasma (the system reports itself as "Arch Linux", like the official image)
- zram swap (half the RAM, zstd)
- Chrome hardware video decode flags
- First-boot setup: timezone, password, hostname, and the partition grows to fill the drive
Flashing
- Windows / macOS: extract the
.img.xzto.imgfirst (7-Zip on Windows, double-click on macOS), then flash the.imgwith balenaEtcher. - Linux:
xzcat ps5-cachyos-7.3.5-pc8fe.img.xz | sudo dd of=/dev/sdX bs=4M status=progress conv=fsync
Check the download first: sha256sum ps5-cachyos-7.3.5-pc8fe.img.xz must match ps5-cachyos-7.3.5-pc8fe.img.xz.sha256.
Known issues
- Drive not found at boot ("waiting for device", then an emergency shell): push the USB cable all the way in and use a rear USB port. If your drive gets stuck when the PS5 hands over to Linux, unplug it and plug it back in while the boot waits, and the boot carries on by itself.
- After a warm restart (kexec): Wi-Fi can fail. A cold boot from the PS5 fixes it.
- PS5 Pro: after using the controller in PS5 OS, it sometimes only connects on its second try (about 30 s).
- Devices paired in both PS5 OS and Linux use the PS5 OS pairing when the loader exports pairings. If a keyboard or headset stops connecting in Linux, remove it in PS5 OS (Settings → Accessories) and pair it again in Linux.
- DualSense speaker and headphone jack only work over USB.
Tested on a PS5 Fat (FW 13.60) with soniciso1's ps5-linux-loader, this image on a USB drive, and the kernel on two PS5 Pros (FW 11.60).
Default login: steam / steam, and SSH is on (the official image's defaults). Change the password in the first-boot setup ("Customize").
Source: see KERNEL-SOURCE.md, the attached linux.patch and patches 0005–0007.