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-10-31 01:33:04 +08:00
notoc: true
2014-03-29 06:34:13 +08:00
---
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}
2021-11-04 19:50:43 +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
2023-07-06 23:11:53 +08:00
interfaces. [Over 70 cloud storage products ](#providers ) support
2020-05-27 00:12:52 +08:00
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
2021-11-04 19:50:43 +08:00
[encryption ](/crypt/ ),
2021-10-12 20:16:58 +08:00
[compression ](/compress/ ),
[chunking ](/chunker/ ),
[hashing ](/hasher/ ) and
2020-05-18 00:56:23 +08:00
[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/ ).
2021-11-04 19:50:43 +08:00
Rclone is mature, open-source software originally inspired by rsync
2020-05-27 00:12:52 +08:00
and written in [Go ](https://golang.org ). The friendly support
2021-11-04 19:50:43 +08:00
community is familiar with varied use cases. Official Ubuntu, Debian,
2020-05-27 00:12:52 +08:00
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
2021-11-04 19:50:43 +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
2021-11-04 19:50:43 +08:00
- Migrate data to the cloud, or between cloud storage vendors
2020-05-23 00:46:05 +08:00
- 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
2022-06-20 00:59:54 +08:00
- [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/)
2020-05-18 00:56:23 +08:00
- 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" > }}
2021-10-15 06:01:46 +08:00
{{< provider name = "Akamai Netstorage" home = "https://www.akamai.com/us/en/products/media-delivery/netstorage.jsp" config = "/netstorage/" > }}
2020-05-22 00:27:37 +08:00
{{< 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" > }}
2022-03-24 19:57:00 +08:00
{{< provider name = "China Mobile Ecloud Elastic Object Storage (EOS)" home = "https://ecloud.10086.cn/home/product-introduction/eos/" config = "/s3/#china-mobile-ecloud-eos" > }}
2023-06-17 19:47:23 +08:00
{{< provider name = "Arvan Cloud Object Storage (AOS)" home = "https://www.arvancloud.ir/en/products/cloud-storage" config = "/s3/#arvan-cloud-object-storage-aos" > }}
2020-05-22 00:27:37 +08:00
{{< provider name = "Citrix ShareFile" home = "http://sharefile.com/" config = "/sharefile/" > }}
2022-05-06 19:09:29 +08:00
{{< provider name = "Cloudflare R2" home = "https://blog.cloudflare.com/r2-open-beta/" config = "/s3/#cloudflare-r2" > }}
2020-05-22 00:27:37 +08:00
{{< provider name = "DigitalOcean Spaces" home = "https://www.digitalocean.com/products/object-storage/" config = "/s3/#digitalocean-spaces" > }}
2022-03-08 18:56:53 +08:00
{{< provider name = "Digi Storage" home = "https://storage.rcs-rds.ro/" config = "/koofr/#digi-storage" > }}
2020-05-22 00:27:37 +08:00
{{< 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/" > }}
2023-03-13 12:45:54 +08:00
{{< provider name = "Fastmail Files" home = "https://www.fastmail.com/" config = "/webdav/#fastmail-files" > }}
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/" > }}
2022-07-04 14:54:37 +08:00
{{< provider name = "Hetzner Storage Box" home = "https://www.hetzner.com/storage/storage-box" config = "/sftp/#hetzner-storage-box" > }}
2022-07-08 01:58:22 +08:00
{{< provider name = "HiDrive" home = "https://www.strato.de/cloud-speicher/" config = "/hidrive/" > }}
2020-05-22 00:27:37 +08:00
{{< provider name = "HTTP" home = "https://en.wikipedia.org/wiki/Hypertext_Transfer_Protocol" config = "/http/" > }}
2022-04-12 17:38:44 +08:00
{{< provider name = "Internet Archive" home = "https://archive.org/" config = "/internetarchive/" > }}
2020-05-22 00:27:37 +08:00
{{< 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" > }}
2023-03-10 23:39:41 +08:00
{{< provider name = "IDrive e2" home = "https://www.idrive.com/e2/?refer=rclone" config = "/s3/#idrive-e2" > }}
2022-09-15 23:04:34 +08:00
{{< provider name = "IONOS Cloud" home = "https://cloud.ionos.com/storage/object-storage" config = "/s3/#ionos" > }}
2020-05-22 00:27:37 +08:00
{{< provider name = "Koofr" home = "https://koofr.eu/" config = "/koofr/" > }}
2023-07-17 22:03:00 +08:00
{{< provider name = "Leviia Object Storage" home = "https://www.leviia.com/object-storage" config = "/s3/#leviia" > }}
2022-12-06 20:25:23 +08:00
{{< provider name = "Liara Object Storage" home = "https://liara.ir/landing/object-storage" config = "/s3/#liara-object-storage" > }}
2023-10-20 19:35:56 +08:00
{{< provider name = "Linkbox" home = "https://linkbox.to/" config = "/linkbox/" > }}
2023-09-21 19:38:06 +08:00
{{< provider name = "Linode Object Storage" home = "https://www.linode.com/products/object-storage/" config = "/s3/#linode" > }}
2020-05-22 00:27:37 +08:00
{{< 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/" > }}
2023-11-15 17:37:57 +08:00
{{< provider name = "Microsoft Azure Files Storage" home = "https://azure.microsoft.com/en-us/services/storage/files/" config = "/azurefiles/" > }}
2020-05-22 00:27:37 +08:00
{{< 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/" > }}
2023-05-19 22:00:17 +08:00
{{< provider name = "Blomp Cloud Storage" home = "https://rclone.org/swift/" config = "/swift/" > }}
2020-05-22 00:27:37 +08:00
{{< provider name = "OpenDrive" home = "https://www.opendrive.com/" config = "/opendrive/" > }}
{{< provider name = "OpenStack Swift" home = "https://docs.openstack.org/swift/latest/" config = "/swift/" > }}
2022-10-21 03:24:19 +08:00
{{< provider name = "Oracle Cloud Storage Swift" home = "https://docs.oracle.com/en-us/iaas/integration/doc/configure-object-storage.html" config = "/swift/" > }}
{{< provider name = "Oracle Object Storage" home = "https://www.oracle.com/cloud/storage/object-storage" config = "/oracleobjectstorage/" > }}
2020-05-22 00:27:37 +08:00
{{< provider name = "ownCloud" home = "https://owncloud.org/" config = "/webdav/#owncloud" > }}
{{< provider name = "pCloud" home = "https://www.pcloud.com/" config = "/pcloud/" > }}
2023-05-05 16:44:25 +08:00
{{< provider name = "Petabox" home = "https://petabox.io/" config = "/s3/#petabox" > }}
2023-04-04 23:33:48 +08:00
{{< provider name = "PikPak" home = "https://mypikpak.com/" config = "/pikpak/" > }}
2020-05-22 00:27:37 +08:00
{{< provider name = "premiumize.me" home = "https://premiumize.me/" config = "/premiumizeme/" > }}
{{< provider name = "put.io" home = "https://put.io/" config = "/putio/" > }}
2023-09-10 18:55:37 +08:00
{{< provider name = "Proton Drive" home = "https://proton.me/drive" config = "/protondrive/" > }}
2020-05-22 00:27:37 +08:00
{{< provider name = "QingStor" home = "https://www.qingcloud.com/products/storage" config = "/qingstor/" > }}
2022-10-13 22:49:22 +08:00
{{< provider name = "Qiniu Cloud Object Storage (Kodo)" home = "https://www.qiniu.com/en/products/kodo" config = "/s3/#qiniu" > }}
2023-09-08 21:31:29 +08:00
{{< provider name = "Quatrix by Maytech" home = "https://www.maytech.net/products/quatrix-business" config = "/quatrix/" > }}
2020-05-22 00:27:37 +08:00
{{< 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/" > }}
2022-03-04 20:35:46 +08:00
{{< provider name = "Seagate Lyve Cloud" home = "https://www.seagate.com/gb/en/services/cloud/storage/" config = "/s3/#lyve" > }}
2021-06-08 16:59:57 +08:00
{{< provider name = "SeaweedFS" home = "https://github.com/chrislusf/seaweedfs/" config = "/s3/#seaweedfs" > }}
2020-05-22 00:27:37 +08:00
{{< provider name = "SFTP" home = "https://en.wikipedia.org/wiki/SSH_File_Transfer_Protocol" config = "/sftp/" > }}
2021-10-10 20:24:23 +08:00
{{< provider name = "Sia" home = "https://sia.tech/" config = "/sia/" > }}
2022-09-30 23:10:57 +08:00
{{< provider name = "SMB / CIFS" home = "https://en.wikipedia.org/wiki/Server_Message_Block" config = "/smb/" > }}
2020-05-22 00:27:37 +08:00
{{< provider name = "StackPath" home = "https://www.stackpath.com/products/object-storage/" config = "/s3/#stackpath" > }}
2022-02-05 01:58:04 +08:00
{{< provider name = "Storj" home = "https://storj.io/" config = "/storj/" > }}
2023-07-06 17:54:07 +08:00
{{< provider name = "Synology" home = "https://c2.synology.com/en-global/object-storage/overview" config = "/s3/#synology-c2" > }}
2020-05-22 00:27:37 +08:00
{{< provider name = "SugarSync" home = "https://sugarsync.com/" config = "/sugarsync/" > }}
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" > }}
2021-04-09 22:57:24 +08:00
{{< provider name = "Uptobox" home = "https://uptobox.com" config = "/uptobox/" > }}
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
2022-04-21 00:57:43 +08:00
## Virtual providers
These backends adapt or modify other storage providers:
2022-06-20 01:43:16 +08:00
{{< provider name = "Alias: Rename existing remotes" home = "/alias/" config = "/alias/" > }}
{{< provider name = "Cache: Cache remotes (DEPRECATED)" home = "/cache/" config = "/cache/" > }}
{{< provider name = "Chunker: Split large files" home = "/chunker/" config = "/chunker/" > }}
{{< provider name = "Combine: Combine multiple remotes into a directory tree" home = "/combine/" config = "/combine/" > }}
{{< provider name = "Compress: Compress files" home = "/compress/" config = "/compress/" > }}
{{< provider name = "Crypt: Encrypt files" home = "/crypt/" config = "/crypt/" > }}
{{< provider name = "Hasher: Hash files" home = "/hasher/" config = "/hasher/" > }}
{{< provider name = "Union: Join multiple remotes to work together" home = "/union/" config = "/union/" > }}
2022-04-21 00:57:43 +08:00
2022-05-14 06:06:45 +08:00
## Links
2014-03-29 06:34:13 +08:00
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/)
