Stay organized with collectionsSave and categorize content based on your preferences.
This page describes how to installCloud Storage FUSEusing 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, seeFrameworks, 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:
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:
sudoapt-getupdatesudoyum-yupgradegcsfuse
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:
sudozypperrefreshsudozypper-nupdategcsfuse
Install or upgrade Cloud Storage FUSE by building the latest source code
To install or upgrade Cloud Storage FUSE by building thelatest source code from GitHub, complete the following instructions:
If you haven't yet, installfuse,git, andgo(seego.modfor the latest version ofgo).
Install Cloud Storage FUSE by using thego installcommand:
[[["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-09-04 UTC."],[],[],null,["# Install or upgrade Cloud Storage FUSE\n\nThis page describes how to install [Cloud Storage FUSE](/storage/docs/gcs-fuse) using prebuilt Linux\nbinaries or the latest source code, and how to upgrade to the latest version\nof Cloud Storage FUSE. For information on which frameworks, operating systems, and\narchitectures Cloud Storage FUSE supports, see\n[Frameworks, operating systems, and architectures](/storage/docs/cloud-storage-fuse/overview#frameworks-os-architectures).\n\nInstall Cloud Storage FUSE by using prebuilt Linux binaries\n-----------------------------------------------------------\n\nTo install or upgrade Cloud Storage FUSE by using prebuilt Linux libraries, complete\nthe following instructions.\n\n### Configure package manager\n\n### Ubuntu/Debian\n\nIf your distribution supports the signed-by option, complete the following\ninstructions:\n\n1. Add the Cloud Storage FUSE distribution URL as a package source:\n\n export GCSFUSE_REPO=gcsfuse-`lsb_release -c -s`\n 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\n\n2. Import the Google Cloud public key:\n\n curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo tee /usr/share/keyrings/cloud.google.asc\n\nIf your distribution is outdated and doesn't support the signed-by option,\ncomplete the following instructions:\n\n1. Add the Cloud Storage FUSE distribution URL as a package source:\n\n export GCSFUSE_REPO=gcsfuse-`lsb_release -c -s`\n echo \"deb https://packages.cloud.google.com/apt $GCSFUSE_REPO main\" | sudo tee /etc/apt/sources.list.d/gcsfuse.list\n\n2. Import the Google Cloud public key:\n\n curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -\n\n### CentOS/Red Hat/Rocky Linux\n\nIf you're using the CentOS, Red Hat, or Rocky Linux operating system,\ncomplete the following instructions:\n\n1. Configure the Cloud Storage FUSE repository and its associated public key:\n\n sudo tee /etc/yum.repos.d/gcsfuse.repo \u003e /dev/null \u003c\u003cEOF\n [gcsfuse]\n name=gcsfuse (packages.cloud.google.com)\n baseurl=https://packages.cloud.google.com/yum/repos/gcsfuse-el7-x86_64\n enabled=1\n gpgcheck=1\n repo_gpgcheck=0\n gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg\n https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg\n EOF\n\n2. If you haven't yet, install [FUSE](https://github.com/libfuse/libfuse) by using the\n [`YUM` Linux package manager](https://www.redhat.com/sysadmin/how-manage-packages):\n\n sudo yum install fuse\n\n### SUSE Linux\n\nIf you're using the SUSE Linux operating system, complete the\nfollowing instructions:\n\n1. Configure the Cloud Storage FUSE repository and its associated public key:\n\n sudo tee /etc/zypp/repos.d/gcsfuse.repo \u003e /dev/null \u003c\u003cEOF\n [gcsfuse]\n name=gcsfuse (packages.cloud.google.com)\n baseurl=https://packages.cloud.google.com/yum/repos/gcsfuse-el7-x86_64\n enabled=1\n gpgcheck=1\n repo_gpgcheck=0\n gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg\n https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg\n EOF\n\n2. If you haven't yet, install [FUSE](https://github.com/libfuse/libfuse) by using the\n [`ZYPPER` Linux package manager](https://documentation.suse.com/smart/systems-management/html/concept-zypper/index.html):\n\n sudo zypper install fuse\n\n### Install or upgrade Cloud Storage FUSE\n\n### Ubuntu/Debian\n\nUpdate the list of available packages and install Cloud Storage FUSE: \n\n sudo apt-get update\n sudo apt-get install gcsfuse\n\n### CentOS/Red Hat/Rocky Linux\n\nIf you're using the CentOS, Red Hat, or Rocky Linux operating system,\ncomplete the following instructions:\n\nInstall Cloud Storage FUSE: \n\n sudo yum install gcsfuse\n\nBe sure to answer \"yes\" to any questions about adding the GPG signing key.\n\n### SUSE Linux\n\nIf you're using the SUSE Linux operating system, complete the\nfollowing instructions:\n\nInstall Cloud Storage FUSE: \n\n sudo zypper install gcsfuse\n\nBe sure to answer \"yes\" to any questions about adding the GPG signing key.\n\nAlternatively, you can download the latest prebuilt package of\nCloud Storage FUSE directly from [GitHub](https://github.com/GoogleCloudPlatform/gcsfuse/releases).\n\nTo upgrade to the latest version of Cloud Storage FUSE using prebuilt Linux binaries,\nuse the following instructions: \n\n### Ubuntu/Debian\n\nIf you're using the Ubuntu or Debian Linux operating system, use the\nfollowing instructions to upgrade to the latest version of Cloud Storage FUSE: \n\n sudo apt-get update\n sudo apt-get install --only-upgrade gcsfuse\n\n### CentOS/Red Hat/Rocky Linux\n\nIf you're using the CentOS, Red Hat, or Rocky Linux operating system,\nuse the following instructions to upgrade to the latest version of\nCloud Storage FUSE: \n\n sudo apt-get update\n sudo yum -y upgrade gcsfuse\n\n### SUSE Linux\n\nIf you're using the SUSE Linux operating system,\nuse the following instructions to upgrade to the latest version of\nCloud Storage FUSE: \n\n sudo zypper refresh\n sudo zypper -n update gcsfuse\n\nInstall or upgrade Cloud Storage FUSE by building the latest source code\n------------------------------------------------------------------------\n\nTo install or upgrade Cloud Storage FUSE by building the\n[latest source code from GitHub](https://github.com/GoogleCloudPlatform/gcsfuse/tree/master), complete the following instructions:\n\n1. If you haven't yet, install `fuse`, `git`, and `go` (see\n [go.mod](https://github.com/GoogleCloudPlatform/gcsfuse/blob/master/go.mod) for the latest version of `go`).\n\n2. Install Cloud Storage FUSE by using the `go install` command:\n\n go install github.com/googlecloudplatform/gcsfuse/v3@master\n\n If successful, a binary named `gcsfuse` is installed to `$GOPATH/bin`.\n `GOPATH` is an environment variable that's used to find the root of your `go`\n workspace.\n\nAlternatively, you can also install Cloud Storage FUSE by cloning the git\nrepository to your local file system:\n\n1. Clone the Cloud Storage FUSE repository:\n\n git clone https://github.com/GoogleCloudPlatform/gcsfuse.git\n\n2. Switch your current working directory to the `gcsfuse` folder containing the\n Cloud Storage FUSE repository:\n\n cd gcsfuse\n\n3. Install Cloud Storage FUSE by using the `go install` command:\n\n go install .\n\n If successful, a binary named `gcsfuse` is installed to `$GOPATH/bin`.\n\nTo upgrade to the latest version of Cloud Storage FUSE using source code, re-run\nthe [install instructions](#install-source-code).\n\nWhat's next\n-----------\n\nLearn how to [mount buckets using Cloud Storage FUSE](/storage/docs/gcsfuse-mount)."]]
