From c039fd1dd81727577e2cde47b7bf501894ae2089 Mon Sep 17 00:00:00 2001
From: DecDuck <declanahofmeyr@gmail.com>
Date: Thu, 26 Dec 2024 13:17:47 +1100
Subject: [PATCH] feat(troubleshooting): add note about prop nvidia drivers on
 linux

---
 docs/.vitepress/config.mts            | 47 ++++++++++++++-------------
 docs/guides/client-troubleshooting.md |  8 +++++
 2 files changed, 32 insertions(+), 23 deletions(-)
 create mode 100644 docs/guides/client-troubleshooting.md

diff --git a/docs/.vitepress/config.mts b/docs/.vitepress/config.mts
index 0934a34..1e1e0ab 100644
--- a/docs/.vitepress/config.mts
+++ b/docs/.vitepress/config.mts
@@ -1,56 +1,57 @@
-import { defineConfig } from 'vitepress'
+import { defineConfig } from "vitepress";
 
 // https://vitepress.dev/reference/site-config
 export default defineConfig({
   title: "Drop",
-  description: "Drop is an open-source, self-hosted game distribution platform. Like Steam!",
-  head: [['link', { rel: 'icon', href: '/drop.svg' }]],
+  description:
+    "Drop is an open-source, self-hosted game distribution platform. Like Steam!",
+  head: [["link", { rel: "icon", href: "/drop.svg" }]],
   themeConfig: {
     logo: "/drop.svg",
 
     // https://vitepress.dev/reference/default-theme-config
     nav: [
-      { text: 'Home', link: '/' },
-      { text: 'GitHub', link: 'https://github.com/Drop-OSS' }
+      { text: "Home", link: "/" },
+      { text: "GitHub", link: "https://github.com/Drop-OSS" },
     ],
 
     sidebar: [
       { text: "What is Drop?", link: "/about" },
       {
-        text: 'Admin Guides',
+        text: "Admin Guides",
         items: [
-          { text: 'Quickstart', link: '/guides/quickstart' },
+          { text: "Quickstart", link: "/guides/quickstart" },
           { text: "Exposing your instance", link: "/guides/exposing" },
-          { text: "Create your admin account", link: "/guides/create-admin-account" }
-        ]
+          {
+            text: "Create your admin account",
+            link: "/guides/create-admin-account",
+          },
+        ],
       },
       {
-        text: 'User Guides',
+        text: "User Guides",
         items: [
-          { text: "Getting started with Drop", link: "/guides/client" }
-        ]
+          { text: "Getting started with Drop", link: "/guides/client" },
+          { text: "Troubleshooting", link: "/guides/client-troubleshooting" },
+        ],
       },
       {
         text: "Metadata",
-        items: [
-          { text: "GiantBomb", link: "/metadata/giantbomb" }
-        ]
+        items: [{ text: "GiantBomb", link: "/metadata/giantbomb" }],
       },
       {
         text: "Documentation",
-        items: [
-          { text: "Library", link: "/docs/library" }
-        ]
-      }
+        items: [{ text: "Library", link: "/docs/library" }],
+      },
     ],
 
     socialLinks: [
-      { icon: 'github', link: 'https://github.com/Drop-OSS' },
-      { icon: 'discord', link: "https://discord.gg/NHx46XKJWA" }
+      { icon: "github", link: "https://github.com/Drop-OSS" },
+      { icon: "discord", link: "https://discord.gg/NHx46XKJWA" },
     ],
 
     outline: {
       level: [2, 3],
     },
-  }
-})
+  },
+});
diff --git a/docs/guides/client-troubleshooting.md b/docs/guides/client-troubleshooting.md
new file mode 100644
index 0000000..b1acc95
--- /dev/null
+++ b/docs/guides/client-troubleshooting.md
@@ -0,0 +1,8 @@
+# Troubleshooting
+
+## I'm on Linux, with Nvidia proprietary drivers, and Drop won't launch
+Add `WEBKIT_DISABLE_DMABUF_RENDERER=1` to the Drop .desktop file:
+
+1. Open `/usr/share/applications/Drop\ Desktop\ Client.desktop` with your preferred editor
+2. Add `WEBKIT_DISABLE_DMABUF_RENDERER=1` before `drop-app` on the `Exec=drop-app` line
+