From e6d78e86ef0ae83da6a6bf576df1f767e288bdf1 Mon Sep 17 00:00:00 2001
From: karl <stjacques.k@gmail.com>
Date: Wed, 22 Apr 2026 22:02:01 -0400
Subject: [PATCH] docs: document fusermount3 limitation in WSL

Added troubleshooting section for fusermount3 errors in WSL.
---
 README.md | 29 +++++++++++++++++++++++++++++
 1 file changed, 29 insertions(+)

diff --git a/README.md b/README.md
index 86af3ba..a660e2f 100644
--- a/README.md
+++ b/README.md
@@ -113,3 +113,32 @@ fs:
   mountoptions: allow_other,nodev,nosuid
 ```
 5. Restart your mount.
+
+### fusermount3: mounting over filesystem ... is forbidden (WSL)
+
+If you see:
+
+```bash
+/usr/bin/fusermount3: mounting over filesystem type ... is forbidden
+mount failed: fusermount exited with code 256
+```
+
+This is a limitation of Windows Subsystem for Linux.
+
+Cause:
+* WSL restricts FUSE mounts on certain filesystem types
+* Most commonly happens when mounting into `/mnt/c`, `/mnt/d` (Windows drives)
+  
+Fix:
+Mount into a native Linux path instead:
+```bash
+mkdir -p ~/gitforgefs
+gitforgefs mount ~/gitforgefs
+```
+
+NOT:
+
+```bash
+# This will fail in WSL
+gitforgefs mount /mnt/c/somewhere
+```