Help Center > > Tools Guide> obsfs> Introduction to obsfs

Introduction to obsfs

Updated at: Jul 06, 2021 GMT+08:00

obsfs, built on the basis of Filesystem in Userspace (FUSE), is a file system tool provided by Object Storage Service (OBS) for mounting OBS parallel file systems to Linux operating systems. It enables you to easily access the infinite storage space on OBS in the same way as you operate the local file system.

If you are used to storing data in local file systems and do not want to change the way of data accessing even though data is stored in OBS, obsfs is recommended.


  • Supports the mounting of parallel file systems to your local file system on the Linux OS, so that you can use your local file system to manage objects stored on OBS.
  • Supports synchronous upload. Any file uploaded to the mounted directory can be synchronously uploaded to OBS.
  • Supports synchronizing objects from a parallel file system to its mounted directory in the local file system, so that you can copy, modify, rename, and truncate objects locally.


  • The local directory to which the parallel file system is mounted needs not to be empty. But its original files will be unavailable after the parallel file system is mounted. They are recovered when the parallel file system is unmounted. Therefore, it is recommended that you use an empty directory as the target directory for mounting a parallel file system.
  • obsfs supports mounting of parallel file systems but not OBS buckets.
  • The parallel file system mounted to the local system cannot provide the same performance and functions as the local file system.
    • Files or folders in the mounted directory do not support hard link commands.
    • The number of directory levels cannot exceed 45.

Applicable Operating Systems

obsfs is applicable to Linux operating systems. It can be directly downloaded, or you can compile to generate one. For details, see Table 1.

Table 1 Obtaining obsfs



Applicable Linux OS

Operation Guide


Download the official software package, configure the runtime environment in the Linux OS, and then obsfs can be used.

Ubuntu 16 and CentOS 7

Method 1: Downloading and Installing obsfs


Download the source code from GitHub, configure the compilation environment, execute the script in the source code, and then obsfs can be generated.

Ubuntu 14, Ubuntu 16, Ubuntu 18, SUSE 12, CentOS 7, Fedora 28, RHEL 7, Debian 8, openSUSE Leap 42.1

Method 2: Generating obsfs by Compilation

Did you find this page helpful?

Submit successfully!

Thank you for your feedback. Your feedback helps make our documentation better.

Failed to submit the feedback. Please try again later.

Which of the following issues have you encountered?

Please complete at least one feedback item.

Content most length 200 character

Content is empty.

OK Cancel