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 or 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 instead.

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