What is the s3fs-fuse Tool?

What is the s3fs-fuse tool?

Using s3fs-fuse you can mount a bucket of your S3 compatible Object Storage as a folder on Linux, macOS and FreeBSD machine. Please follow the installation instructions here if you're interested in using this tool.


If you are using Debian/Ubuntu please perform run the following command to install it instead:


sudo apt install s3fs

Please note that that a mounted Object Storage bucket doesn't always behave like a normal POSIX file system. Depending on how your application is accessing files, you may encounter issues like:


  • no/wrong file system usage statistics
  • sub-par performance
  • unexpected unmounts
  • duplicate writes leading to hidden objects that occupy space but are invisible to S3 API requests


If possible, using other tools like rclone to access Object Storage is recommended.

How do I mount a bucket using sf3s-fuse?

You can follow the below example to setup a mount:

  • access_key = 82046e8110804a43bf29c1ae426a724d
  • secret_key = 82e69bd7a52076c527154297a76c2233
  • S3 URL = https://eu2.contabostorage.com
  • bucket name = foo
  • mount point = ${HOME}/foo
# create a settings file with your access_key:secret_key
echo 82046e8110804a43bf29c1ae426a724d:82e69bd7a52076c527154297a76c2233 > ${HOME}/.passwd-s3fs
chmod 600 ${HOME}/.passwd-s3fs
# create mount point
mkdir ${HOME}/foo
# mount bucket foo to ${HOME}/foo
s3fs foo ${HOME}/foo -o passwd_file=${HOME}/.passwd-s3fs -o url=https://eu2.contabostorage.com -o use_path_request_style
# access contents
ls -la ${HOME}/foo

Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article

Modified on Tue, 30 Jul at 9:41 AM

Can’t find what you’re looking for?

Get in Touch

Do you have a pre-sales question?