Help Center/ Object Storage Service/ Tools Guide/ obsfs/ Environment Preparation/ Method 2: Generating obsfs by Compilation
Updated on 2026-07-29 GMT+08:00
View PDF
Share

Method 2: Generating obsfs by Compilation

obsfs is open source and available on GitHub. If your Linux distribution is not Ubuntu 16 or CentOS 7, or a similar version, you can compile the obsfs source code from GitHub. To do so, you need to configure the environment and execute the script.

Downloading the obsfs Source Code

Download the obsfs source code.

You can also run the following command on your Linux VM to download the obsfs source code:

git clone https://github.com/huaweicloud/huaweicloud-obs-obsfs.git

By compiling the obsfs source code, you can bypass Linux distribution version limitations.

Configuring the Compilation Environment

The compilation environment is used to compile the source code on the host where you will generate obsfs. The specific commands used depend on the Linux distribution.

  • Commands for CentOS 7, CentOS 8, Fedora 28, RHEL 7, and RHEL 8: 
    yum install -y gcc libstdc++-devel gcc-c++ fuse fuse-devel curl-devel libxml2-devel mailcap git automake make 
yum install -y openssl-devel
  • Commands for Ubuntu 14, Ubuntu 16, Ubuntu 18, and Debian 8: 
    apt-get install -y build-essential git libfuse-dev libcurl4-openssl-dev libxml2-dev mime-support automake libtool
apt-get install -y pkg-config libssl-dev
  • Command for SUSE 12 and openSUSE Leap 42.1: 
    zypper in -y automake curl-devel fuse fuse-devel gcc-c++ libxml2-devel make openssl-devel
  • obsfs supports libfuse 2.9.7, 2.9.8, and 2.9.9. If your system has a different libfuse version installed, remove it and install the correct version by referring to libfuse Installation Guide.
  • To check the libfuse version, use the system's built-in version query command or run the following command to locate libfuse.so: 
    find / -name libfuse.so*

Generating obsfs

After the compilation environment is configured successfully, run the cd command to go to the directory where obsfs was downloaded, and run the bash build.sh command to generate obsfs.

cd /path/to/huaweicloud-obs-obsfs && bash build.sh

Verification

Run the following command to check whether obsfs can run properly:

obsfs --version

If the obsfs version information is displayed in the command output, obsfs is running properly. You can initialize obsfs and then mount a parallel file system.

Parent topic: Environment Preparation