For AI agents: the complete documentation index is available at https://docs.us.ovhcloud.com/en/llms.txt, the full documentation bundle is available at https://docs.us.ovhcloud.com/en/llms-full.txt, and this page is available as Markdown at https://docs.us.ovhcloud.com/en/storage-and-backup/object-storage/rclone.md.
  • English

Object Storage - Use Object Storage with Rclone

View as Markdown

Rclone is a backup tool that can sync to and from various storage backends and can be used on Windows, macOS, and Linux. Detailed documentation is also available on the official Rclone website.

There are two flavors of Object Storage, which you can compare in the table below. You can also click here to view more detailed information about all Object Storage options.

Standard Object StorageHigh Performance Object Storage
A great storage solution for high volumes of data at a great price. We offer a wide range of S3™* compatible APIs with this solution.A solution adapted to the most demanding needs, where the storage must include high read and write performance.
S3™ compatible APIS3™ compatible API
Data protection with erasure codingData protection with erasure coding

 

Warning

NOTE: OVHcloud provides services for which you are responsible for their configuration and management. You are therefore responsible for their proper functioning.

This tutorial is designed to help you as much as possible with common tasks. If you are having difficulty performing these actions, please contact a specialized service provider. OVHcloud cannot provide you with technical support in this regard.

 

Requirements

  • A container
  • A user with the required access rights on the container
  • Your Object Storage credentials (access_key and secret_access_key)
  • Rclone installed

See our Getting Started with Object Storage guide.

Info

To identify the endpoint for your storage class, please refer to this guide: Endpoints and Object Storage Geoavailability.

 

Instructions

To configure Rclone, edit or download the Rclone file.

Log in to the OVHcloud Control Panel and navigate to your container via the Public Cloud and Object Storage menus. Then choose the Object Storage users tab,

Click the more options ... button next to the user for whom you wish to download the file and select Download rclone file.

Object storage users more options

In the pop-up menu, select S3 as the File type and then click Download. This option applies to "Standard Object Storage" and "High Performance Object Storage."

Object storage users download file

The configuration file should look like this:

Warning

NOTE: You may need to manually add the secret_access_key to the file.

[<remote_name>]
type = s3
provider = Other
env_auth = false
access_key_id = <access_key>
secret_access_key = <secret_key>
endpoint = https://s3.<region_in_lowercase>.io.cloud.ovh.us
acl = private
region = <region_in_lowercase>
location_constraint = <region_in_lowercase>

 

Next, copy the downloaded configuration file into the following Rclone configuration directory to make it default:

  • On Windows
%APPDATA%/rclone/rclone.conf
  • On Linux or Mac
~/.config/rclone/rclone.conf

Alternatively, specifying the --config=CONFIG_FILE in the rclone command will override the default file. CONFIG_FILE is the location of downloaded config file.

 

Command examples

Warning

NOTE: The default remote name is the first name in brackets in the configuration file.

List all containers:

rclone lsd <remote_name>:

Create a new container:

rclone mkdir <remote_name>:<bucket_name>

List the contents of a container:

rclone ls <remote_name>:<bucket_name>

Synchronize a local directory to a bucket:

rclone sync <source_directory> <remote_name>:<bucket_name>

Copy a file into a bucket:

rclone copy <file_path> <remote_name>:<bucket_name>

Download a file from a bucket:

rclone copy <remote_name>:<bucket_name>/<object_key> <destination_file_path>

You will find on the official Rclone website a detailed documentation of the possible actions: Official Rclone documentation. Here are full lists of Rclone flags and Rclone commands.

 

Go further

Browse all the Object Storage (S3™-compatible) guides.

Browse the rest of the OVHcloud US documentation for guides on our other products and services.

Learn more about Object Storage on the OVHcloud US website.

*S3 is a trademark filed by Amazon Technologies, Inc. OVHcloud's service is not sponsored by, endorsed by, or otherwise affiliated with Amazon Technologies, Inc.