From 6d37de6f6413911c23334fc42982e1603bb632a5 Mon Sep 17 00:00:00 2001
From: feeRnt <81442162+feeRnt@users.noreply.github.com>
Date: Sat, 14 Mar 2026 10:46:03 +0000
Subject: [PATCH] files: Add note about Mesa 25.1 & Kernel 5.4

Signed-off-by: feeRnt <81442162+feeRnt@users.noreply.github.com>
---
 docs/files.md | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/docs/files.md b/docs/files.md
index 788f409..80ca724 100644
--- a/docs/files.md
+++ b/docs/files.md
@@ -52,6 +52,11 @@ Also, you may want to read [this post](https://ps4linux.com/forums/d/93-tutorial
 :::
 ## Distros (that you ACTUALLY wanna use)
 Honestly there's a neptillion distros... If you're indecisive, click on all the links and check them out. Either way they are listed from most to least recommended.
+> [!DANGER]
+> If you have a Baikal console (many PS4 Pros are the Baikal variant) or are otherwise using the 5.4.x kernels, make sure your distro ships with Mesa version 25.1 or lower.
+> Newer versions are not supported on this Linux version, and so GPU acceleration will not work. See [this GitHub issue](https://github.com/feeRnt/ps4-linux-12xx/issues/8) or [this page to understand why](https://dionkill.github.io/ps4-linux-tutorial/baikal.html).
+>
+* [ ] TODO: Specify in the list below which distributions are known to be working correctly with Kernel 5.4 and Baikal models.
 
 ::: details More about these distros
 Each distro has it's own pros and cons. But most of the difference on PS4 comes down to drivers; each distro requires it's own version of them and it can be a pain in the ass to install.