---
categories: tools
title: Howto Rclone
...

* Site officiel / Documentation : <https://rclone.org/>

Rclone est un outil en ligne de commande de synchronisation de fichiers et dossiers compatible avec de nombreuses plateformes cloud (Amazon S3, Ceph, Ownloud....)

# Installation

~~~
# apt install rclone

$ rclone --version
2018/09/21 11:51:37 Config file "/home/foo/.rclone.conf" not found - using defaults
rclone v1.35-DEV
~~~

# Configuration

La configuration se situe dans `~/.rclone.conf` qui est un fichier au format INI. Celui-ci peut être géré via rclone directement avec `rclone config` qui est totalement interactif.

~~~
$ rclone config
2018/09/21 11:53:26 Config file "/home/foo/.rclone.conf" not found - using defaults
No remotes found - make a new one
n) New remote
s) Set configuration password
q) Quit config
n/s/q> 

[....]
~~~

Au final, on obtient une config toute belle :

~~~
$ cat `~/.rclone.conf`

[S3]
type = s3
provider = AWS
access_key_id = *****************
secret_access_key = **************************
region = eu-central-1
location_constraint = eu-central-1
~~~

Tous les détails pour la configuration de : 

* [S3](https://rclone.org/s3/)


## Synchronisation 

Synchronisation à 1 sens (source vers destination)

~~~
$ rclone sync

Usage:
  rclone sync source:path dest:path [flags]
~~~


Exemple de flags pratiques :

* `-n`, `--dry-run` : Faire une synchronisation d'essai sans modifications de la destionation
* `-v`, `--verbose` : Rendre rclone un peu plus bavard
* `-P`, `--progress` : Affichage de l'état d'avancement de la synchronisation

* `--s3-acl=STRING` : (Spécifique S3) L'ACL des éléments à copier (Cf: Les [ACL AWS S3](https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#canned-acl)

Ainsi, pour synchroniser un dossier vers S3 : 

~~~
# Synchronisation de /home/foo vers le dossier "/foo/backups" du bucket S3 "mon_bucket"
$ rclone -v --s3-acl=private sync /home/foo/ S3:mon_bucket/foo/backups/
~~~