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.
Install Cloud Storage FUSE by using prebuilt Linux binaries
To install 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:
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
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:
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
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:
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
If you haven't yet, install FUSE by using the
YUM
Linux package manager:sudo yum install fuse
Install 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.
Alternatively, you can download the latest prebuilt package of Cloud Storage FUSE directly from GitHub.
Install Cloud Storage FUSE by building the latest source code
To install Cloud Storage FUSE by building the latest source code from GitHub, complete the following instructions:
If you haven't yet, install
fuse
,git
, andgo
(see go.mod for the latest version ofgo
).Install Cloud Storage FUSE by using the
go install
command:go install github.com/googlecloudplatform/gcsfuse/v2@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 yourgo
workspace.
Alternatively, you can also install Cloud Storage FUSE by cloning the git repository to your local file system:
Clone the Cloud Storage FUSE repository:
git clone https://github.com/GoogleCloudPlatform/gcsfuse.git
Switch your current working directory to the
gcsfuse
folder containing the Cloud Storage FUSE repository:cd gcsfuse
Install Cloud Storage FUSE by using the
go install
command:go install .
If successful, a binary named
gcsfuse
is installed to$GOPATH/bin
.
Upgrade to the latest version of Cloud Storage FUSE
To get the latest features and performance improvements in Cloud Storage FUSE, make sure you're using the latest version of Cloud Storage FUSE. To upgrade to the latest version of Cloud Storage FUSE, 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
What's next
Learn how to mount buckets using Cloud Storage FUSE.