Install ossfs 1.0 on Linux - OSS - Object Storage Service

Prerequisites

The FUSE version on your Linux system must be 2.8.4 or later.

Note

Run fusermount -V to check your FUSE version (e.g., fusermount version: 2.9.2). Upgrade to 2.8.4 or later if needed.

Install from a software package

Download links

Download the package for your operating system. If your OS is not listed, install ossfs from the source code.

System architecture	Operating system	System version	Software package	URL
x86_64	Ubuntu	Ubuntu 24.04	ossfs_1.91.10_ubuntu24.04_amd64.deb	https://gosspublic.alicdn.com/ossfs/ossfs_1.91.10_ubuntu24.04_amd64.deb
		Ubuntu 22.04	ossfs_1.91.10_ubuntu22.04_amd64.deb	https://gosspublic.alicdn.com/ossfs/ossfs_1.91.10_ubuntu22.04_amd64.deb
		Ubuntu 20.04	ossfs_1.91.10_ubuntu20.04_amd64.deb	https://gosspublic.alicdn.com/ossfs/ossfs_1.91.10_ubuntu20.04_amd64.deb
	Rocky Linux	Rocky Linux 9	ossfs_1.91.10_rockylinux9_x86_64.rpm	https://gosspublic.alicdn.com/ossfs/ossfs_1.91.10_rockylinux9_x86_64.rpm
	CentOS	CentOS 8.0	ossfs_1.91.10_centos8.0_x86_64.rpm	https://gosspublic.alicdn.com/ossfs/ossfs_1.91.10_centos8.0_x86_64.rpm
	CentOS	CentOS 7.0	ossfs_1.91.10_centos7.0_x86_64.rpm	https://gosspublic.alicdn.com/ossfs/ossfs_1.91.10_centos7.0_x86_64.rpm
	Alibaba Cloud Linux	Alibaba Cloud Linux 4	ossfs_1.91.10_alinux4_x86_64.rpm	https://gosspublic.alicdn.com/ossfs/ossfs_1.91.10_alinux4_x86_64.rpm
		Anolis 8/Alibaba Cloud Linux 3	ossfs_1.91.10_alinux3_x86_64.rpm	https://gosspublic.alicdn.com/ossfs/ossfs_1.91.10_alinux3_x86_64.rpm
		Anolis 7/Alibaba Cloud Linux 2	ossfs_1.91.10_alinux2_x86_64.rpm	https://gosspublic.alicdn.com/ossfs/ossfs_1.91.10_alinux2_x86_64.rpm
aarch64	Alibaba Cloud Linux	Alibaba Cloud Linux 3	ossfs_1.91.10_alinux3_aarch64.rpm	https://gosspublic.alicdn.com/ossfs/ossfs_1.91.10_alinux3_aarch64.rpm

Installation procedure

Install ossfs.

Copy the package URL for your OS and run the commands below.

Ubuntu

Example for Ubuntu 22.04 (x64):

sudo wget https://gosspublic.alicdn.com/ossfs/ossfs_1.91.10_ubuntu22.04_amd64.deb
sudo apt-get update
sudo apt-get install gdebi-core
sudo gdebi ossfs_1.91.10_ubuntu22.04_amd64.deb

CentOS, Anolis, or Alibaba Cloud Linux

Example for CentOS 7.0 (x64):

sudo wget https://gosspublic.alicdn.com/ossfs/ossfs_1.91.10_centos7.0_x86_64.rpm
sudo yum install ossfs_1.91.10_centos7.0_x86_64.rpm

If yum cannot download dependencies due to network restrictions, download them on a network-accessible node with the same OS. Example for downloading the fuse package:

sudo yum install --downloadonly --downloaddir=./ fuse

Important

Replace fuse with the target package name to download other dependencies.

Rocky Linux

Example for Rocky Linux 9 (x64):

sudo wget https://gosspublic.alicdn.com/ossfs/ossfs_1.91.10_rockylinux9_x86_64.rpm
sudo dnf install ossfs_1.91.10_rockylinux9_x86_64.rpm

Add a mime.types file. ossfs reads /etc/mime.types to set the Content-Type header based on file extensions.
Without mime.types, ossfs defaults all uploads to application/octet-stream.

Install the package for your OS:
Ubuntu

Run the following command:
```
sudo apt-get install mime-support
```
CentOS, Anolis, or Alibaba Cloud Linux

Run the following command:
```
sudo yum install mailcap
```
Rocky Linux

Run the following command:
```
sudo dnf install mailcap
```

Run ossfs --version to verify the installation:

[root@xxx ~]# ossfs --version
Alibaba Cloud Open Storage Service File System V1.91.10 (commit:95e3f05) with OpenSSL
Copyright (C) 2010 Randy Rizun &lt;rrizun@gmail.com&gt;
License GPL2: GNU GPL version 2 &lt;https://gnu.org/licenses/gpl.html&gt;
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.

Install from the source code

Important

Unlisted operating systems require manual dependency installation (e.g., fuse-devel) and are not recommended.

Install build dependencies.

Ubuntu

On Ubuntu:

sudo apt-get update
sudo apt-get install automake autotools-dev g++ git libcurl4-gnutls-dev libfuse-dev libssl-dev libxml2-dev make pkg-config

CentOS, Anolis, or Alibaba Cloud Linux

On CentOS:

sudo yum makecache
sudo yum install automake gcc-c++ git libcurl-devel libxml2-devel fuse-devel make openssl-devel

CentOS Stream

Install the EPEL repository and enable the CRB repository:

sudo dnf install -y epel-release
sudo dnf config-manager --set-enabled crb

Install the dependency libraries:

sudo dnf makecache
sudo dnf install -y automake gcc-c++ git libcurl-devel libxml2-devel fuse-devel make openssl-devel

Rocky Linux

Note

Applies to Rocky Linux 9.5 and later. On 9.4 and earlier, libcurl-devel requires an OpenSSL version incompatible with the system default, and upgrading may break SSH.

Install the dependency libraries:

sudo dnf config-manager --set-enabled crb
sudo dnf makecache
sudo dnf install -y automake gcc-c++ git libcurl-devel libxml2-devel fuse-devel make openssl-devel

Download, compile, and install ossfs from GitHub:

git clone -b main-v1 https://github.com/aliyun/ossfs.git
cd ossfs
./autogen.sh
./configure
make
sudo make install

Run ossfs --version to verify. A successful install displays version information like Alibaba Cloud Open Storage Service File System V1.91.x.

What to do next

Configure ossfs 1.0 to mount OSS buckets.