Stay organized with collections Save and categorize content based on your preferences.
This document describes how to install Cloud Storage FUSE on your machine 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 binariesTo install or upgrade Cloud Storage FUSE by using prebuilt Linux libraries, complete the following instructions.
Configure package manager Ubuntu/DebianIf your distribution supports the signed-by option, complete the following instructions:
Install the required packages:
sudo apt-get update
sudo apt-get install -y curl lsb-release
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 -
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
If you're using the SUSE Linux operating system, complete the following instructions:
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
If you haven't yet, install FUSE by using the ZYPPER
Linux package manager:
sudo zypper install fuse
Update the list of available packages and install Cloud Storage FUSE:
CentOS/Red Hat/Rocky Linuxsudo apt-get update
sudo apt-get install gcsfuse
If you're using the CentOS, Red Hat, or Rocky Linux operating system, run the following commands:
Install Cloud Storage FUSE:
sudo yum install gcsfuse
Be sure to answer "yes" to any questions about adding the GPG signing key.
SUSE LinuxIf you're using the SUSE Linux operating system, run the following commands:
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/DebianIf you're using the Ubuntu or Debian Linux operating system, use the following commands to upgrade to the latest version of Cloud Storage FUSE:
CentOS/Red Hat/Rocky Linuxsudo apt-get update
sudo apt-get install --only-upgrade gcsfuse
If you're using the CentOS, Red Hat, or Rocky Linux operating system, use the following commands to upgrade to the latest version of Cloud Storage FUSE:
SUSE Linuxsudo apt-get update
sudo yum -y upgrade gcsfuse
If you're using the SUSE Linux operating system, use the following commands to upgrade to the latest version of Cloud Storage FUSE:
Install or upgrade Cloud Storage FUSE by building the latest source codesudo zypper refresh
sudo zypper -n update gcsfuse
To install or upgrade Cloud Storage FUSE by building the latest source code from GitHub, complete the following instructions:
If you haven't yet, install fuse
, git
, and go
(see go.mod for the latest version of go
).
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:
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
.
To upgrade to the latest version of Cloud Storage FUSE using source code, re-run the install instructions.
What's nextLearn how to mount buckets using Cloud Storage FUSE.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-10-08 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-10-08 UTC."],[],[]]
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.5