This document provides a brief introduction to rclone, focusing on its installation and basic usage. Rclone is a command-line tool designed to manage and synchronize files across local systems and cloud storage providers.
On macOS, the easiest way to install Rclone is using Homebrew. If Homebrew is installed, run:
brew install rclone
Once the installation is complete, verify it with:
rclone version
Alternatively, you can download the precompiled binary from the official website (see Windows section).
On Windows, rclone is distributed as a precompiled binary. Before downloading it, identify your system architecture to select the correct release. To check the architecture, open Command Prompt and run:
echo %PROCESSOR_ARCHITECTURE%
Once the architecture is known, visit the official download page: https://rclone.org/downloads/ and download the archive corresponding to your system (for example, Windows 64-bit).
After downloading:
rclone.exe binary in a directory included in the system PATH environment variable (e.g. C:\Windows or a custom tools directory).rclone version
On Unix-like systems, rclone provides an official installation script that automatically detects the operating system and architecture. To install rclone, run:
sudo -v ; curl https://rclone.org/install.sh | sudo bash
The script will download the correct binary for the system and install it under /usr/bin/rclone
(or equivalent) setting appropriate permissions.
Open a shell and run:
rclone config
Then insert n to name a new
connection:
Insert the number corresponding to your remote service. Make sure you select the correct number for the service, as the list may change! (e.g. 22 for GoogleDrive or 14 for Dropbox):
Then press Enter, leaving client_id empty:
Then press Enter, leaving client_secret empty:
Select Full access all files (1):
Then press Enter, leaving service_account_file empty:
No advanced configuration is needed.
Now rclone checks whether a graphical interface is available. If you are running rclone on your laptop type y,
otherwise if you are running rclone on a remote machine type n.
Run the following command on your PC:
rclone authorize "drive"
Authorize rclone to use your remote drive.
You should see this message:
Then copy the token generated locally on your PC:
Paste it on the remote server. Then your configuration is done:
And exit:
To list the files in your remote drive, run the following command:
rclone ls test:yourremotedirectory --drive-shared-with-me # this flag is optional
You can now download your data:
rclone copy test:yourremotedirectory ./pathWhereYouWant --drive-shared-with-me # this flag is optional