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
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
- You give the tool your S3 credential and the three IBEE settings: endpoint, region
auto, path style. - The tool mounts the bucket on an empty folder.
- 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. sudorights, to install packages and create the mount folder.
Mount with rclone (recommended)
Add the IBEE remote
Add this to your rclone config file (rclone config file prints where it is):
Test it: rclone lsd ibee: lists your buckets.
Mount with s3fs
Install s3fs
On Ubuntu or Debian:
On macOS, install macFUSE first, then follow the s3fs-fuse installation guide.
Mount at boot (Linux, s3fs)
Copy the password file to /root/.passwd-s3fs (mode 600), then add one line to /etc/fstab:
Test it without rebooting: sudo mount -a. _netdev waits for the network before mounting.
Verify
The file appears in the bucket’s Objects tab. Delete it with rm /mnt/my-bucket/mount-test.txt.
