All Products
Search

This Product

    Object Storage Service:Install ossfs 1.0

    Document Center

    Object Storage Service:Install ossfs 1.0

    Last Updated:Jan 20, 2026

    This topic describes how to install ossfs 1.0.

    Prerequisites

    Ensure that the FUSE version on your Linux system is 2.8.4 or later.

    Note

    Run the fusermount -V command to check your FUSE version. If the output shows a version of 2.8.4 or later, such as fusermount version: 2.9.2, your system meets the requirement. Otherwise, you must upgrade FUSE to 2.8.4 or later.

    Install from a software package

    Download links

    The following table lists the software packages for common operating systems. If your operating system is not listed, you can install ossfs from the source code.

    Linux distribution

    Software package

    URL

    Ubuntu 24.04 (x64)

    ossfs_1.91.9_ubuntu24.04_amd64.deb

    https://gosspublic.alicdn.com/ossfs/ossfs_1.91.9_ubuntu24.04_amd64.deb

    Ubuntu 22.04 (x64)

    ossfs_1.91.9_ubuntu22.04_amd64.deb

    https://gosspublic.alicdn.com/ossfs/ossfs_1.91.9_ubuntu22.04_amd64.deb

    Ubuntu 20.04 (x64)

    ossfs_1.91.9_ubuntu20.04_amd64.deb

    https://gosspublic.alicdn.com/ossfs/ossfs_1.91.9_ubuntu20.04_amd64.deb

    Rocky Linux 9 (x64)

    ossfs_1.91.9_rockylinux9_x86_64.rpm

    https://gosspublic.alicdn.com/ossfs/ossfs_1.91.9_rockylinux9_x86_64.rpm

    CentOS 8.0 (x64)

    ossfs_1.91.9_centos8.0_x86_64.rpm

    https://gosspublic.alicdn.com/ossfs/ossfs_1.91.9_centos8.0_x86_64.rpm

    CentOS 7.0 (x64)

    ossfs_1.91.9_centos7.0_x86_64.rpm

    https://gosspublic.alicdn.com/ossfs/ossfs_1.91.9_centos7.0_x86_64.rpm

    Anolis 9/Alibaba Cloud Linux 4

    ossfs_1.91.9_alinux4_x86_64.rpm

    https://gosspublic.alicdn.com/ossfs/ossfs_1.91.9_alinux4_x86_64.rpm

    Anolis 8/Alibaba Cloud Linux 3

    ossfs_1.91.9_alinux3_x86_64.rpm

    https://gosspublic.alicdn.com/ossfs/ossfs_1.91.9_alinux3_x86_64.rpm

    Anolis 7/Alibaba Cloud Linux 2

    ossfs_1.91.9_alinux2_x86_64.rpm

    https://gosspublic.alicdn.com/ossfs/ossfs_1.91.9_alinux2_x86_64.rpm

    Installation procedure

    1. Install ossfs.

      Copy the package URL for your operating system and follow the corresponding installation instructions.

      Ubuntu

      For example, on Ubuntu 22.04 (x64), run the following commands to install ossfs.

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

      CentOS, Anolis, or Alibaba Cloud Linux

      To install on CentOS 7.0 (x64), run the following command.

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

      If your client uses yum to install RPM packages but cannot download dependency packages due to network restrictions, you can download the dependencies on a separate node. The separate node must have network access and run the same operating system. Then, you can copy the packages to the restricted node. For example, ossfs requires FUSE 2.8.4 or later. To download only the latest fuse package from the yum repository to the current directory, run the following command.

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

      To download other dependency packages, replace fuse with the name of the required package.

      Rocky Linux

      For example, on Rocky Linux 9 (x64), run the following commands to install ossfs.

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

    2. Add a mime.types file. ossfs uses the entries in /etc/mime.types to determine the Content-Type of an uploaded file. Adding this file ensures that the Content-Type header matches the file name extension.

      If you do not add the mime.types file, ossfs sets the Content-Type of all uploaded files to application/octet-stream by default.

      Run the command for your operating system to add the mime.types file.

      Ubuntu

      Run the following command to add the mime.types file.

      sudo apt-get install mime-support

      CentOS, Anolis, or Alibaba Cloud Linux

      Run the following command to add the mime.types file.

      sudo yum install mailcap

      Rocky Linux

      Run the following command to add the mime.types file.

      sudo dnf install mailcap

    3. Run the ossfs --version command to check the ossfs version. If the output is similar to the following, ossfs is installed.

      0043a9ac017f6f648b16d7af7dde8fa5

    Install from the source code

    Important

    For operating systems not listed in this topic, you must manually install dependencies such as fuse-devel. We do not recommend using ossfs on other operating systems.

    1. Install the compilation dependencies.

      Ubuntu

      For example, on Ubuntu, run the following commands to install the required dependency libraries.

      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

      For example, on CentOS, run the following commands to install the required dependency libraries.

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

      CentOS Stream

      1. Run the following commands to install the EPEL repository and enable the CRB repository.

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

      2. Run the following commands to install the required 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

      This procedure applies to Rocky Linux 9.5 and later. For Rocky Linux 9.4 and earlier, installing from the source code is not recommended because the libcurl-devel package requires a version of OpenSSL that is incompatible with the default version. Upgrading the OpenSSL dependency may disrupt SSH connections to the machine.

      Run the following commands to install the required 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

    2. Run the following command to download, compile, and install the source code from GitHub.

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

    3. Run the ossfs --version command to check the ossfs version. If the output is similar to the following, ossfs is installed.

      0043a9ac017f6f648b16d7af7dde8fa5

    What to do next

    After you install ossfs 1.0, you must configure it to mount OSS buckets. For more information, see Configure ossfs 1.0.