From 729e50d312563c64bcd7a395abd739ed5dccbdac Mon Sep 17 00:00:00 2001 From: Marcin Rataj Date: Mon, 6 Apr 2015 22:49:47 +0200 Subject: [PATCH 1/2] 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 : /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 +``` + +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 From 6903e631404520dadd9dbc10c334cd6294129930 Mon Sep 17 00:00:00 2001 From: Marcin Rataj Date: Mon, 6 Apr 2015 23:26:52 +0200 Subject: [PATCH 2/2] fuse.md: Linux-related clarifications --- docs/fuse.md | 17 ++++++++++++----- 1 file changed, 12 insertions(+), 5 deletions(-) diff --git a/docs/fuse.md b/docs/fuse.md index 8c2b4c920..07efe503d 100644 --- a/docs/fuse.md +++ b/docs/fuse.md @@ -44,18 +44,22 @@ sudo chown : /etc/fuse.conf ## Troubleshooting -### Getting `Permission denied` or `fusermount: user has no write access to mountpoint` error +### Getting `Permission denied` or `fusermount: user has no write access to mountpoint` error in Linux Verify that the config file can be read by your user: ```sh -ls -l /etc/fuse.conf +sudo 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. +In most distributions group named `fuse` will be created during installation. You can check with: -If that is the case, just add your regular user to the `fuse` group: ```sh -usermod -G fuse -a +sudo grep -q fuse /etc/group && echo fuse_group_present || echo fuse_group_missing +``` + +If group is present, just add your regular user to the `fuse` group: +```sh +sudo usermod -G fuse -a ``` If not, create `fuse` group (add your regular user to it) and set necessary permissions, for example: @@ -66,6 +70,9 @@ sudo chgrp fuse /ipfs /ipns sudo chmod g+rw /ipfs /ipns ``` +Note that the use of `fuse` group is optional and may depend on your operating system. +It is okay to use a different group as long as proper permissions are set for user running `ipfs mount` command. + ### Mount command crashes and mountpoint gets stuck ```