From 729e50d312563c64bcd7a395abd739ed5dccbdac Mon Sep 17 00:00:00 2001
From: Marcin Rataj <lidel@lidel.org>
Date: Mon, 6 Apr 2015 22:49:47 +0200
Subject: [PATCH] fuse.md: Added troubleshooting instructions for #813

---
 docs/fuse.md | 24 +++++++++++++++++++++++-
 1 file changed, 23 insertions(+), 1 deletion(-)

diff --git a/docs/fuse.md b/docs/fuse.md
index c6ffcbd85..8c2b4c920 100644
--- a/docs/fuse.md
+++ b/docs/fuse.md
@@ -44,7 +44,29 @@ sudo chown <username>:<groupname> /etc/fuse.conf
 
 ## Troubleshooting
 
-If the mount command crashes and your mountpoint gets stuck:
+### Getting `Permission denied` or `fusermount: user has no write access to mountpoint` error
+
+Verify that the config file can be read by your user:
+```sh
+ls -l /etc/fuse.conf
+-rw-r----- 1 root fuse 216 Jan  2  2013 /etc/fuse.conf
+```
+In most distributions group named `fuse` will be created during installation.
+
+If that is the case, just add your regular user to the `fuse` group:
+```sh
+usermod -G fuse -a <username>
+```
+
+If not, create `fuse` group (add your regular user to it) and set necessary permissions, for example:
+```sh
+sudo chgrp fuse /etc/fuse.conf
+sudo chmod g+r  /etc/fuse.conf
+sudo chgrp fuse /ipfs /ipns
+sudo chmod g+rw /ipfs /ipns
+```
+
+### Mount command crashes and mountpoint gets stuck
 
 ```
 sudo umount /ipfs
-- 
GitLab