2016-08-03 20:36:28 +00:00
---
2018-06-16 17:21:09 +00:00
date: 2018-06-16T18:20:28+01:00
2016-08-03 20:36:28 +00:00
title: "rclone"
slug: rclone
url: /commands/rclone/
---
## rclone
2018-06-16 17:21:09 +00:00
Sync files and directories to and from local and remote object stores - v1.42
2016-08-03 20:36:28 +00:00
### Synopsis
Rclone is a command line program to sync files and directories to and
2017-06-15 19:12:26 +00:00
from various cloud storage systems and using file transfer services, such as:
2016-08-03 20:36:28 +00:00
2017-09-30 13:19:47 +00:00
* Amazon Drive
2016-08-03 20:36:28 +00:00
* Amazon S3
2017-09-30 13:19:47 +00:00
* Backblaze B2
* Box
2016-08-03 20:36:28 +00:00
* Dropbox
2017-09-30 13:19:47 +00:00
* FTP
2016-08-03 20:36:28 +00:00
* Google Cloud Storage
2017-09-30 13:19:47 +00:00
* Google Drive
* HTTP
2016-08-03 20:36:28 +00:00
* Hubic
2018-04-28 10:46:27 +00:00
* Mega
2017-09-30 13:19:47 +00:00
* Microsoft Azure Blob Storage
* Microsoft OneDrive
2018-06-16 17:21:09 +00:00
* OpenDrive
2017-09-30 13:19:47 +00:00
* Openstack Swift / Rackspace cloud files / Memset Memstore
2017-12-23 13:07:45 +00:00
* pCloud
2017-09-30 13:19:47 +00:00
* QingStor
2017-06-15 19:12:26 +00:00
* SFTP
2017-12-23 13:07:45 +00:00
* Webdav / Owncloud / Nextcloud
2017-09-30 13:19:47 +00:00
* Yandex Disk
2016-08-03 20:36:28 +00:00
* The local filesystem
Features
* MD5/SHA1 hashes checked at all times for file integrity
* Timestamps preserved on files
* Partial syncs supported on a whole file basis
* Copy mode to just copy new/changed files
* Sync (one way) mode to make a directory identical
* Check mode to check for file hash equality
* Can sync to and from network, eg two different cloud accounts
See the home page for installation, usage, documentation, changelog
and configuration walkthroughs.
2017-03-29 09:06:22 +00:00
* https://rclone.org/
2016-08-03 20:36:28 +00:00
```
2017-06-15 19:12:26 +00:00
rclone [flags]
2016-08-03 20:36:28 +00:00
```
### Options
```
2017-12-23 13:07:45 +00:00
--acd-templink-threshold int Files >= this size will be downloaded via their tempLink. (default 9G)
--acd-upload-wait-per-gb duration Additional time per GB to wait after a failed complete upload to see if it appears. (default 3m0s)
--ask-password Allow prompt for password for encrypted configuration. (default true)
--auto-confirm If enabled, do not request console confirmation.
--azureblob-chunk-size int Upload chunk size. Must fit in memory. (default 4M)
--azureblob-upload-cutoff int Cutoff for switching to chunked upload (default 256M)
--b2-chunk-size int Upload chunk size. Must fit in memory. (default 96M)
--b2-hard-delete Permanently delete files on remote removal, otherwise hide files.
--b2-test-mode string A flag string for X-Bz-Test-Mode header.
--b2-upload-cutoff int Cutoff for switching to chunked upload (default 190.735M)
--b2-versions Include old versions in directory listings.
--backup-dir string Make backups into hierarchy based in DIR.
--bind string Local address to bind to for outgoing connections, IPv4, IPv6 or name.
--box-upload-cutoff int Cutoff for switching to multipart upload (default 50M)
--buffer-size int Buffer size when copying files. (default 16M)
--bwlimit BwTimetable Bandwidth limit in kBytes/s, or use suffix b|k|M|G or a full timetable.
--cache-chunk-clean-interval string Interval at which chunk cleanup runs (default "1m")
--cache-chunk-no-memory Disable the in-memory cache for storing chunks during streaming
--cache-chunk-path string Directory to cached chunk files (default "/home/ncw/.cache/rclone/cache-backend")
--cache-chunk-size string The size of a chunk (default "5M")
--cache-db-path string Directory to cache DB (default "/home/ncw/.cache/rclone/cache-backend")
--cache-db-purge Purge the cache DB before
2018-03-19 10:06:13 +00:00
--cache-db-wait-time duration How long to wait for the DB to be available - 0 is unlimited (default 1s)
2017-12-23 13:07:45 +00:00
--cache-dir string Directory rclone will use for caching. (default "/home/ncw/.cache/rclone")
--cache-info-age string How much time should object info be stored in cache (default "6h")
--cache-read-retries int How many times to retry a read from a cache storage (default 10)
--cache-rps int Limits the number of requests per second to the source FS. -1 disables the rate limiter (default -1)
2018-03-19 10:06:13 +00:00
--cache-tmp-upload-path string Directory to keep temporary files until they are uploaded to the cloud storage
--cache-tmp-wait-time string How long should files be stored in local cache before being uploaded (default "15m")
2017-12-23 13:07:45 +00:00
--cache-total-chunk-size string The total size which the chunks can take up from the disk (default "10G")
--cache-workers int How many workers should run in parallel to download chunks (default 4)
--cache-writes Will cache file data on writes through the FS
--checkers int Number of checkers to run in parallel. (default 8)
-c, --checksum Skip based on checksum & size, not mod-time & size
--config string Config file. (default "/home/ncw/.rclone.conf")
--contimeout duration Connect timeout (default 1m0s)
-L, --copy-links Follow symlinks and copy the pointed to item.
--cpuprofile string Write cpu profile to file
--crypt-show-mapping For all files listed show how the names encrypt.
--delete-after When synchronizing, delete files on destination after transfering
--delete-before When synchronizing, delete files on destination before transfering
--delete-during When synchronizing, delete files during transfer (default)
--delete-excluded Delete files on dest excluded from sync
--disable string Disable a comma separated list of features. Use help to see a list.
2018-06-16 17:21:09 +00:00
--drive-acknowledge-abuse Set to allow files which return cannotDownloadAbusiveFile to be downloaded.
--drive-alternate-export Use alternate export URLs for google documents export.
2017-12-23 13:07:45 +00:00
--drive-auth-owner-only Only consider files owned by the authenticated user.
--drive-chunk-size int Upload chunk size. Must a power of 2 >= 256k. (default 8M)
--drive-formats string Comma separated list of preferred formats for downloading Google docs. (default "docx,xlsx,pptx,svg")
2018-03-19 10:06:13 +00:00
--drive-impersonate string Impersonate this user when using a service account.
2017-12-23 13:07:45 +00:00
--drive-list-chunk int Size of listing chunk 100-1000. 0 to disable. (default 1000)
--drive-shared-with-me Only show files that are shared with me
--drive-skip-gdocs Skip google documents in all listings.
--drive-trashed-only Only show files that are in the trash
--drive-upload-cutoff int Cutoff for switching to chunked upload (default 8M)
2018-03-19 10:06:13 +00:00
--drive-use-created-date Use created date instead of modified date.
2017-12-23 13:07:45 +00:00
--drive-use-trash Send files to the trash instead of deleting permanently. (default true)
--dropbox-chunk-size int Upload chunk size. Max 150M. (default 48M)
-n, --dry-run Do a trial run with no permanent changes
2018-04-28 10:46:27 +00:00
--dump string List of items to dump from: headers,bodies,requests,responses,auth,filters,goroutines,openfiles
2017-12-23 13:07:45 +00:00
--dump-bodies Dump HTTP headers and bodies - may contain sensitive info
2018-03-19 10:06:13 +00:00
--dump-headers Dump HTTP bodies - may contain sensitive info
2017-12-23 13:07:45 +00:00
--exclude stringArray Exclude files matching pattern
--exclude-from stringArray Read exclude patterns from file
--exclude-if-present string Exclude directories if filename is present
--fast-list Use recursive list if available. Uses more memory but fewer transactions.
--files-from stringArray Read list of source-file names from file
-f, --filter stringArray Add a file-filtering rule
--filter-from stringArray Read filtering patterns from a file
--gcs-location string Default location for buckets (us|eu|asia|us-central1|us-east1|us-east4|us-west1|asia-east1|asia-noetheast1|asia-southeast1|australia-southeast1|europe-west1|europe-west2).
--gcs-storage-class string Default storage class for buckets (MULTI_REGIONAL|REGIONAL|STANDARD|NEARLINE|COLDLINE|DURABLE_REDUCED_AVAILABILITY).
-h, --help help for rclone
--ignore-checksum Skip post copy check of checksums.
2018-04-28 10:46:27 +00:00
--ignore-errors delete even if there are I/O errors
2017-12-23 13:07:45 +00:00
--ignore-existing Skip all files that exist on destination
--ignore-size Ignore size when skipping use mod-time or checksum.
-I, --ignore-times Don't skip files that match size and time - transfer all files
--immutable Do not modify files. Fail if existing files have been modified.
--include stringArray Include files matching pattern
--include-from stringArray Read include patterns from file
2018-04-28 10:46:27 +00:00
--local-no-check-updated Don't check to see if the files change during upload
2017-12-23 13:07:45 +00:00
--local-no-unicode-normalization Don't apply unicode normalization to paths and filenames
--log-file string Log everything to this file
--log-level string Log level DEBUG|INFO|NOTICE|ERROR (default "NOTICE")
--low-level-retries int Number of low level retries to do. (default 10)
2018-04-28 10:46:27 +00:00
--max-age duration Only transfer files younger than this in s or suffix ms|s|m|h|d|w|M|y (default off)
2018-03-19 10:06:13 +00:00
--max-delete int When synchronizing, limit the number of deletes (default -1)
2017-12-23 13:07:45 +00:00
--max-depth int If set limits the recursion depth to this. (default -1)
2018-04-28 10:46:27 +00:00
--max-size int Only transfer files smaller than this in k or suffix b|k|M|G (default off)
2018-06-16 17:21:09 +00:00
--max-transfer int Maximum size of data to transfer. (default off)
2018-04-28 10:46:27 +00:00
--mega-debug If set then output more debug from mega.
2017-12-23 13:07:45 +00:00
--memprofile string Write memory profile to file
2018-04-28 10:46:27 +00:00
--min-age duration Only transfer files older than this in s or suffix ms|s|m|h|d|w|M|y (default off)
--min-size int Only transfer files bigger than this in k or suffix b|k|M|G (default off)
2017-12-23 13:07:45 +00:00
--modify-window duration Max time diff to be considered the same (default 1ns)
--no-check-certificate Do not verify the server SSL certificate. Insecure.
--no-gzip-encoding Don't set Accept-Encoding: gzip.
2018-03-19 10:06:13 +00:00
--no-traverse Obsolete - does nothing.
2017-12-23 13:07:45 +00:00
--no-update-modtime Don't update destination mod-time if files identical.
-x, --one-file-system Don't cross filesystem boundaries.
--onedrive-chunk-size int Above this size files will be chunked - must be multiple of 320k. (default 10M)
-q, --quiet Print as little stuff as possible
2018-03-19 10:06:13 +00:00
--rc Enable the remote control server.
--rc-addr string IPaddress:Port or :Port to bind server to. (default "localhost:5572")
--rc-cert string SSL PEM key (concatenation of certificate and CA certificate)
--rc-client-ca string Client certificate authority to verify clients with
--rc-htpasswd string htpasswd file - if not provided no authentication is done
--rc-key string SSL PEM Private key
--rc-max-header-bytes int Maximum size of request header (default 4096)
--rc-pass string Password for authentication.
--rc-realm string realm for authentication (default "rclone")
--rc-server-read-timeout duration Timeout for server reading data (default 1h0m0s)
--rc-server-write-timeout duration Timeout for server writing data (default 1h0m0s)
--rc-user string User name for authentication.
2017-12-23 13:07:45 +00:00
--retries int Retry operations this many times if they fail (default 3)
2018-06-16 17:21:09 +00:00
--retries-sleep duration Interval between retrying operations if they fail, e.g 500ms, 60s, 5m. (0 to disable)
2017-12-23 13:07:45 +00:00
--s3-acl string Canned ACL used when creating buckets and/or storing objects in S3
2018-04-28 10:46:27 +00:00
--s3-chunk-size int Chunk size to use for uploading (default 5M)
--s3-disable-checksum Don't store MD5 checksum with object metadata
--s3-storage-class string Storage class to use when uploading S3 objects (STANDARD|REDUCED_REDUNDANCY|STANDARD_IA|ONEZONE_IA)
2018-06-16 17:21:09 +00:00
--s3-upload-concurrency int Concurrency for multipart uploads (default 2)
2018-03-19 10:06:13 +00:00
--sftp-ask-password Allow asking for SFTP password when needed.
2017-12-23 13:07:45 +00:00
--size-only Skip based on size only, not mod-time or checksum
--skip-links Don't warn about skipped symlinks.
2018-06-16 17:21:09 +00:00
--ssh-path-override string Override path used by SSH connection.
2017-12-23 13:07:45 +00:00
--stats duration Interval between printing stats, e.g 500ms, 60s, 5m. (0 to disable) (default 1m0s)
2018-03-19 10:06:13 +00:00
--stats-file-name-length int Max file name length in stats. 0 for no limit (default 40)
2017-12-23 13:07:45 +00:00
--stats-log-level string Log level to show --stats output DEBUG|INFO|NOTICE|ERROR (default "INFO")
--stats-unit string Show data rate in stats as either 'bits' or 'bytes'/s (default "bytes")
--streaming-upload-cutoff int Cutoff for switching to chunked upload if file size is unknown. Upload starts after reaching cutoff or when file ends. (default 100k)
--suffix string Suffix for use with --backup-dir.
--swift-chunk-size int Above this size files will be chunked into a _segments container. (default 5G)
--syslog Use Syslog for logging
--syslog-facility string Facility for syslog, eg KERN,USER,... (default "DAEMON")
--timeout duration IO idle timeout (default 5m0s)
--tpslimit float Limit HTTP transactions per second to this.
--tpslimit-burst int Max burst of transactions for --tpslimit. (default 1)
--track-renames When synchronizing, track file renames and do a server side move if possible
--transfers int Number of file transfers to run in parallel. (default 4)
-u, --update Skip files that are newer on the destination.
2018-04-28 10:46:27 +00:00
--use-server-modtime Use server modified time instead of object metadata
2018-06-16 17:21:09 +00:00
--user-agent string Set the user-agent to a specified string. The default is rclone/ version (default "rclone/v1.42")
2018-03-19 10:06:13 +00:00
-v, --verbose count Print lots more stuff (repeat for more)
2017-12-23 13:07:45 +00:00
-V, --version Print the version number
2016-08-03 20:36:28 +00:00
```
### SEE ALSO
2018-03-19 10:06:13 +00:00
2018-04-28 10:46:27 +00:00
* [rclone about ](/commands/rclone_about/ ) - Get quota information from the remote.
2016-08-03 20:36:28 +00:00
* [rclone authorize ](/commands/rclone_authorize/ ) - Remote authorization.
2017-12-23 13:07:45 +00:00
* [rclone cachestats ](/commands/rclone_cachestats/ ) - Print cache stats for a remote
2016-08-24 21:58:24 +00:00
* [rclone cat ](/commands/rclone_cat/ ) - Concatenates any files and sends them to stdout.
2016-08-03 20:36:28 +00:00
* [rclone check ](/commands/rclone_check/ ) - Checks the files in the source and destination match.
* [rclone cleanup ](/commands/rclone_cleanup/ ) - Clean up the remote if possible
* [rclone config ](/commands/rclone_config/ ) - Enter an interactive configuration session.
* [rclone copy ](/commands/rclone_copy/ ) - Copy files from source to dest, skipping already copied
2017-01-02 15:30:34 +00:00
* [rclone copyto ](/commands/rclone_copyto/ ) - Copy files from source to dest, skipping already copied
2017-07-22 17:16:46 +00:00
* [rclone cryptcheck ](/commands/rclone_cryptcheck/ ) - Cryptcheck checks the integrity of a crypted remote.
2017-09-30 13:19:47 +00:00
* [rclone cryptdecode ](/commands/rclone_cryptdecode/ ) - Cryptdecode returns unencrypted file names.
2017-12-23 13:07:45 +00:00
* [rclone dbhashsum ](/commands/rclone_dbhashsum/ ) - Produces a Dropbox hash file for all the objects in the path.
* [rclone dedupe ](/commands/rclone_dedupe/ ) - Interactively find duplicate files and delete/rename them.
2016-08-03 20:36:28 +00:00
* [rclone delete ](/commands/rclone_delete/ ) - Remove the contents of path.
2018-06-16 17:21:09 +00:00
* [rclone deletefile ](/commands/rclone_deletefile/ ) - Remove a single file path from remote.
2017-08-31 14:52:51 +00:00
* [rclone genautocomplete ](/commands/rclone_genautocomplete/ ) - Output completion script for a given shell.
2016-08-03 20:36:28 +00:00
* [rclone gendocs ](/commands/rclone_gendocs/ ) - Output markdown docs for rclone to the directory supplied.
2018-04-28 10:46:27 +00:00
* [rclone hashsum ](/commands/rclone_hashsum/ ) - Produces an hashsum file for all the objects in the path.
* [rclone link ](/commands/rclone_link/ ) - Generate public link to file/folder.
2016-11-06 10:17:52 +00:00
* [rclone listremotes ](/commands/rclone_listremotes/ ) - List all the remotes in the config file.
2018-03-19 10:06:13 +00:00
* [rclone ls ](/commands/rclone_ls/ ) - List the objects in the path with size and path.
2016-12-31 17:20:31 +00:00
* [rclone lsd ](/commands/rclone_lsd/ ) - List all directories/containers/buckets in the path.
2018-03-19 10:06:13 +00:00
* [rclone lsf ](/commands/rclone_lsf/ ) - List directories and objects in remote:path formatted for parsing
2017-06-15 19:12:26 +00:00
* [rclone lsjson ](/commands/rclone_lsjson/ ) - List directories and objects in the path in JSON format.
2018-03-19 10:06:13 +00:00
* [rclone lsl ](/commands/rclone_lsl/ ) - List the objects in path with modification time, size and path.
2016-08-03 20:36:28 +00:00
* [rclone md5sum ](/commands/rclone_md5sum/ ) - Produces an md5sum file for all the objects in the path.
* [rclone mkdir ](/commands/rclone_mkdir/ ) - Make the path if it doesn't already exist.
2016-08-24 21:58:24 +00:00
* [rclone mount ](/commands/rclone_mount/ ) - Mount the remote as a mountpoint. **EXPERIMENTAL**
2016-08-03 20:36:28 +00:00
* [rclone move ](/commands/rclone_move/ ) - Move files from source to dest.
2017-01-02 15:30:34 +00:00
* [rclone moveto ](/commands/rclone_moveto/ ) - Move file or directory from source to dest.
2017-06-15 19:12:26 +00:00
* [rclone ncdu ](/commands/rclone_ncdu/ ) - Explore a remote with a text based user interface.
2017-03-18 11:16:43 +00:00
* [rclone obscure ](/commands/rclone_obscure/ ) - Obscure password for use in the rclone.conf
2016-08-03 20:36:28 +00:00
* [rclone purge ](/commands/rclone_purge/ ) - Remove the path and all of its contents.
2018-03-19 10:06:13 +00:00
* [rclone rc ](/commands/rclone_rc/ ) - Run a command against a running rclone.
2017-09-30 13:19:47 +00:00
* [rclone rcat ](/commands/rclone_rcat/ ) - Copies standard input to file on remote.
2016-08-03 20:36:28 +00:00
* [rclone rmdir ](/commands/rclone_rmdir/ ) - Remove the path if empty.
2017-07-21 17:17:57 +00:00
* [rclone rmdirs ](/commands/rclone_rmdirs/ ) - Remove empty directories under the path.
2017-12-23 13:07:45 +00:00
* [rclone serve ](/commands/rclone_serve/ ) - Serve a remote over a protocol.
2016-08-03 20:36:28 +00:00
* [rclone sha1sum ](/commands/rclone_sha1sum/ ) - Produces an sha1sum file for all the objects in the path.
* [rclone size ](/commands/rclone_size/ ) - Prints the total size and number of objects in remote:path.
* [rclone sync ](/commands/rclone_sync/ ) - Make source and dest identical, modifying destination only.
2017-12-23 13:07:45 +00:00
* [rclone touch ](/commands/rclone_touch/ ) - Create new file or change file modification time.
2017-09-30 13:19:47 +00:00
* [rclone tree ](/commands/rclone_tree/ ) - List the contents of the remote in a tree like fashion.
2016-08-03 20:36:28 +00:00
* [rclone version ](/commands/rclone_version/ ) - Show the version number.
2018-06-16 17:21:09 +00:00
###### Auto generated by spf13/cobra on 16-Jun-2018