# 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 [<mark style="color:blue;">API</mark>](https://rclone.org/rc/) and [<mark style="color:blue;">GUI</mark>](https://rclone.org/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 [<mark style="color:blue;">rclone.org</mark>](https://rclone.org/). The official Ubuntu, Debian, Fedora, Brew, and Chocolatey repositories include rclone. For more information, see [<mark style="color:blue;">Configuration Example</mark>](https://rclone.org/s3/#ionos).

## Use rclone with <code class="expression">space.vars.ionos\_cloud\_object\_storage</code>

Configurations configured with the `rclone config` command are called remotes. If you already have or plan to use buckets in different <code class="expression">space.vars.ionos\_cloud\_object\_storage</code> regions, you need to set up a separate remote for each region you use. For the list of commands, see [<mark style="color:blue;">Subcommands</mark>](https://rclone.org/docs/#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 [<mark style="color:blue;">rclone lsf</mark>](https://rclone.org/commands/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
  ```