Skip to content
Documentation
View as Markdown

How to mount S3 storage on Windows, macOS, and Linux

How-to · Updated Sep 2026

Coming from another cloud?

▸AWS·Amazon S3

This Quake AI feature maps to AWS’s Amazon S3.

▸Azure·Blob Storage

This Quake AI feature maps to Azure’s Blob Storage.

▸DigitalOcean·Space (bucket)

Space (bucket)high

  • Naming differs: users create a “Space” that is a bucket, and each bucket has a unique URL (virtual-hosted or path style), whereas Swift uses containers within an account namespace. ().
  • Bucket addressing uses S3-style endpoints such as `${BUCKET}.${REGION}.digitaloceanspaces.com` (and `${REGION}.digitaloceanspaces.com/${BUCKET}`), which differs from Swift’s account/container/object path conventions. (, ).
  • Access keys can be scoped to high-level permission tiers (Read, Read/Write/Delete, All) applied across buckets/objects, which differs from Swift’s typical tenant/user + container ACL model. ().
DigitalOcean docs ↗
▸Google Cloud·Storage

This Quake AI feature maps to Google Cloud’s Storage.

▸Hetzner·Buckets

Bucketshigh

  • S3 API (PUT Bucket requires specific headers like x-amz-acl limited to private/public-read, LocationConstraint); Swift uses POST/PUT Container with broader ACLs via X-Container-Read/Write.
  • Public access via https://bucket.location.your-objectstorage.com/object; Swift public via temp URLs or ACLs.
  • Up to 100 buckets per account; Swift has no hard limit.
Hetzner docs ↗
Before this
S3 on Quake AI

How to mount S3 storage on Windows, macOS, and Linux

Mount a Quake AI Object Storage bucket as a local drive or filesystem with rclone. You can then browse, read, and write objects through your operating system's file tools.

Prerequisites
  • S3 credentials (access key and secret key)
  • An existing object storage bucket

Install rclone#

Install on Windows#

Install rclone in PowerShell:

PowerShell
winget install Rclone.Rclone

Install WinFsp so that rclone can create a filesystem mount.

Install on macOS#

Install rclone with Homebrew:

bash
brew install rclone

Install on Linux#

Install rclone from your distribution's package repository. On Ubuntu or Debian, run:

bash
sudo apt update
sudo apt install rclone

Choose your regional endpoint#

Use the endpoint for the region that contains your bucket:

RegionEndpoint
US East 1object.us-east-1.rumble.cloud
US East 2object.us-east-2.rumble.cloud
US West 1object.us-west-1.rumble.cloud

Configure rclone#

Open the rclone configuration wizard:

bash
rclone config
  1. Select n for new remote.
  2. Enter quakeai for the remote name.
  3. Select s3 for S3 compliant storage.
  4. Select Ceph for the provider.
  5. Select Enter credentials manually for env_auth.
  6. Enter your access key ID and secret access key.
  7. Leave the region empty.
  8. Enter the regional endpoint for your bucket.
  9. Leave location_constraint empty.
  10. Set acl to private.
  11. Leave server-side encryption and the KMS key ID set to None.
  12. Skip the advanced configuration, review the settings, and save the remote.

The saved remote has this shape:

ini
[quakeai]
type = s3
provider = Ceph
access_key_id = YOUR_ACCESS_KEY
secret_access_key = YOUR_SECRET_KEY
endpoint = object.us-east-1.rumble.cloud
acl = private

Confirm that rclone can list the bucket before mounting it:

bash
rclone lsf quakeai:YOUR_BUCKET_NAME

The command prints the objects and prefixes at the root of the bucket.

Mount the bucket#

Choose the instructions for your operating system.

Mount on Windows#

Mount the bucket as drive Z::

PowerShell
rclone mount quakeai:YOUR_BUCKET_NAME Z: --vfs-cache-mode full

Keep the PowerShell window open while you use the mount. Press Ctrl+C in that window to unmount the bucket.

Mount on macOS#

Create a mount directory and mount the bucket over NFS:

bash
mkdir -p "$HOME/mnt/quake-object-storage"
rclone nfsmount quakeai:YOUR_BUCKET_NAME "$HOME/mnt/quake-object-storage"

Keep the terminal open while you use the mount. Press Ctrl+C in that terminal to unmount the bucket.

Mount on Linux#

Create a mount directory and mount the bucket:

bash
mkdir -p "$HOME/mnt/quake-object-storage"
rclone mount quakeai:YOUR_BUCKET_NAME "$HOME/mnt/quake-object-storage" \
  --vfs-cache-mode full

Keep the terminal open while you use the mount. Press Ctrl+C in that terminal to unmount the bucket.

Browse a bucket with Cyberduck#

If you want a graphical file-transfer client instead of a filesystem mount, use Cyberduck. Install Cyberduck from its download page, then use a Quake AI connection profile:

  1. Download the profile for the region that contains your bucket.
  2. Open the downloaded profile in Cyberduck.
  3. Enter your Access Key ID and Secret Access Key.
  4. To open a specific bucket, expand More Options and enter the bucket name in Path.
  5. Select Connect.

Cyberduck lists the objects in the bucket. Drag files between Cyberduck and your computer to upload or download them.

See also#

Usage Guidelines

The sample code, software libraries, command line tools, proofs of concept, templates, and other related technology on this page (including any of the foregoing that is provided by Quake AI personnel) is provided to you as Quake AI Content under the Quake AI Customer Agreement, or the relevant written agreement between you and Quake AI (whichever applies). Do not use this Quake AI Content in your production accounts, or on production or other critical data. You are responsible for testing, securing, and optimizing the Quake AI Content (such as sample code) as appropriate for production grade use based on your specific quality control practices and standards. Deploying Quake AI Content may incur Quake AI charges for creating or using Quake AI chargeable resources, such as running Compute instances or storing data in Object Storage. Your use is also subject to the Acceptable Use Policy.

For the full policy, see Usage Guidelines.

Last validated: 01.09.2026

Quick answers

See all Object FAQs

See Also

S3 on Quake AI

Prerequisite

→

How to access buckets via FTP, FTPS, or SFTP

Shares: S3, Containers

→

How to Back Up to Quake AI Object Storage

Shares: S3, Object Storage

→

How to Migrate from Azure blob storage to Quake AI

Shares: S3, Object Storage

→

How to Migrate from Backblaze B2 to Quake AI

Shares: S3, Object Storage

→
Was this page helpful?