Rclone + GDX Cloud Integration Guide

Rclone is a command-line tool for managing files on cloud storage, offering an alternative to web storage interfaces. This guide shows how to configure Rclone to back up your files to GDX Cloud.

Version Information
This guide refers to Rclone v1.72.0. Rclone options may vary depending on the version you use.

Prerequisites

  • GDX Cloud account with S3 enabled
  • Access Key ID and Secret Access Key (from GDX Cloud console)
  • Rclone installed on your machine
Secure Your Credentials
Keep your Access Key ID and Secret Access Key secure. Never share them or commit them to version control. Store them in a safe location.

Installation

There are multiple ways to install Rclone on your machine. Please follow the instructions on the official website.

Configuration

This approach uses the standard S3-compatible configuration documented in the official rclone documentation.

Unix Compatibility
These instructions work on any Unix machine with Rclone. For more details, check the official configuration guide.

Once installed, run the following command to add a configuration:

rclone config

This will start an interactive session to guide you through the configuration process of a remote.

Each prompt should be answered as shown below:

name> datnass
Storage> s3
provider> other
env_auth> false
access_key_id> YOUR_ACCESS_KEY_ID
secret_access_key> YOUR_SECRET_ACCESS_KEY
region> (leave empty)
endpoint> s3.gdx.datnass.com
acl>

The resulting configuration file should look like:

[datnass]
type = s3
provider = other
access_key_id = YOUR_ACCESS_KEY_ID
secret_access_key = YOUR_SECRET_ACCESS_KEY
endpoint = s3.gdx.datnass.com

Usage Examples

These examples assume you have already created an S3 bucket called bucket-name in your GDX Cloud account.

List Files

rclone ls datnass:bucket-name

Sync Folder

rclone sync -P ./backup-folder datnass:bucket-name

Delete a Bucket and Its Contents

Destructive Operation
The purge command permanently deletes all data in the bucket. This operation cannot be undone. Use with caution.

This works for buckets with either enabled or disabled S3 Versioning:

rclone purge -P -vvv datnass:bucket-name

Support & Resources

For Rclone-specific issues, refer to the official documentation. For GDX Cloud issues, contact your account administrator.