If not yet installed on your machine, you can install **rclone** with the following command::
$ curl https://rclone.org/install.sh | sudo bash
Download OpenStack credentials
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and download an `application credential <https://cloud.garr.it/compute/app-credential/>`_ from openstack dashboard as **app-credentials.sh**
Then edit the Rclone configuration file::
In order to use **Rclone**, you can either load the configuration from environment either write them directly in the configuration file. Choose the best approach for your needs.
In both cases, you should edit the Rclone configuration file::
$ nano .rclone.conf
to look like this::
Case 1: Take variables from environment
"""""""""""""""""""""""""""""""""""""""
Add the following text to *rclone.conf*::
[garr-cloud]
type = swift
env_auth = true
Download OpenStack credentials
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and download an `application credential <https://cloud.garr.it/compute/app-credential/>`_ from openstack dashboard as **app-credentials.sh**
Then execute the content of the file::
$ source app-credentials.sh
Case 2: Write variables in the configuration file
"""""""""""""""""""""""""""""""""""""""""""""""""
Take note of these two variables in *app-credentials.sh*::
OS_APPLICATION_CREDENTIAL_ID
OS_APPLICATION_CREDENTIAL_SECRET
Add the following text to *rclone.conf*::
[garr-cloud]
type = swift
auth = https://keystone.cloud.garr.it:5000/v3/
auth_version = 3
application_credential_id = <insert here the content of OS_APPLICATION_CREDENTIAL_ID>
application_credential_secret = <insert here the content of OS_APPLICATION_CREDENTIAL_SECRET>
Mind that ``env_auth = true`` takes variables from environment, so you shouldn't insert it in this case.
