Skip to main content
Storage • 2 mins read

Using rclone with Hippius S3

Using rclone with Hippius S3

rclone is a command-line tool for managing files across cloud storage. Use it to sync folders, copy files, or mount Hippius S3 as a local drive.

Prerequisites​

Configuration​

Run rclone config and create a new remote, or add this directly to your ~/.config/rclone/rclone.conf:

[hippius]
type = s3
provider = Other
access_key_id = YOUR_ACCESS_KEY
secret_access_key = YOUR_SECRET_KEY
endpoint = https://s3.hippius.com
region = decentralized
acl = private
force_path_style = true

Verify it works:

rclone ls hippius:

Common operations​

List buckets​

rclone lsd hippius:

List files in a bucket​

rclone ls hippius:my-bucket

Upload a file​

rclone copy ./local-file.txt hippius:my-bucket/

Upload a folder​

rclone copy ./my-folder hippius:my-bucket/my-folder

Sync a folder (local → Hippius)​

rclone sync ./my-folder hippius:my-bucket/my-folder

sync mirrors the source to the destination — files deleted locally are deleted remotely too. Use copy if you want to keep remote files.

Download a file​

rclone copy hippius:my-bucket/file.txt ./downloads/

Download a folder​

rclone copy hippius:my-bucket/my-folder ./local-folder

Mount as a local drive​

Mount Hippius S3 as a local filesystem (macOS/Linux):

mkdir -p ~/hippius-mount
rclone mount hippius:my-bucket ~/hippius-mount --daemon

Files appear at ~/hippius-mount. Unmount with:

fusermount -u ~/hippius-mount   # Linux
umount ~/hippius-mount          # macOS
FUSE Required

Mount requires FUSE. On macOS: brew install --cask macfuse. On Linux: apt install fuse.

Bandwidth and speed tips​

  • Use --transfers 8 to run 8 parallel transfers
  • Use --s3-upload-concurrency 8 for faster large file uploads
  • Use --progress to see transfer progress
rclone copy ./large-folder hippius:my-bucket --transfers 8 --progress