From f11b3f1af4280db5719a7cfdc187526e6b6cd6c5 Mon Sep 17 00:00:00 2001 From: Aaron Jacobs Date: Thu, 6 Aug 2015 11:32:56 +1000 Subject: [PATCH 1/2] Split Ubuntu and Debian sections. --- docs/installing.md | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/docs/installing.md b/docs/installing.md index 8ce0aa30c8..d5b1b2c228 100644 --- a/docs/installing.md +++ b/docs/installing.md @@ -14,7 +14,17 @@ pre-built binaries (i.e. you don't want to build from source), you need only ensure fuse is installed, then download and extract the latest release. The instructions slightly vary by distribution. -## Debian and Ubuntu +## Ubuntu + + sudo apt-get install wget fuse + sudo adduser $USER fuse + wget https://github.com/GoogleCloudPlatform/gcsfuse/releases/download/v0.6.0/gcsfuse_v0.6.0_linux_amd64.tar.gz + sudo tar -C /usr/local/bin -zxf gcsfuse_v0.6.0_linux_amd64.tar.gz + +You may need to log out and then log back in to make sure that the change to +the `fuse` group takes effect. + +## Debian sudo apt-get install wget fuse sudo adduser $USER fuse From b299bf7614bdd5d075a9b07094d11d040a2d54e0 Mon Sep 17 00:00:00 2001 From: Aaron Jacobs Date: Thu, 6 Aug 2015 11:36:49 +1000 Subject: [PATCH 2/2] Modernized the Debian section for Debian 8. --- docs/installing.md | 25 +++++++++++++++++-------- 1 file changed, 17 insertions(+), 8 deletions(-) diff --git a/docs/installing.md b/docs/installing.md index d5b1b2c228..510d540e83 100644 --- a/docs/installing.md +++ b/docs/installing.md @@ -14,6 +14,7 @@ pre-built binaries (i.e. you don't want to build from source), you need only ensure fuse is installed, then download and extract the latest release. The instructions slightly vary by distribution. + ## Ubuntu sudo apt-get install wget fuse @@ -24,20 +25,24 @@ instructions slightly vary by distribution. You may need to log out and then log back in to make sure that the change to the `fuse` group takes effect. + ## Debian sudo apt-get install wget fuse - sudo adduser $USER fuse wget https://github.com/GoogleCloudPlatform/gcsfuse/releases/download/v0.6.0/gcsfuse_v0.6.0_linux_amd64.tar.gz sudo tar -C /usr/local/bin -zxf gcsfuse_v0.6.0_linux_amd64.tar.gz -You may need to log out and then log back in to make sure that the change to -the `fuse` group takes effect. +### Old versions of Debian + +On versions older than Debian 8, it is additionally necessary to add yourself +to the [`fuse` group][fuse-group]: -On old versions of Debian, including the one in the Google Compute Engine image -`debian-7` as of 20.6.07-20, `/dev/fuse` has incorrect permissions (cf. -[this][stackexchange] StackExchange answer). Fix this with the following -commands: + sudo adduser $USER fuse + +You may need to log out and then log back in to make sure that the change to +the group takes effect. Finally, on these old versions of Debian, there is a +bug causing `/dev/fuse` to have incorrect permissions (cf. [this][debian-bug] +StackExchange answer). Fix this with the following commands: ``` sudo chmod g+rw /dev/fuse @@ -47,7 +52,9 @@ sudo chgrp fuse /dev/fuse Note that the operating system appears to periodically lose these changes, so you may need to run the workaround above repeatedly. -[stackexchange]: http://superuser.com/a/800016/429161 +[fuse-group]: https://wiki.debian.org/SystemGroups +[debian-bug]: http://superuser.com/a/800016/429161 + ## CentOS and Red Hat @@ -55,6 +62,7 @@ you may need to run the workaround above repeatedly. wget https://github.com/GoogleCloudPlatform/gcsfuse/releases/download/v0.6.0/gcsfuse_v0.6.0_linux_amd64.tar.gz sudo tar -C /usr/local/bin -zxf gcsfuse_v0.6.0_linux_amd64.tar.gz + ## SUSE sudo zypper install wget fuse @@ -62,6 +70,7 @@ you may need to run the workaround above repeatedly. sudo tar -C /usr/local/bin -zxf gcsfuse_v0.6.0_linux_amd64.tar.gz + # OS X If you already have the [Homebrew package manager][homebrew] installed, you can