Examples
rclone
Connect rclone to RustFS and perform basic object operations.
rclone is a command-line program for syncing files with cloud storage and speaks the S3 protocol that RustFS implements.
Install
curl https://rclone.org/install.sh | sudo bashOr see the official install guide.
Configure
Add a remote to ~/.config/rclone/rclone.conf. Replace http://localhost:9000 with your server address, and use your own access keys. force_path_style = true is required because RustFS uses path-style addressing:
[rustfs]
type = s3
provider = Other
access_key_id = <your-access-key>
secret_access_key = <your-secret-key>
endpoint = http://localhost:9000
region = us-east-1
force_path_style = trueVerify
Create a bucket:
rclone mkdir rustfs:my-bucketUpload a file:
rclone copy /path/to/hello.txt rustfs:my-bucketList buckets and contents:
rclone lsd rustfs:
rclone ls rustfs:my-bucket -1 2026-07-15 10:30:00 -1 my-bucket
12 hello.txtNext steps
Build applications against RustFS with an S3 SDK, or manage objects with mc.