rclone is a command-line program to manage files on cloud storage, compatible with Windows, macOS and Linux.
Z1 Storage settings at a glance: Storage type: s3 | Provider: Ceph | Endpoint: s3.z1storage.com | Access keys: available in your client area
Install rclone (Linux)
We recommend the official install script, as Linux distribution repositories often ship outdated rclone versions:
curl https://rclone.org/install.sh | sudo bash
Alternatively you can use your package manager (e.g. sudo apt install rclone), keeping in mind the version may be older.
After installation, confirm rclone is installed:
rclone version
Install rclone (macOS)
The easiest method is Homebrew:
brew install rclone
Alternatively use the official install script (curl https://rclone.org/install.sh | sudo bash) or download the macOS build from the rclone downloads page. Confirm with rclone version.
Install rclone (Windows)
The quickest method is winget, from Command Prompt or PowerShell:
winget install Rclone.Rclone
Alternatively, download the Windows build from the rclone downloads page and extract it to a working directory such as C:\rclone. To use it, open the folder, type cmd in the address bar and press Enter — this opens a command prompt in that directory.
Configure rclone for Z1 Storage
Start the interactive configuration:
rclone config
Answer the prompts as follows (menu numbers can change between rclone versions — match on the names shown below):
n # New remote
name> z1storage # any name you like
Storage> s3 # "Amazon S3 Compliant Storage Providers including AWS, Ceph, Minio..."
provider> Ceph
env_auth> 1 # Enter AWS credentials in the next step (false)
access_key_id> YOUR_Z1_ACCESS_KEY
secret_access_key> YOUR_Z1_SECRET_KEY
region> # leave blank, press Enter
endpoint> s3.z1storage.com
location_constraint> # leave blank, press Enter
acl> private # only you can access and control the data
Edit advanced config?> n
Keep this "z1storage" remote?> y
q # quit config
Your access key and secret key can be retrieved from your Z1 Storage client area. Keep your keys safe and do not share them with others.
Use rclone to access your Z1 Storage data
After configuration you can use rclone to manage your buckets and data. A few common commands:
rclone lsd z1storage: # list your buckets
rclone ls z1storage:z1testbucket # list files in a bucket
rclone copy /path/to/data z1storage:z1testbucket/data # copy data to Z1
rclone sync /path/to/data z1storage:z1testbucket/data # one-way sync to Z1
The full command reference is available HERE.
Mount a Z1 Storage bucket as a directory
rclone can also mount your bucket so you can browse it like any other directory.
Linux and macOS (Linux requires FUSE, preinstalled on most distributions; macOS requires macFUSE or FUSE-T):
rclone mount z1storage:z1testbucket /mnt/clouddrive
Add --daemon to run the mount in the background.
Windows
Mounting on Windows requires WinFsp, a free open-source tool for virtual file systems. Download and install it first, then mount your bucket as a drive letter:
rclone mount z1storage:z1testbucket Z:
Or mount to a folder path:
rclone mount z1storage:z1testbucket C:\clouddirectory
Once the mount is running you can browse the bucket in Windows File Explorer:
Tip: If you prefer a ready-made mount tool, also see the Z1 Mount App which mounts your buckets as a drive on Windows and macOS.
Congratulations! You have successfully configured rclone to work with Z1 Storage.