| title | Install BlobFuse |
|---|---|
| titleSuffix | Azure Storage |
| description | Install BlobFuse to mount an Azure Blob Storage container through the Linux file system. |
| author | normesta |
| ms.author | normesta |
| ms.service | azure-blob-storage |
| ms.topic | how-to |
| ms.date | 1/29/2026 |
| ms.custom | linux-related-content |
You can install BlobFuse from Microsoft repositories for Linux by using simple commands to install the BlobFuse package. If no package is available for your distribution and version, you can build the binary from source code.
First, check your Linux distribution and version by running the following command:
cat /etc/*-releaseTo determine if a package is available for your distribution and version, see BlobFuse releases.
If no package is available for your distribution or version, you need to build the binary from source code. For detailed instructions, see the Build the binaries from source code section of this article.
If a package is available for your Linux distribution and version, configure the Linux Package Repository for Microsoft Products. The following sections show example commands.
For Red Hat Enterprise Linux distributions, run the following commands.
sudo rpm -Uvh https://packages.microsoft.com/config/rhel/<version-number>/packages-microsoft-prod.rpm
sudo dnf update
sudo yum install fuse3 fuse3-libs blobfuse2Replace the <version-number> placeholder in this command with 8 or 7 depending on the version of your distribution.
For Ubuntu distributions, run the following commands.
sudo wget https://packages.microsoft.com/config/ubuntu/<version-number>/packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb
sudo apt-get update
sudo apt-get install fuse3 blobfuse2Replace the <version-number> placeholder with your Ubuntu version (for example: 20.04 or 22.04).
For SUSE Linux Enterprise (SLES) distributions, run the following commands.
sudo rpm -Uvh https://packages.microsoft.com/config/sles/15/packages-microsoft-prod.rpm
sudo zypper refresh
sudo zypper install fuse3 blobfuse2For Azure Linux distributions, run the following commands.
sudo tdnf install -y https://packages.microsoft.com/config/mariner/2.0/packages-microsoft-prod.rpm
sudo tdnf repolist --refresh
sudo tdnf install fuse fuse3 blobfuse2If no package is available for your distribution, you can build BlobFuse from source code. First, install Go 1.20.x or later. For installation instructions, see Go. Then, follow these steps to clone the repository and build the binaries.
Use the following commands to clone the BlobFuse repository:
git clone https://github.com/Azure/azure-storage-fuse/
cd azure-storage-fuse
git checkout -b main origin/mainNote
If Git isn't installed on your system, install it by running sudo apt-get install git (Ubuntu/Debian) or use the appropriate command for your distribution.
For Red Hat Enterprise Linux distributions, run the following command.
sudo yum install fuse3 fuse3-develFor Ubuntu distributions, run the following command.
sudo apt-get install fuse3 libfuse3-dev For SUSE Linux Enterprise (SLES) distributions, run the following command.
sudo zypper install fuse3 libfuse3-dev For Azure Linux distributions, run the following command.
sudo tdnf install fuse libfuse-dev fuse3 libfuse3-dev Run the build script located in the root folder of the repository.
For Red Hat Enterprise Linux distributions, run the following command.
./build.shFor Ubuntu distributions, run the following command.
./build.sh fuse2For SUSE Linux Enterprise (SLES) distributions, run the following command.
./build.shFor Azure Linux distributions, run the following command.
./build.shTo build the optional health monitor binary, run the following command:
./build.sh health