Rclone
******

- :ref:`sync-from-digital-ocean-spaces`
- https://rclone.org/

Backup to ``rsync.net``
=======================

- `rsync.net Cloud Storage has rclone built in`_
   *You can go 'back in time' with the free snapshots included with an
   rsync.net account*.

From `Using rclone for Cloud to Cloud Transfer`_ ...

Check you have access to rsync.net via ssh::

  ssh zh4600@zh4600.rsync.net ls -la

Configure rclone on rsync.net::

  ssh zh4600@zh4600.rsync.net rclone config 

  Configuration complete.
  Options:
  - type: s3
  - provider: DigitalOcean
  - access_key_id: DOPK4
  - secret_access_key: LG3PK
  - endpoint: lon1.digitaloceanspaces.com
  - acl: private
  Keep this "spaces-hatherleigh" remote?

Check you have access by listing the files in the S3 bucket::

  ssh zh4600@zh4600.rsync.net rclone ls spaces-hatherleigh:www-hatherleigh-info

The parameters are:

1. The name of the rclone remote (``spaces-hatherleigh``)
2. The bucket name (``www-kbsoftware-co-uk``)

Backup (sync) the whole repository::

  ssh zh4600@zh4600.rsync.net rclone sync spaces-hatherleigh:www-hatherleigh-info rclone/spaces/hatherleigh

The parameters are:

1. The name of the rclone remote (``spaces-hatherleigh``)
2. The bucket name (``www-kbsoftware-co-uk``)
3. The folder / directory where the backup will be stored
   (``rclone/spaces/kbsoftware``).

View your backup::

  zh4600@zh4600.rsync.net ls -la rclone/spaces/kbsoftware

.. _sync-from-digital-ocean-spaces:

Sync from Digital Ocean Spaces
==============================

Browse to *Spaces Object Storage*, *Access Keys*.

Create an *Access Key* for your bucket with *Read/Write/Delete* permissions.

Update ``~/.config/rclone/rclone.conf`` with the
*Access Key ID* (``access_key_id``) and the
*secret key* (``secret_access_key``)::

  [hatherleigh-transfer]
  type = s3
  provider = DigitalOcean
  env_auth = false
  access_key_id = DOPK5
  secret_access_key = GPjJ
  endpoint = lon1.digitaloceanspaces.com
  acl = private

::

  rclone sync hatherleigh-transfer:my-web-site ./my-web-site

The parameters are:

1. The name of the rclone remote (``hatherleigh-transfer``)
   from ``~/.config/rclone/rclone.conf``.
2. The bucket name (``my-web-site``)
3. The folder / directory where the backup will be stored (``./my-web-site``).


.. _`rsync.net Cloud Storage has rclone built in`: https://rsync.net/products/rclone.html
.. _`Using rclone for Cloud to Cloud Transfer`: https://www.rsync.net/resources/howto/rclone.html