Skip to content

How to Mount S3 Storage on Windows, MacOS, and Linux

Overview

You have options for mounting S3 storage buckets:

  • OS-specific clients
  • Cross-platform clients

Tip: use rclone for mounting S3 storage onto local systems because it is:

  • Cross-platform
  • Well-supported
  • MIT licensed

Other clients may be better for your use case. Here are some clients you can use:

  • RClone (Cross-platform, open-source, free) (How To)[]
  • Cyberduck (Cross-platform, open-source, free) (How To)[]
  • Mountain Duck (Cross-platform, closed source, free trail)
  • s3fs (Cross-platform, open-source, free)
  • Mountpoint for AWS S3 (Linux only, open-source, free)
  • Expandrive (Windows/MacOS, closed source, free for personal use/non-free subscription)
  • TntDrive (Windows only, closed source, non-free/free-trial)
  • S3 Drive (Cross-platform, closed source, non-free/free with limititations)

Multiple systems accessing a s3 bucket simultaneously

We recommend only allowing a single system or user to mount an s3 bucket as writable at one time. If two users or systems can both write to the mounted bucket at the same time, both users will see the file as initially opened but only the changes last user to save the file made will be in the saved object. Enabling versioning on your bucket can help in that the changes made to the object will be in a version but manual intervention will be required to merge the divergent changes. One system writing to a bucket with multiple systems reading from that bucket can provide an efficient method of accessing large amounts of data but careful tuning of your cache options should be considered.

Obtaining your s3 credentials

In the Rumble Cloud console interface:

  1. Select S3 Credentials.
  2. Select your region in the top of the interface (us-east-2 is shown in the example)
  3. Enter a name for the set of credentials.
  4. Copy and securely store the displayed Access Key and Secret Key.

Multiple systems accessing an S3 bucket simultaneously

Tip: only allow a single system or user to mount an S3 bucket as writable at one time.

If two users' systems can both write to the mounted bucket at the same time, both users will see the file as initially opened but only the changes last user to save the file made will be in the saved object. Enabling versioning on your bucket can help in that the changes made to the object will be in a version, but manual intervention will be required to merge the divergent changes. One system writing to a bucket with multiple systems reading from that bucket can provide an efficient method of accessing large amounts of data, but careful tuning of your cache options should be considered.

Mounting s3 storage via CLI

Configure RClone

Use rclone to create a configuration file.

Text Only
rclone config

  1. Select n for new remote.

  2. Name your new config with a name of your choice (e.g. rumble is used in the examples).

  3. Type 4 for Option Storag (S3 compliant storage).

  4. Type 4 for Option Provider (Ceph Object Storage \ (Ceph)).

  5. Type 1 for Option env_auth (Manually enter credentials).

  6. Type your access key ID for Option access_key_id.

  7. Type your secret key for Option secret_access_key.

  8. Leave the region empty for Option Region.

  9. Type object.us-east-1.rumble.cloud, object.us-east-2.rumble.cloud, or object.us-west.rumble.cloud, based on your rumble cloud location for Option endpoint.

  10. Leave Option location_constraint empty.

  11. Type 1 for Option acl (private).

  12. Type 1 for Option server_side_encryptioin (None).

  13. Type 1 for Option sse_kms_key_id (None).

  14. Type n for Edit advanced config.

  15. Type y to keep the config if it looks correct.

  16. Type q to quit configuring rclone.

At this point you should have a new rclone configuration file stored in the default configuration location.

To see where this is, type: rclone config file:

Text Only
[MyBucket]
type = s3
provider = Ceph
access_key_id = *YourAccessKey*
secret_access_key = *YourSecretKey*
endpoint =object.us-east-2.rumble.cloud
acl = private

We recommend using rclone for mounting s3 storage onto local systems as it is cross platform, well supported and is MIT licensed, other options may have advantages for your use case.

Mount an S3 bucket on Windows

Tip: use rclone along with winfsp, a Windows file system proxy.

  1. Install rclone.
Text Only
winget install Rclone.Rclone

  1. Configure rclone as described in the "Configuring Rclone" section.

  2. In order to use the rclone mount functionality, you will need to install winfsp. Winfsp acts as a filesystem proxy between rclone and the Windows system.

  3. Mount your S3 bucket as a drive in Windows (see the rclone mount documentation for further options).

  4. Mount your S3 bucket.

Text Only
rclone mount rumble:bucket/ Z: \--vfs-cache-mode full

Mount an S3 bucket on Mac OS-X

  1. Install rclone.

Tip: Use the official binary from rclone.org. Tools such as Homebrew have at times changed the default compilation options which can impact your ability to mount.

Bash
sudo -v ; curl https://rclone.org/install.sh \| sudo bash
  1. Mount your S3 bucket.
Bash
rclone nfsmount rumble:bucket/ /path/to/local/mount

Tip: Use rclone nfsmount here instead of rclone mount, as it avoids the dependency of a fuse implementation (macFUSE/fuse-t).

Mount an S3 bucket on Linux

  1. Install rclone.

Tip: Use your distro's package repository to install rclone whenever possible.

  1. Configure rclone as described in the "Configuring Rclone" section.

  2. Mount your S3 bucket.

Bash
rclone mount rumble:bucket/ /mnt/s3bucket \--vfs-cache-mode full

Accessing s3 storage via a GUI client

Cyberduck GUI client (Windows / MacOS)

Cyberduck is a free nag-ware GUI client for accessing s3 storage. You can register your client for a fee to remove the prompts. Cyber Duck Documentation

Cyberduck can be installed from the Windows Store and Mac App Store or you can download the installer.

header

Click Install.

header

The initial Cyberduck interface.

header

You can use a pre-built profile by double clicking them after download, or manually configure Cyberduck (instructions here)

To manually configure Cyberduck:

  1. Click the Open Connection button.

header

  1. Fill in the Server field with object.us-east-1.rumble.cloud, object.us-east-2.rumble.cloud or object.us-west-1.rumble.cloud.
  2. Enter your Access Key in the Access Key ID field.
  3. Enter your Secret Key in the Secret Access Key field.

header

If you only want to access a specific bucket instead of all your buckets click the More Options drop-down arrow and fill your bucket into the path field.

header

Cyberduck drag-and-drop:

header

If the file already exists, you'll be prompted to decide how to proceed.

header

Mounting s3 storage via GUI

Mountain Duck

Mountain Duck is a paid GUI client for mounting s3 storage but has a free 14 Day trial after requesting a trial, without requesting a trail or licensing Mountain Duck will only function for 10 minutes. Mountain Duck Documentation

Mountain Duck can be downloaded and installed for Windows and Mac OS-X.

Run the installer.

header

Click Install.

header

Allow the install.

header

Mountain Duck lives in the status bar on macOS and tray area on Windows. If you have previously used Cyberduck, connection profiles will be automatically imported. Otherwise refer to the Mountain Duck User Interface Documentation.