Install or upgrade Cloud Storage FUSE

This page describes how to install Cloud Storage FUSE using prebuilt Linux binaries or the latest source code, and how to upgrade to the latest version of Cloud Storage FUSE. For information on which frameworks, operating systems, and architectures Cloud Storage FUSE supports, see Frameworks, operating systems, and architectures.

Install Cloud Storage FUSE by using prebuilt Linux binaries

To install or upgrade Cloud Storage FUSE by using prebuilt Linux libraries, complete the following instructions.

Configure package manager

Ubuntu/Debian

If your distribution supports the signed-by option, complete the following instructions:

  1. Install the required packages:

    sudo apt-get update
sudo apt-get install -y curl lsb-release

  2. Add the Cloud Storage FUSE distribution URL as a package source:

    export GCSFUSE_REPO=gcsfuse-`lsb_release -c -s`
echo "deb [signed-by=/usr/share/keyrings/cloud.google.asc] https://packages.cloud.google.com/apt $GCSFUSE_REPO main" | sudo tee /etc/apt/sources.list.d/gcsfuse.list

  3. Import the Google Cloud public key:

    curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo tee /usr/share/keyrings/cloud.google.asc

If your distribution is outdated and doesn't support the signed-by option, complete the following instructions:

  1. Add the Cloud Storage FUSE distribution URL as a package source:

    export GCSFUSE_REPO=gcsfuse-`lsb_release -c -s`
echo "deb https://packages.cloud.google.com/apt $GCSFUSE_REPO main" | sudo tee /etc/apt/sources.list.d/gcsfuse.list

  2. Import the Google Cloud public key:

    curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -

CentOS/Red Hat/Rocky Linux

If you're using the CentOS, Red Hat, or Rocky Linux operating system, complete the following instructions:

  1. Configure the Cloud Storage FUSE repository and its associated public key:

    sudo tee /etc/yum.repos.d/gcsfuse.repo > /dev/null <<EOF
[gcsfuse]
name=gcsfuse (packages.cloud.google.com)
baseurl=https://packages.cloud.google.com/yum/repos/gcsfuse-el7-x86_64
enabled=1
gpgcheck=1
repo_gpgcheck=0
gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg
      https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
EOF

  2. If you haven't yet, install FUSE by using the YUM Linux package manager:

    sudo yum install fuse

SUSE Linux

If you're using the SUSE Linux operating system, complete the following instructions:

  1. Configure the Cloud Storage FUSE repository and its associated public key:

    sudo tee /etc/zypp/repos.d/gcsfuse.repo > /dev/null <<EOF
[gcsfuse]
name=gcsfuse (packages.cloud.google.com)
baseurl=https://packages.cloud.google.com/yum/repos/gcsfuse-el7-x86_64
enabled=1
gpgcheck=1
repo_gpgcheck=0
gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg
      https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
EOF

  2. If you haven't yet, install FUSE by using the ZYPPER Linux package manager:

    sudo zypper install fuse

Install or upgrade Cloud Storage FUSE

Ubuntu/Debian

Update the list of available packages and install Cloud Storage FUSE:

sudo apt-get update
sudo apt-get install gcsfuse

CentOS/Red Hat/Rocky Linux

If you're using the CentOS, Red Hat, or Rocky Linux operating system, complete the following instructions:

Install Cloud Storage FUSE:

sudo yum install gcsfuse

Be sure to answer "yes" to any questions about adding the GPG signing key.

SUSE Linux

If you're using the SUSE Linux operating system, complete the following instructions:

Install Cloud Storage FUSE:

sudo zypper install gcsfuse

Be sure to answer "yes" to any questions about adding the GPG signing key.

Alternatively, you can download the latest prebuilt package of Cloud Storage FUSE directly from GitHub.

To upgrade to the latest version of Cloud Storage FUSE using prebuilt Linux binaries, use the following instructions:

Ubuntu/Debian

If you're using the Ubuntu or Debian Linux operating system, use the following instructions to upgrade to the latest version of Cloud Storage FUSE:

sudo apt-get update
sudo apt-get install --only-upgrade gcsfuse

CentOS/Red Hat/Rocky Linux

If you're using the CentOS, Red Hat, or Rocky Linux operating system, use the following instructions to upgrade to the latest version of Cloud Storage FUSE:

sudo apt-get update
sudo yum -y upgrade gcsfuse

SUSE Linux

If you're using the SUSE Linux operating system, use the following instructions to upgrade to the latest version of Cloud Storage FUSE:

sudo zypper refresh
sudo zypper -n update gcsfuse

Install or upgrade Cloud Storage FUSE by building the latest source code

To install or upgrade Cloud Storage FUSE by building the latest source code from GitHub, complete the following instructions:

  1. If you haven't yet, install fuse, git, and go (see go.mod for the latest version of go).

  2. Install Cloud Storage FUSE by using the go install command:

    go install github.com/googlecloudplatform/gcsfuse/v3@master

    If successful, a binary named gcsfuse is installed to $GOPATH/bin. GOPATH is an environment variable that's used to find the root of your go workspace.

Alternatively, you can also install Cloud Storage FUSE by cloning the git repository to your local file system:

  1. Clone the Cloud Storage FUSE repository:

    git clone https://github.com/GoogleCloudPlatform/gcsfuse.git

  2. Switch your current working directory to the gcsfuse folder containing the Cloud Storage FUSE repository:

    cd gcsfuse

  3. Install Cloud Storage FUSE by using the go install command:

    go install .

    If successful, a binary named gcsfuse is installed to $GOPATH/bin.

To upgrade to the latest version of Cloud Storage FUSE using source code, re-run the install instructions.

What's next

Learn how to mount buckets using Cloud Storage FUSE.