s3fs — UzCloud Docs

s3fs mounts a bucket as a folder in Linux. Applications can then read and write objects as regular files.

Warning

A mounted bucket is not a real disk: operations are slower, and files are rewritten entirely on every change. Do not use s3fs for databases or for applications that frequently modify files. It works well for archives, media and backups.

Installation

sudo apt install s3fs          # Ubuntu, Debian
sudo dnf install s3fs-fuse     # Rocky Linux, AlmaLinux (EPEL)

Configuration

Save the keys to a file and restrict access to it:

echo "<Access Key>:<Secret Key>" | sudo tee /etc/passwd-s3fs
sudo chmod 600 /etc/passwd-s3fs

Mount the Bucket

sudo mkdir -p /mnt/s3
sudo s3fs my-bucket /mnt/s3 \
  -o passwd_file=/etc/passwd-s3fs \
  -o url=https://s3.uzcstorage.uz \
  -o use_path_request_style \
  -o allow_other

Check that the bucket is mounted:

df -h /mnt/s3 && ls /mnt/s3

Mount at Startup

Add a line to /etc/fstab:

my-bucket /mnt/s3 fuse.s3fs _netdev,allow_other,use_path_request_style,url=https://s3.uzcstorage.uz,passwd_file=/etc/passwd-s3fs 0 0

Check the entry without rebooting: sudo mount -a. To unmount: sudo umount /mnt/s3.

Tip

See also:

Connection Parameters