s3fs

s3fs is a utility that allows Linux and macOS to mount an Object Storage bucket via FUSE.

Note

We recommend using s3fs version 1.84 or higher.

Before you start

  1. Create a service account.
  2. Assign a role to a service account.
  3. Create a static access key.

Installation

To install s3fs, follow the instructions in the project repository.

Setup

To configure s3fs, save the key ID and secret key to a ~/.passwd-s3fs file in the format <key ID>:<secret key> and restrict access to the ~/.passwd-s3fs file like this:

echo  <key ID>:<secret key> >  ~/.passwd-s3fs
chmod 600  ~/.passwd-s3fs

Mounting a bucket

  1. Select the folder where you want to mount the bucket and make sure you have permissions to perform the mounting operation.

  2. Run a command like:

    s3fs <bucket name> /mount/<folder path> -o passwd_file=~/.passwd-s3fs \
        -o url=http://storage.yandexcloud.net -o use_path_request_style -o nocopyapi
    

You can configure mounting a bucket at system startup. To do this, open the /etc/fstab file and add a line in the following format:

s3fs#<bucket name> /mount/<folder path> fuse _netdev,allow_other,use_path_request_style,nocopyapi,url=http://storage.yandexcloud.net 0 0

Note

Make sure you use the nocopyapi parameter. It provides correct interaction with the HTTP API compatible with Amazon S3.

For descriptions of all s3fs parameters, see the project's wiki page on GitHub.