> For the complete documentation index, see [llms.txt](https://docs.ionos.com/cloud/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ionos.com/cloud/backup-and-storage/ionos-object-storage/s3-tools/rclone.md).
# 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](https://rclone.org/rc/) and [GUI](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 [rclone.org](https://rclone.org/). The official Ubuntu, Debian, Fedora, Brew, and Chocolatey repositories include rclone. For more information, see [Configuration Example](https://rclone.org/s3/#ionos).
## Use rclone with IONOS CLOUD Object Storage
Configurations configured with the `rclone config` command are called remotes. If you already have or plan to use buckets in different space.vars.ionos\_cloud\_object\_storage regions, you need to set up a separate remote for each region you use. For the list of commands, see [Subcommands](https://rclone.org/docs/#subcommands).
### Sample usage
* List remotes:
```bash
rclone listremotes
```
* List buckets of "ionos1" remote:
```bash
rclone lsd ionos1:
```
* Create bucket `my-bucket` at the remote `ionos1`:
```bash
rclone mkdir ionos1:my-bucket
```
* List objects of the bucket `my-bucket`:
```bash
rclone lsf ionos1:my-bucket
```
For more information, see [rclone lsf](https://rclone.org/commands/rclone_lsf/).
* Upload `filename.txt` from the current directory to the bucket `my-bucket`:
```bash
rclone copy --progress filename.txt ionos1:my-bucket
```
* Copy the contents of the local directory `my-dir` to the bucket `my-bucket`:
```bash
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`:
```bash
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`:
```bash
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:
```bash
rclone sync --progress my-dir/ ionos1:my-bucket
```
* Get the total size and number of objects in remote:path:
```bash
rclone size ionos1:my-bucket/path
```
* Check if the files in the local directory and destination match:
```bash
rclone check my-dir/ ionos1:my-bucket
```
* Produce an `md5sum` file for all the objects in the path:
```bash
rclone md5sum ionos1:my-bucket/path
```
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.ionos.com/cloud/backup-and-storage/ionos-object-storage/s3-tools/rclone.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.