From 2d9b1ffba459ae7a1f387640205771dd996b3c87 Mon Sep 17 00:00:00 2001 From: Mikkel Gravgaard Date: Fri, 21 Oct 2022 16:38:09 +0200 Subject: [PATCH] doc: add FAQ details about how to install Vulkan on Linux (#591) * Add details about Vulkan support in Linux * doc: add note about how to use OpenGL backend Co-authored-by: Stephen Gutekanst --- doc/known-issues.md | 8 ++++++++ 1 file changed, 8 insertions(+) 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/).