2014-03-29 06:34:13 +08:00
---
title: "Rclone"
2020-05-18 00:56:23 +08:00
description: "Rclone syncs your files to cloud storage: Google Drive, S3, Swift, Dropbox, Google Cloud Storage, Azure, Box and many more."
2014-03-29 06:34:13 +08:00
type: page
---
2020-05-18 00:56:23 +08:00
# Rclone syncs your files to cloud storage
2014-03-29 06:34:13 +08:00
2020-05-22 19:22:52 +08:00
{{< img width = "50%" src = "/img/logo_on_light__horizontal_color.svg" alt = "rclone logo" style = "float:right; padding: 5px;" > }}
2020-05-18 00:56:23 +08:00
2020-05-25 14:13:40 +08:00
- [About rclone ](#about )
2020-05-28 18:28:30 +08:00
- [What can rclone do for you? ](#what )
- [What features does rclone have? ](#features )
- [What providers does rclone support? ](#providers )
2020-05-25 14:13:40 +08:00
- [Download ](/downloads/ )
- [Install ](/install/ )
2020-05-22 19:22:52 +08:00
{{< rem MAINPAGELINK > }}
2020-05-18 00:56:23 +08:00
## About rclone {#about}
2020-05-27 00:12:52 +08:00
Rclone is a command line program to manage files on cloud storage. It
is a feature rich alternative to cloud vendors' web storage
interfaces. [Over 40 cloud storage products ](#providers ) support
rclone including S3 object stores, business & consumer file storage
2020-05-18 00:56:23 +08:00
services, as well as standard transfer protocols.
2020-05-27 00:12:52 +08:00
Rclone has powerful cloud equivalents to the unix commands rsync, cp,
mv, mount, ls, ncdu, tree, rm, and cat. Rclone's familiar syntax
2020-05-28 18:28:30 +08:00
includes shell pipeline support, and `--dry-run` protection. It is
2020-05-27 00:12:52 +08:00
used at the command line, in scripts or via its [API ](/rc ).
2020-05-18 00:56:23 +08:00
2020-05-28 18:28:30 +08:00
Users call rclone *"The Swiss army knife of cloud storage"* , and
2020-05-27 00:12:52 +08:00
*"Technology indistinguishable from magic"*.
2020-05-23 00:46:05 +08:00
2020-05-26 23:10:20 +08:00
Rclone really looks after your data. It preserves timestamps and
2020-05-28 18:28:30 +08:00
verifies checksums at all times. Transfers over limited bandwidth;
2020-05-18 00:56:23 +08:00
intermittent connections, or subject to quota can be restarted, from
the last good file transferred. You can
[check ](/commands/rclone_check/ ) the integrity of your files. Where
2020-10-14 05:43:40 +08:00
possible, rclone employs server-side transfers to minimise local
2020-05-27 00:12:52 +08:00
bandwidth use and transfers from one provider to another without
2020-05-28 18:28:30 +08:00
using local disk.
2020-05-18 00:56:23 +08:00
2020-05-27 00:12:52 +08:00
Virtual backends wrap local and cloud file systems to apply
2020-05-18 00:56:23 +08:00
[encryption ](/crypt/ ),
[caching ](/cache/ ),
2020-11-12 02:56:16 +08:00
[compression ](/compress/ )
2020-05-18 00:56:23 +08:00
[chunking ](/chunker/ ) and
[joining ](/union/ ).
2020-05-28 18:28:30 +08:00
Rclone [mounts ](/commands/rclone_mount/ ) any local, cloud or
2020-05-27 00:12:52 +08:00
virtual filesystem as a disk on Windows,
2020-05-28 18:28:30 +08:00
macOS, linux and FreeBSD, and also serves these over
2020-05-18 00:56:23 +08:00
[SFTP ](/commands/rclone_serve_sftp/ ),
[HTTP ](/commands/rclone_serve_http/ ),
[WebDAV ](/commands/rclone_serve_webdav/ ),
[FTP ](/commands/rclone_serve_ftp/ ) and
[DLNA ](/commands/rclone_serve_dlna/ ).
2020-05-27 00:12:52 +08:00
Rclone is mature, open source software originally inspired by rsync
and written in [Go ](https://golang.org ). The friendly support
community are familiar with varied use cases. Official Ubuntu, Debian,
Fedora, Brew and Chocolatey repos. include rclone. For the latest
version [downloading from rclone.org ](/downloads/ ) is recommended.
2020-05-18 00:56:23 +08:00
Rclone is widely used on Linux, Windows and Mac. Third party
2020-05-28 18:28:30 +08:00
developers create innovative backup, restore, GUI and business
2020-05-18 00:56:23 +08:00
process solutions using the rclone command line or API.
2020-05-28 18:28:30 +08:00
Rclone does the heavy lifting of communicating with cloud storage.
2020-05-18 00:56:23 +08:00
2020-05-28 18:28:30 +08:00
## What can rclone do for you? {#what}
2020-05-18 00:56:23 +08:00
2020-05-28 18:28:30 +08:00
Rclone helps you:
2020-05-18 00:56:23 +08:00
2020-05-23 00:46:05 +08:00
- Backup (and encrypt) files to cloud storage
- Restore (and decrypt) files from cloud storage
- Mirror cloud data to other cloud services or locally
- Migrate data to cloud, or between cloud storage vendors
- Mount multiple, encrypted, cached or diverse cloud storage as a disk
2020-05-25 14:15:39 +08:00
- Analyse and account for data held on cloud storage using [lsf ](/commands/rclone_lsf/ ), [ljson ](/commands/rclone_lsjson/ ), [size ](/commands/rclone_size/ ), [ncdu ](/commands/rclone_ncdu/ )
2020-05-26 23:10:20 +08:00
- [Union ](/union/ ) file systems together to present multiple local and/or cloud file systems as one
2020-05-18 00:56:23 +08:00
## Features {#features}
2020-05-26 23:10:20 +08:00
- Transfers
- MD5, SHA1 hashes are checked at all times for file integrity
- Timestamps are preserved on files
2020-05-18 00:56:23 +08:00
- Operations can be restarted at any time
2020-10-14 05:49:58 +08:00
- Can be to and from network, e.g. two different cloud providers
2020-05-26 23:10:20 +08:00
- Can use multi-threaded downloads to local disk
2020-05-18 00:56:23 +08:00
- [Copy ](/commands/rclone_copy/ ) new or changed files to cloud storage
- [Sync ](/commands/rclone_sync/ ) (one way) to make a directory identical
2020-05-26 23:10:20 +08:00
- [Move ](/commands/rclone_move/ ) files to cloud storage deleting the local after verification
- [Check ](/commands/rclone_check/ ) hashes and for missing/extra files
2020-05-18 00:56:23 +08:00
- [Mount ](/commands/rclone_mount/ ) your cloud storage as a network disk
- [Serve ](/commands/rclone_serve/ ) local or remote files over [HTTP ](/commands/rclone_serve_http/ )/[WebDav](/commands/rclone_serve_webdav/)/[FTP](/commands/rclone_serve_ftp/)/[SFTP](/commands/rclone_serve_sftp/)/[dlna](/commands/rclone_serve_dlna/)
- Experimental [Web based GUI ](/gui/ )
## Supported providers {#providers}
2020-05-28 18:28:30 +08:00
(There are many others, built on standard protocols such as
2020-05-27 00:12:52 +08:00
WebDAV or S3, that work out of the box.)
2017-09-26 00:55:19 +08:00
2020-05-22 23:45:37 +08:00
{{< provider_list > }}
2020-05-22 00:27:37 +08:00
{{< provider name = "1Fichier" home = "https://1fichier.com/" config = "/fichier/" start = "true" > }}
{{< provider name = "Alibaba Cloud (Aliyun) Object Storage System (OSS)" home = "https://www.alibabacloud.com/product/oss/" config = "/s3/#alibaba-oss" > }}
{{< provider name = "Amazon Drive" home = "https://www.amazon.com/clouddrive" config = "/amazonclouddrive/" note = "#status" > }}
{{< provider name = "Amazon S3" home = "https://aws.amazon.com/s3/" config = "/s3/" > }}
{{< provider name = "Backblaze B2" home = "https://www.backblaze.com/b2/cloud-storage.html" config = "/b2/" > }}
{{< provider name = "Box" home = "https://www.box.com/" config = "/box/" > }}
{{< provider name = "Ceph" home = "http://ceph.com/" config = "/s3/#ceph" > }}
{{< provider name = "Citrix ShareFile" home = "http://sharefile.com/" config = "/sharefile/" > }}
{{< provider name = "C14" home = "https://www.online.net/en/storage/c14-cold-storage" config = "/sftp/#c14" > }}
{{< provider name = "DigitalOcean Spaces" home = "https://www.digitalocean.com/products/object-storage/" config = "/s3/#digitalocean-spaces" > }}
{{< provider name = "Dreamhost" home = "https://www.dreamhost.com/cloud/storage/" config = "/s3/#dreamhost" > }}
{{< provider name = "Dropbox" home = "https://www.dropbox.com/" config = "/dropbox/" > }}
2020-08-11 22:09:00 +08:00
{{< provider name = "Enterprise File Fabric" home = "https://storagemadeeasy.com/about/" config = "/filefabric/" > }}
2020-05-22 00:27:37 +08:00
{{< provider name = "FTP" home = "https://en.wikipedia.org/wiki/File_Transfer_Protocol" config = "/ftp/" > }}
{{< provider name = "Google Cloud Storage" home = "https://cloud.google.com/storage/" config = "/googlecloudstorage/" > }}
{{< provider name = "Google Drive" home = "https://www.google.com/drive/" config = "/drive/" > }}
{{< provider name = "Google Photos" home = "https://www.google.com/photos/about/" config = "/googlephotos/" > }}
2020-09-29 01:29:44 +08:00
{{< provider name = "HDFS" home = "https://hadoop.apache.org/" config = "/hdfs/" > }}
2020-05-22 00:27:37 +08:00
{{< provider name = "HTTP" home = "https://en.wikipedia.org/wiki/Hypertext_Transfer_Protocol" config = "/http/" > }}
{{< provider name = "Hubic" home = "https://hubic.com/" config = "/hubic/" > }}
{{< provider name = "Jottacloud" home = "https://www.jottacloud.com/en/" config = "/jottacloud/" > }}
{{< provider name = "IBM COS S3" home = "http://www.ibm.com/cloud/object-storage" config = "/s3/#ibm-cos-s3" > }}
{{< provider name = "Koofr" home = "https://koofr.eu/" config = "/koofr/" > }}
{{< provider name = "Mail.ru Cloud" home = "https://cloud.mail.ru/" config = "/mailru/" > }}
{{< provider name = "Memset Memstore" home = "https://www.memset.com/cloud/storage/" config = "/swift/" > }}
{{< provider name = "Mega" home = "https://mega.nz/" config = "/mega/" > }}
{{< provider name = "Memory" home = "/memory/" config = "/memory/" > }}
{{< provider name = "Microsoft Azure Blob Storage" home = "https://azure.microsoft.com/en-us/services/storage/blobs/" config = "/azureblob/" > }}
{{< provider name = "Microsoft OneDrive" home = "https://onedrive.live.com/" config = "/onedrive/" > }}
{{< provider name = "Minio" home = "https://www.minio.io/" config = "/s3/#minio" > }}
{{< provider name = "Nextcloud" home = "https://nextcloud.com/" config = "/webdav/#nextcloud" > }}
{{< provider name = "OVH" home = "https://www.ovh.co.uk/public-cloud/storage/object-storage/" config = "/swift/" > }}
{{< provider name = "OpenDrive" home = "https://www.opendrive.com/" config = "/opendrive/" > }}
{{< provider name = "OpenStack Swift" home = "https://docs.openstack.org/swift/latest/" config = "/swift/" > }}
{{< provider name = "Oracle Cloud Storage" home = "https://cloud.oracle.com/storage-opc" config = "/swift/" > }}
{{< provider name = "ownCloud" home = "https://owncloud.org/" config = "/webdav/#owncloud" > }}
{{< provider name = "pCloud" home = "https://www.pcloud.com/" config = "/pcloud/" > }}
{{< provider name = "premiumize.me" home = "https://premiumize.me/" config = "/premiumizeme/" > }}
{{< provider name = "put.io" home = "https://put.io/" config = "/putio/" > }}
{{< provider name = "QingStor" home = "https://www.qingcloud.com/products/storage" config = "/qingstor/" > }}
{{< provider name = "Rackspace Cloud Files" home = "https://www.rackspace.com/cloud/files" config = "/swift/" > }}
{{< provider name = "rsync.net" home = "https://rsync.net/products/rclone.html" config = "/sftp/#rsync-net" > }}
{{< provider name = "Scaleway" home = "https://www.scaleway.com/object-storage/" config = "/s3/#scaleway" > }}
{{< provider name = "Seafile" home = "https://www.seafile.com/" config = "/seafile/" > }}
{{< provider name = "SFTP" home = "https://en.wikipedia.org/wiki/SSH_File_Transfer_Protocol" config = "/sftp/" > }}
{{< provider name = "StackPath" home = "https://www.stackpath.com/products/object-storage/" config = "/s3/#stackpath" > }}
{{< provider name = "SugarSync" home = "https://sugarsync.com/" config = "/sugarsync/" > }}
{{< provider name = "Tardigrade" home = "https://tardigrade.io/" config = "/tardigrade/" > }}
2020-09-08 23:34:25 +08:00
{{< provider name = "Tencent Cloud Object Storage (COS)" home = "https://intl.cloud.tencent.com/product/cos" config = "/s3/#tencent-cos" > }}
2020-05-22 00:27:37 +08:00
{{< provider name = "Wasabi" home = "https://wasabi.com/" config = "/s3/#wasabi" > }}
{{< provider name = "WebDAV" home = "https://en.wikipedia.org/wiki/WebDAV" config = "/webdav/" > }}
{{< provider name = "Yandex Disk" home = "https://disk.yandex.com/" config = "/yandex/" > }}
2020-10-08 06:17:50 +08:00
{{< provider name = "Zoho WorkDrive" home = "https://www.zoho.com/workdrive/" config = "/zoho/" > }}
2020-05-22 00:27:37 +08:00
{{< provider name = "The local filesystem" home = "/local/" config = "/local/" end = "true" > }}
2020-05-22 23:45:37 +08:00
{{< / provider_list > }}
2014-03-29 06:34:13 +08:00
Links
2020-05-22 19:22:52 +08:00
* {{< icon " fa fa-home " > }} [Home page ](https://rclone.org/ )
* {{< icon " fab fa-github " > }} [GitHub project page for source and bug tracker ](https://github.com/rclone/rclone )
* {{< icon " fa fa-comments " > }} [Rclone Forum ](https://forum.rclone.org )
* {{< icon " fas fa-cloud-download-alt " > }}[Downloads](/downloads/)
