diff --git a/doc/known-issues.md b/doc/known-issues.md
index 2f93a2dc..a3d9e444 100644
--- a/doc/known-issues.md
+++ b/doc/known-issues.md
@@ -25,6 +25,14 @@ Windows does not have symlinks enabled, or Git is not configured to use them. Th
 
 This is a curl SSL CA issue, you may want to Google for proper solutions on your system. That said, you can `set CURL_INSECURE=true` and retry to disable SSL verification if you want to workaround the issue.
 
+## Linux: `Error: vkCreateInstance failed with VK_ERROR_INCOMPATIBLE_DRIVER`
+
+Some distros require packages to be installed to support the Vulkan graphics API.
+
+For instance, Arch Linux has [specific packages](https://wiki.archlinux.org/title/Vulkan#Installation) for Nvidia, Intel and AMD GPUs.
+
+You may also try using OpenGL using the env var `MACH_GPU_BACKEND=opengl`.
+
 ## Linux: `Error: Couldn't load Vulkan. Searched /tmp/mach/gpu/zig-out/bin/libvulkan.so.1`
 
 We're aware of a bug failing to find `libvulkan.so` on some Linux distros such as [Guix](https://guix.gnu.org/).