diff --git a/docs/docs/.vitepress/config.ts b/docs/docs/.vitepress/config.ts
index 2286c7c0b..bc2b77fca 100644
--- a/docs/docs/.vitepress/config.ts
+++ b/docs/docs/.vitepress/config.ts
@@ -7,6 +7,7 @@ export default defineConfig({
     description: "Documentation and help for Ente's products",
     head: [["link", { rel: "icon", type: "image/png", href: "/favicon.png" }]],
     cleanUrls: true,
+    ignoreDeadLinks: 'localhostLinks',
     themeConfig: {
         // We use the default theme (with some CSS color overrides). This
         // themeConfig block can be used to further customize the default theme.
diff --git a/docs/docs/.vitepress/sidebar.ts b/docs/docs/.vitepress/sidebar.ts
index 683432ba2..d6547e810 100644
--- a/docs/docs/.vitepress/sidebar.ts
+++ b/docs/docs/.vitepress/sidebar.ts
@@ -89,6 +89,15 @@ export const sidebar = [
                     },
                 ],
             },
+            {
+                text: "Troubleshooting",
+                items: [
+                    {
+                        text: "Yarn",
+                        link: "/self-hosting/troubleshooting/yarn",
+                    },
+                ],
+            },
         ],
     },
     {
diff --git a/docs/docs/self-hosting/troubleshooting/yarn.md b/docs/docs/self-hosting/troubleshooting/yarn.md
new file mode 100644
index 000000000..d117d9c3c
--- /dev/null
+++ b/docs/docs/self-hosting/troubleshooting/yarn.md
@@ -0,0 +1,10 @@
+---
+title: Yarn errors
+description: Fixing yarn install errors when trying to self host Ente
+---
+
+# Yarn
+
+If your `yarn install` is failing, make sure you are using Yarn Classic
+
+* https://classic.yarnpkg.com/lang/en/docs/install