Skip to navigation

Mount a Bucket as a Filesystem

Mounting a bucket lets you use it as a folder on your computer or VM, such as /mnt/my-bucket, so programs that only understand files and folders can read and write objects. A FUSE tool (filesystem in user space) — rclone or s3fs — translates each file operation into S3 requests behind the scenes. It suits backups, migrations and tools that can’t speak S3; it is not a replacement for a real disk.

When to use a mounted bucket

You want to…Use
Let a backup or media tool that only writes to folders store data in a bucketMount with rclone or s3fs (this page)
Copy many files to or from a bucketrclone sync or aws s3 sync — faster and more reliable than a mount
Run a database, or edit files in placeA Block Storage volume
Serve files to usersThe bucket’s URLs, a custom domain or the CDN

A mounted bucket is not a real disk. Changing part of a file re-uploads the whole file, there is no file locking, and renaming a folder copies every object in it. Don’t put a database, a Git repository or many processes writing the same files on it.

How it works

  1. You give the tool your S3 credential and the three IBEE settings: endpoint, region auto, path style.
  2. The tool mounts the bucket on an empty folder.
  3. Reading a file downloads it (or part of it); writing a file uploads the whole file when it’s closed. Each operation is a billed request — see Pricing.

Before you begin

  • A bucket. See Create a bucket.
  • An S3 credential with Object Read & Write for the bucket (or Object Read only for a read-only mount), and its S3 Endpoint, https://WORKSPACE-ID.blob.ibeestorage.com.
  • A Linux or macOS machine with FUSE: on Ubuntu or Debian, sudo apt-get install fuse3; on macOS, macFUSE.
  • sudo rights, to install packages and create the mount folder.
1

Install rclone

Follow rclone.org/install. Check it with rclone version.

2

Add the IBEE remote

Add this to your rclone config file (rclone config file prints where it is):

[ibee]
type = s3
provider = Other
access_key_id = YOUR-ACCESS-KEY-ID
secret_access_key = YOUR-SECRET-ACCESS-KEY
endpoint = https://WORKSPACE-ID.blob.ibeestorage.com
region = auto
force_path_style = true

Test it: rclone lsd ibee: lists your buckets.

3

Mount the bucket

sudo mkdir -p /mnt/my-bucket
sudo chown "$USER" /mnt/my-bucket
rclone mount ibee:my-bucket /mnt/my-bucket --vfs-cache-mode writes --daemon

--vfs-cache-mode writes keeps files on local disk while they’re written, so programs that write in pieces work. --daemon runs the mount in the background.

4

Unmount

fusermount3 -u /mnt/my-bucket # Linux (fusermount on older systems)
umount /mnt/my-bucket # macOS

Mount with s3fs

1

Install s3fs

On Ubuntu or Debian:

sudo apt-get install s3fs

On macOS, install macFUSE first, then follow the s3fs-fuse installation guide.

2

Save the credential

echo "YOUR-ACCESS-KEY-ID:YOUR-SECRET-ACCESS-KEY" > ~/.passwd-s3fs
chmod 600 ~/.passwd-s3fs
3

Mount the bucket

endpoint=auto sets the signing region; use_path_request_style turns on path-style addressing.

sudo mkdir -p /mnt/my-bucket
sudo chown "$USER" /mnt/my-bucket
s3fs my-bucket /mnt/my-bucket \
-o url=https://WORKSPACE-ID.blob.ibeestorage.com \
-o endpoint=auto \
-o use_path_request_style \
-o passwd_file=${HOME}/.passwd-s3fs
4

Unmount

fusermount -u /mnt/my-bucket on Linux, or umount /mnt/my-bucket on macOS.

Mount at boot (Linux, s3fs)

Copy the password file to /root/.passwd-s3fs (mode 600), then add one line to /etc/fstab:

my-bucket /mnt/my-bucket fuse.s3fs _netdev,allow_other,url=https://WORKSPACE-ID.blob.ibeestorage.com,endpoint=auto,use_path_request_style,passwd_file=/root/.passwd-s3fs 0 0

Test it without rebooting: sudo mount -a. _netdev waits for the network before mounting.

Verify

echo "hello" > /mnt/my-bucket/mount-test.txt
ls -l /mnt/my-bucket/
rclone ls ibee:my-bucket/mount-test.txt # or check the bucket in the portal

The file appears in the bucket’s Objects tab. Delete it with rm /mnt/my-bucket/mount-test.txt.

Limits and behavior

Value
Largest single upload5 GiB; bigger files are sent in parts (up to 10,000 parts of up to 5 GiB)
Partial writesThe whole file is uploaded again
File lockingNot supported
Folder renameCopies and deletes every object under it
Symbolic links, permissions, ownersNot stored like on a real disk
du and ls on large foldersSlow: they list every object
BillingEach read, write and list is a Class A or Class B request

Troubleshooting

You seeWhat it meansWhat to do
403 AccessDenied — Invalid region scope (in the tool’s debug log)The tool signed with us-east-1rclone: region = auto. s3fs: -o endpoint=auto.
”Could not resolve host” for my-bucket.WORKSPACE-ID.blob.ibeestorage.comVirtual-hosted addressingrclone: force_path_style = true. s3fs: -o use_path_request_style.
403 AccessDenied — Unsigned payload requires a signed checksumThe tool uploaded without a checksumUpdate the tool, and don’t turn off its checksums.
fuse: device not found or fusermount: command not foundFUSE isn’t installedInstall fuse3 (Linux) or macFUSE (macOS).
Transport endpoint is not connectedThe mount process stoppedUnmount with fusermount -u, then mount again.
Writes fail or files are empty with rcloneNo write cacheMount with --vfs-cache-mode writes.
Very slow listingsThe folder holds many objectsUse prefixes with fewer objects, or rclone sync instead of a mount.
403 AccessDenied on writesThe credential is read-only or limited to other bucketsUse Object Read & Write for this bucket.