diff --git a/content/docs/distros/Asahi_Linux.md b/content/docs/distros/Asahi_Linux.md
index a3e4d59..f6be498 100644
--- a/content/docs/distros/Asahi_Linux.md
+++ b/content/docs/distros/Asahi_Linux.md
@@ -114,4 +114,14 @@ muvm -it -p 9757/udp -p 9757 -- ~/launch_wivrn.sh
 3. Start steam.
 4. etc.
 
+## Troubleshooting
+
+### VkPhysicalDevice does not support required extension VK_KHR_external_semaphore
+
+VK_KHR_external_semaphore support was re-enabled in `Mesa 25.1.0-asahi20250425`.
+Ensure that your mesa version is up-to-date, and is a revision that comes after this one.
+
+Aside: It sounds like the asahi fork of mesa will not be necessary, soon.
+However, switching to mainline [breaks virglrenderer](<https://github.com/chadmed/asahi-overlay/commit/34e50cc47c6a75ccd421b27f6ad5ded1dee4f402>) as of the time of writing.
+
 [vr-multiarch-build]: https://gitlab.com/lvra/vr-multiarch-build
\ No newline at end of file