fuse.md: Added troubleshooting instructions for #813
Marcin Rataj committed
Apr 6, 2015 at 22:49 UTC
729e50d312563c64bcd7a395abd739ed5dccbdac
1 file changed
+23
-1
docs/fuse.md
+23
-1
@@ -44,7 +44,29 @@ sudo chown <username>:<groupname> /etc/fuse.conf
44
45
## Troubleshooting
46
47
-If the mount command crashes and your mountpoint gets stuck:
47
+### Getting `Permission denied` or `fusermount: user has no write access to mountpoint` error
48
+
49
+Verify that the config file can be read by your user:
50
+```sh
51
+ls -l /etc/fuse.conf
52
+-rw-r----- 1 root fuse 216 Jan 2 2013 /etc/fuse.conf
53
+```
54
+In most distributions group named `fuse` will be created during installation.
55
+
56
+If that is the case, just add your regular user to the `fuse` group:
57
+```sh
58
+usermod -G fuse -a <username>
59
+```
60
+
61
+If not, create `fuse` group (add your regular user to it) and set necessary permissions, for example:
62
+```sh
63
+sudo chgrp fuse /etc/fuse.conf
64
+sudo chmod g+r /etc/fuse.conf
65
+sudo chgrp fuse /ipfs /ipns
66
+sudo chmod g+rw /ipfs /ipns
67
+```
68
+
69
+### Mount command crashes and mountpoint gets stuck
70
71
```
72
sudo umount /ipfs