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 you can use to control it remotely using its API and GUI.

rclone helps with the following:

• Back up and encrypt files to cloud storage.

• Restore and decrypt files from cloud storage.

• Mirror cloud data to other cloud services or locally.

• Transfer data to the cloud or between cloud storage providers.

• Mount multiple encrypted, cached, or diverse cloud storage in the form of a disk.

• Analyze and consider 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. For more information, see Configuration Example.

Use rclone with IONOS Object Storage

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

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 rclone lsf.

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

  rclone copy --progress filename.txt ionos1:my-bucket

• Copy the contents of the 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 local directory my-dir contents. 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