rclone

Rclone is a command line tool for managing files in the cloud. It is available for Windows, macOS, and Linux. Rclone also has a built-in HTTP server that can be used to remotely control rclone using its API and a web GUI (graphical user interface).

rclone helps:

  • backing up (and encrypting) files to cloud storage

  • restoring (and decrypting) files from cloud storage

  • mirroring cloud data to other cloud services or locally

  • transferring data to the cloud or between cloud storage providers

  • mounting multiple encrypted, cached, or diverse cloud storages in the form of a disk

  • analyzing and taking into account data stored in cloud storage using lsf, ljson, size, and ncdu

Configuration

Download the latest version of rclone from rclone.org. The official Ubuntu, Debian, Fedora, Brew, and Chocolatey repositories include rclone.

You can find the configuration example here.

Using rclone with IONOS S3 Object Storage

Configurations configured with the rclone config command are called remotes. If you already have or plan to use buckets in different IONOS S3 Object Storage regions, you will need to set up a separate remote for each region you use.

Please refer to the list of commands at the rclone website.

Sample Usage

  • List remotes:

    rclone listremotes
  • List buckets of "ionos1" remote:

    rclone lsd ionos1:
  • Create bucket my-bucket at the remote ionos1:

    rclone mkdir ionos1:my-bucket
  • List objects of the bucket my-bucket:

    rclone lsf ionos1:my-bucket

    For more information, see lsf command reference.

  • Upload filename.txt from the current directory to the bucket my-bucket:

    rclone copy --progress filename.txt ionos1:my-bucket
  • Copy the contents of local directory my-dir to the bucket my-bucket:

    rclone copy --progress my-dir ionos1:my-bucket/my-dir/
  • Copy all objects with the prefix my-dir from the bucket my-source-bucket to my-dest-bucket:

    rclone copy --progress ionos1:my-bucket/my-dir/ ionos2:my-bucket/my-dir/

    The buckets could be located in different regions and even at different providers. Unless buckets are located within the same region, the data is not copied directly from the source to the destination. For cross-regional copying, the data is downloaded to you from the source bucket and then uploaded to the destination.

  • Download all the objects from the my-bucket bucket to the local directory my-dir:

    rclone copy --progress ionos1:my-bucket my-dir/
  • Sync the bucket my-bucket with the contents of the local directory my-dir. The destination is updated to match the source, including deleting files if necessary:

    rclone sync --progress my-dir/ ionos1:my-bucket
  • Get the total size and number of objects in remote:path:

    rclone size ionos1:my-bucket/path
  • Check if the files in the local directory and destination match:

    rclone check my-dir/ ionos1:my-bucket
  • Produce an md5sum file for all the objects in the path:

    rclone md5sum ionos1:my-bucket/path

Last updated