mirror of
https://github.com/rclone/rclone.git
synced 2024-11-27 10:50:03 +08:00
618 lines
60 KiB
Markdown
618 lines
60 KiB
Markdown
---
|
|
title: "Global Flags"
|
|
description: "Rclone Global Flags"
|
|
---
|
|
|
|
# Global Flags
|
|
|
|
This describes the global flags available to every rclone command
|
|
split into two groups, non backend and backend flags.
|
|
|
|
## Non Backend Flags
|
|
|
|
These flags are available for every command.
|
|
|
|
```
|
|
--ask-password Allow prompt for password for encrypted configuration (default true)
|
|
--auto-confirm If enabled, do not request console confirmation
|
|
--backup-dir string Make backups into hierarchy based in DIR
|
|
--bind string Local address to bind to for outgoing connections, IPv4, IPv6 or name
|
|
--buffer-size SizeSuffix In memory buffer size when reading files for each --transfer (default 16Mi)
|
|
--bwlimit BwTimetable Bandwidth limit in KiB/s, or use suffix B|K|M|G|T|P or a full timetable
|
|
--bwlimit-file BwTimetable Bandwidth limit per file in KiB/s, or use suffix B|K|M|G|T|P or a full timetable
|
|
--ca-cert string CA certificate used to verify servers
|
|
--cache-dir string Directory rclone will use for caching (default "$HOME/.cache/rclone")
|
|
--check-first Do all the checks before starting transfers
|
|
--checkers int Number of checkers to run in parallel (default 8)
|
|
-c, --checksum Skip based on checksum (if available) & size, not mod-time & size
|
|
--client-cert string Client SSL certificate (PEM) for mutual TLS auth
|
|
--client-key string Client SSL private key (PEM) for mutual TLS auth
|
|
--compare-dest stringArray Include additional comma separated server-side paths during comparison
|
|
--config string Config file (default "$HOME/.config/rclone/rclone.conf")
|
|
--contimeout duration Connect timeout (default 1m0s)
|
|
--copy-dest stringArray Implies --compare-dest but also copies files from paths into destination
|
|
--cpuprofile string Write cpu profile to file
|
|
--cutoff-mode string Mode to stop transfers when reaching the max transfer limit HARD|SOFT|CAUTIOUS (default "HARD")
|
|
--delete-after When synchronizing, delete files on destination after transferring (default)
|
|
--delete-before When synchronizing, delete files on destination before transferring
|
|
--delete-during When synchronizing, delete files during transfer
|
|
--delete-excluded Delete files on dest excluded from sync
|
|
--disable string Disable a comma separated list of features (use --disable help to see a list)
|
|
--disable-http2 Disable HTTP/2 in the global transport
|
|
-n, --dry-run Do a trial run with no permanent changes
|
|
--dscp string Set DSCP value to connections, value or name, e.g. CS1, LE, DF, AF21
|
|
--dump DumpFlags List of items to dump from: headers,bodies,requests,responses,auth,filters,goroutines,openfiles
|
|
--dump-bodies Dump HTTP headers and bodies - may contain sensitive info
|
|
--dump-headers Dump HTTP headers - may contain sensitive info
|
|
--error-on-no-transfer Sets exit code 9 if no files are transferred, useful in scripts
|
|
--exclude stringArray Exclude files matching pattern
|
|
--exclude-from stringArray Read exclude patterns from file (use - to read from stdin)
|
|
--exclude-if-present string Exclude directories if filename is present
|
|
--expect-continue-timeout duration Timeout when using expect / 100-continue in HTTP (default 1s)
|
|
--fast-list Use recursive list if available; uses more memory but fewer transactions
|
|
--files-from stringArray Read list of source-file names from file (use - to read from stdin)
|
|
--files-from-raw stringArray Read list of source-file names from file without any processing of lines (use - to read from stdin)
|
|
-f, --filter stringArray Add a file-filtering rule
|
|
--filter-from stringArray Read filtering patterns from a file (use - to read from stdin)
|
|
--fs-cache-expire-duration duration Cache remotes for this long (0 to disable caching) (default 5m0s)
|
|
--fs-cache-expire-interval duration Interval to check for expired remotes (default 1m0s)
|
|
--header stringArray Set HTTP header for all transactions
|
|
--header-download stringArray Set HTTP header for download transactions
|
|
--header-upload stringArray Set HTTP header for upload transactions
|
|
--human-readable Print numbers in a human-readable format, sizes with suffix Ki|Mi|Gi|Ti|Pi
|
|
--ignore-case Ignore case in filters (case insensitive)
|
|
--ignore-case-sync Ignore case when synchronizing
|
|
--ignore-checksum Skip post copy check of checksums
|
|
--ignore-errors Delete even if there are I/O errors
|
|
--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 (use - to read from stdin)
|
|
-i, --interactive Enable interactive mode
|
|
--kv-lock-time duration Maximum time to keep key-value database locked by process (default 1s)
|
|
--log-file string Log everything to this file
|
|
--log-format string Comma separated list of log format options (default "date,time")
|
|
--log-level string Log level DEBUG|INFO|NOTICE|ERROR (default "NOTICE")
|
|
--log-systemd Activate systemd integration for the logger
|
|
--low-level-retries int Number of low level retries to do (default 10)
|
|
--max-age Duration Only transfer files younger than this in s or suffix ms|s|m|h|d|w|M|y (default off)
|
|
--max-backlog int Maximum number of objects in sync or check backlog (default 10000)
|
|
--max-delete int When synchronizing, limit the number of deletes (default -1)
|
|
--max-depth int If set limits the recursion depth to this (default -1)
|
|
--max-duration duration Maximum duration rclone will transfer data for
|
|
--max-size SizeSuffix Only transfer files smaller than this in KiB or suffix B|K|M|G|T|P (default off)
|
|
--max-stats-groups int Maximum number of stats groups to keep in memory, on max oldest is discarded (default 1000)
|
|
--max-transfer SizeSuffix Maximum size of data to transfer (default off)
|
|
--memprofile string Write memory profile to file
|
|
--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 SizeSuffix Only transfer files bigger than this in KiB or suffix B|K|M|G|T|P (default off)
|
|
--modify-window duration Max time diff to be considered the same (default 1ns)
|
|
--multi-thread-cutoff SizeSuffix Use multi-thread downloads for files above this size (default 250Mi)
|
|
--multi-thread-streams int Max number of streams to use for multi-thread downloads (default 4)
|
|
--no-check-certificate Do not verify the server SSL certificate (insecure)
|
|
--no-check-dest Don't check the destination, copy regardless
|
|
--no-console Hide console window (supported on Windows only)
|
|
--no-gzip-encoding Don't set Accept-Encoding: gzip
|
|
--no-traverse Don't traverse destination file system on copy
|
|
--no-unicode-normalization Don't normalize unicode characters in filenames
|
|
--no-update-modtime Don't update destination mod-time if files identical
|
|
--order-by string Instructions on how to order the transfers, e.g. 'size,descending'
|
|
--password-command SpaceSepList Command for supplying password for encrypted configuration
|
|
-P, --progress Show progress during transfer
|
|
--progress-terminal-title Show progress on the terminal title (requires -P/--progress)
|
|
-q, --quiet Print as little stuff as possible
|
|
--rc Enable the remote control server
|
|
--rc-addr string IPaddress:Port or :Port to bind server to (default "localhost:5572")
|
|
--rc-allow-origin string Set the allowed origin for CORS
|
|
--rc-baseurl string Prefix for URLs - leave blank for root
|
|
--rc-cert string SSL PEM key (concatenation of certificate and CA certificate)
|
|
--rc-client-ca string Client certificate authority to verify clients with
|
|
--rc-enable-metrics Enable prometheus metrics on /metrics
|
|
--rc-files string Path to local files to serve on the HTTP server
|
|
--rc-htpasswd string htpasswd file - if not provided no authentication is done
|
|
--rc-job-expire-duration duration Expire finished async jobs older than this value (default 1m0s)
|
|
--rc-job-expire-interval duration Interval to check for expired async jobs (default 10s)
|
|
--rc-key string SSL PEM Private key
|
|
--rc-max-header-bytes int Maximum size of request header (default 4096)
|
|
--rc-no-auth Don't require auth for certain methods
|
|
--rc-pass string Password for authentication
|
|
--rc-realm string Realm for authentication (default "rclone")
|
|
--rc-serve Enable the serving of remote objects
|
|
--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-template string User-specified template
|
|
--rc-user string User name for authentication
|
|
--rc-web-fetch-url string URL to fetch the releases for webgui (default "https://api.github.com/repos/rclone/rclone-webui-react/releases/latest")
|
|
--rc-web-gui Launch WebGUI on localhost
|
|
--rc-web-gui-force-update Force update to latest version of web gui
|
|
--rc-web-gui-no-open-browser Don't open the browser automatically
|
|
--rc-web-gui-update Check and update to latest version of web gui
|
|
--refresh-times Refresh the modtime of remote files
|
|
--retries int Retry operations this many times if they fail (default 3)
|
|
--retries-sleep duration Interval between retrying operations if they fail, e.g. 500ms, 60s, 5m (0 to disable)
|
|
--size-only Skip based on size only, not mod-time or checksum
|
|
--stats duration Interval between printing stats, e.g. 500ms, 60s, 5m (0 to disable) (default 1m0s)
|
|
--stats-file-name-length int Max file name length in stats (0 for no limit) (default 45)
|
|
--stats-log-level string Log level to show --stats output DEBUG|INFO|NOTICE|ERROR (default "INFO")
|
|
--stats-one-line Make the stats fit on one line
|
|
--stats-one-line-date Enable --stats-one-line and add current date/time prefix
|
|
--stats-one-line-date-format string Enable --stats-one-line-date and use custom formatted date: Enclose date string in double quotes ("), see https://golang.org/pkg/time/#Time.Format
|
|
--stats-unit string Show data rate in stats as either 'bits' or 'bytes' per second (default "bytes")
|
|
--streaming-upload-cutoff SizeSuffix Cutoff for switching to chunked upload if file size is unknown, upload starts after reaching cutoff or when file ends (default 100Ki)
|
|
--suffix string Suffix to add to changed files
|
|
--suffix-keep-extension Preserve the extension when using --suffix
|
|
--syslog Use Syslog for logging
|
|
--syslog-facility string Facility for syslog, e.g. KERN,USER,... (default "DAEMON")
|
|
--temp-dir string Directory rclone will use for temporary files (default "/tmp")
|
|
--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
|
|
--track-renames-strategy string Strategies to use when synchronizing using track-renames hash|modtime|leaf (default "hash")
|
|
--transfers int Number of file transfers to run in parallel (default 4)
|
|
-u, --update Skip files that are newer on the destination
|
|
--use-cookies Enable session cookiejar
|
|
--use-json-log Use json log format
|
|
--use-mmap Use mmap allocator (see docs)
|
|
--use-server-modtime Use server modified time instead of object metadata
|
|
--user-agent string Set the user-agent to a specified string (default "rclone/v1.57.0")
|
|
-v, --verbose count Print lots more stuff (repeat for more)
|
|
```
|
|
|
|
## Backend Flags
|
|
|
|
These flags are available for every command. They control the backends
|
|
and may be set in the config file.
|
|
|
|
```
|
|
--acd-auth-url string Auth server URL
|
|
--acd-client-id string OAuth Client Id
|
|
--acd-client-secret string OAuth Client Secret
|
|
--acd-encoding MultiEncoder This sets the encoding for the backend (default Slash,InvalidUtf8,Dot)
|
|
--acd-templink-threshold SizeSuffix Files >= this size will be downloaded via their tempLink (default 9Gi)
|
|
--acd-token string OAuth Access Token as a JSON blob
|
|
--acd-token-url string Token server url
|
|
--acd-upload-wait-per-gb Duration Additional time per GiB to wait after a failed complete upload to see if it appears (default 3m0s)
|
|
--alias-remote string Remote or path to alias
|
|
--azureblob-access-tier string Access tier of blob: hot, cool or archive
|
|
--azureblob-account string Storage Account Name
|
|
--azureblob-archive-tier-delete Delete archive tier blobs before overwriting
|
|
--azureblob-chunk-size SizeSuffix Upload chunk size (<= 100 MiB) (default 4Mi)
|
|
--azureblob-disable-checksum Don't store MD5 checksum with object metadata
|
|
--azureblob-encoding MultiEncoder This sets the encoding for the backend (default Slash,BackSlash,Del,Ctl,RightPeriod,InvalidUtf8)
|
|
--azureblob-endpoint string Endpoint for the service
|
|
--azureblob-key string Storage Account Key
|
|
--azureblob-list-chunk int Size of blob list (default 5000)
|
|
--azureblob-memory-pool-flush-time Duration How often internal memory buffer pools will be flushed (default 1m0s)
|
|
--azureblob-memory-pool-use-mmap Whether to use mmap buffers in internal memory pool
|
|
--azureblob-msi-client-id string Object ID of the user-assigned MSI to use, if any
|
|
--azureblob-msi-mi-res-id string Azure resource ID of the user-assigned MSI to use, if any
|
|
--azureblob-msi-object-id string Object ID of the user-assigned MSI to use, if any
|
|
--azureblob-no-head-object If set, do not do HEAD before GET when getting objects
|
|
--azureblob-public-access string Public access level of a container: blob or container
|
|
--azureblob-sas-url string SAS URL for container level access only
|
|
--azureblob-service-principal-file string Path to file containing credentials for use with a service principal
|
|
--azureblob-upload-cutoff string Cutoff for switching to chunked upload (<= 256 MiB) (deprecated)
|
|
--azureblob-use-emulator Uses local storage emulator if provided as 'true'
|
|
--azureblob-use-msi Use a managed service identity to authenticate (only works in Azure)
|
|
--b2-account string Account ID or Application Key ID
|
|
--b2-chunk-size SizeSuffix Upload chunk size (default 96Mi)
|
|
--b2-copy-cutoff SizeSuffix Cutoff for switching to multipart copy (default 4Gi)
|
|
--b2-disable-checksum Disable checksums for large (> upload cutoff) files
|
|
--b2-download-auth-duration Duration Time before the authorization token will expire in s or suffix ms|s|m|h|d (default 1w)
|
|
--b2-download-url string Custom endpoint for downloads
|
|
--b2-encoding MultiEncoder This sets the encoding for the backend (default Slash,BackSlash,Del,Ctl,InvalidUtf8,Dot)
|
|
--b2-endpoint string Endpoint for the service
|
|
--b2-hard-delete Permanently delete files on remote removal, otherwise hide files
|
|
--b2-key string Application Key
|
|
--b2-memory-pool-flush-time Duration How often internal memory buffer pools will be flushed (default 1m0s)
|
|
--b2-memory-pool-use-mmap Whether to use mmap buffers in internal memory pool
|
|
--b2-test-mode string A flag string for X-Bz-Test-Mode header for debugging
|
|
--b2-upload-cutoff SizeSuffix Cutoff for switching to chunked upload (default 200Mi)
|
|
--b2-versions Include old versions in directory listings
|
|
--box-access-token string Box App Primary Access Token
|
|
--box-auth-url string Auth server URL
|
|
--box-box-config-file string Box App config.json location
|
|
--box-box-sub-type string (default "user")
|
|
--box-client-id string OAuth Client Id
|
|
--box-client-secret string OAuth Client Secret
|
|
--box-commit-retries int Max number of times to try committing a multipart file (default 100)
|
|
--box-encoding MultiEncoder This sets the encoding for the backend (default Slash,BackSlash,Del,Ctl,RightSpace,InvalidUtf8,Dot)
|
|
--box-list-chunk int Size of listing chunk 1-1000 (default 1000)
|
|
--box-owned-by string Only show items owned by the login (email address) passed in
|
|
--box-root-folder-id string Fill in for rclone to use a non root folder as its starting point
|
|
--box-token string OAuth Access Token as a JSON blob
|
|
--box-token-url string Token server url
|
|
--box-upload-cutoff SizeSuffix Cutoff for switching to multipart upload (>= 50 MiB) (default 50Mi)
|
|
--cache-chunk-clean-interval Duration How often should the cache perform cleanups of the chunk storage (default 1m0s)
|
|
--cache-chunk-no-memory Disable the in-memory cache for storing chunks during streaming
|
|
--cache-chunk-path string Directory to cache chunk files (default "$HOME/.cache/rclone/cache-backend")
|
|
--cache-chunk-size SizeSuffix The size of a chunk (partial file data) (default 5Mi)
|
|
--cache-chunk-total-size SizeSuffix The total size that the chunks can take up on the local disk (default 10Gi)
|
|
--cache-db-path string Directory to store file structure metadata DB (default "$HOME/.cache/rclone/cache-backend")
|
|
--cache-db-purge Clear all the cached data for this remote on start
|
|
--cache-db-wait-time Duration How long to wait for the DB to be available - 0 is unlimited (default 1s)
|
|
--cache-info-age Duration How long to cache file structure information (directory listings, file size, times, etc.) (default 6h0m0s)
|
|
--cache-plex-insecure string Skip all certificate verification when connecting to the Plex server
|
|
--cache-plex-password string The password of the Plex user (obscured)
|
|
--cache-plex-url string The URL of the Plex server
|
|
--cache-plex-username string The username of the Plex user
|
|
--cache-read-retries int How many times to retry a read from a cache storage (default 10)
|
|
--cache-remote string Remote to cache
|
|
--cache-rps int Limits the number of requests per second to the source FS (-1 to disable) (default -1)
|
|
--cache-tmp-upload-path string Directory to keep temporary files until they are uploaded
|
|
--cache-tmp-wait-time Duration How long should files be stored in local cache before being uploaded (default 15s)
|
|
--cache-workers int How many workers should run in parallel to download chunks (default 4)
|
|
--cache-writes Cache file data on writes through the FS
|
|
--chunker-chunk-size SizeSuffix Files larger than chunk size will be split in chunks (default 2Gi)
|
|
--chunker-fail-hard Choose how chunker should handle files with missing or invalid chunks
|
|
--chunker-hash-type string Choose how chunker handles hash sums (default "md5")
|
|
--chunker-remote string Remote to chunk/unchunk
|
|
--compress-level int GZIP compression level (-2 to 9) (default -1)
|
|
--compress-mode string Compression mode (default "gzip")
|
|
--compress-ram-cache-limit SizeSuffix Some remotes don't allow the upload of files with unknown size (default 20Mi)
|
|
--compress-remote string Remote to compress
|
|
-L, --copy-links Follow symlinks and copy the pointed to item
|
|
--crypt-directory-name-encryption Option to either encrypt directory names or leave them intact (default true)
|
|
--crypt-filename-encryption string How to encrypt the filenames (default "standard")
|
|
--crypt-no-data-encryption Option to either encrypt file data or leave it unencrypted
|
|
--crypt-password string Password or pass phrase for encryption (obscured)
|
|
--crypt-password2 string Password or pass phrase for salt (obscured)
|
|
--crypt-remote string Remote to encrypt/decrypt
|
|
--crypt-server-side-across-configs Allow server-side operations (e.g. copy) to work across different crypt configs
|
|
--crypt-show-mapping For all files listed show how the names encrypt
|
|
--drive-acknowledge-abuse Set to allow files which return cannotDownloadAbusiveFile to be downloaded
|
|
--drive-allow-import-name-change Allow the filetype to change when uploading Google docs
|
|
--drive-auth-owner-only Only consider files owned by the authenticated user
|
|
--drive-auth-url string Auth server URL
|
|
--drive-chunk-size SizeSuffix Upload chunk size (default 8Mi)
|
|
--drive-client-id string Google Application Client Id
|
|
--drive-client-secret string OAuth Client Secret
|
|
--drive-disable-http2 Disable drive using http2 (default true)
|
|
--drive-encoding MultiEncoder This sets the encoding for the backend (default InvalidUtf8)
|
|
--drive-export-formats string Comma separated list of preferred formats for downloading Google docs (default "docx,xlsx,pptx,svg")
|
|
--drive-formats string Deprecated: See export_formats
|
|
--drive-impersonate string Impersonate this user when using a service account
|
|
--drive-import-formats string Comma separated list of preferred formats for uploading Google docs
|
|
--drive-keep-revision-forever Keep new head revision of each file forever
|
|
--drive-list-chunk int Size of listing chunk 100-1000, 0 to disable (default 1000)
|
|
--drive-pacer-burst int Number of API calls to allow without sleeping (default 100)
|
|
--drive-pacer-min-sleep Duration Minimum time to sleep between API calls (default 100ms)
|
|
--drive-root-folder-id string ID of the root folder
|
|
--drive-scope string Scope that rclone should use when requesting access from drive
|
|
--drive-server-side-across-configs Allow server-side operations (e.g. copy) to work across different drive configs
|
|
--drive-service-account-credentials string Service Account Credentials JSON blob
|
|
--drive-service-account-file string Service Account Credentials JSON file path
|
|
--drive-shared-with-me Only show files that are shared with me
|
|
--drive-size-as-quota Show sizes as storage quota usage, not actual size
|
|
--drive-skip-checksum-gphotos Skip MD5 checksum on Google photos and videos only
|
|
--drive-skip-gdocs Skip google documents in all listings
|
|
--drive-skip-shortcuts If set skip shortcut files
|
|
--drive-starred-only Only show files that are starred
|
|
--drive-stop-on-download-limit Make download limit errors be fatal
|
|
--drive-stop-on-upload-limit Make upload limit errors be fatal
|
|
--drive-team-drive string ID of the Shared Drive (Team Drive)
|
|
--drive-token string OAuth Access Token as a JSON blob
|
|
--drive-token-url string Token server url
|
|
--drive-trashed-only Only show files that are in the trash
|
|
--drive-upload-cutoff SizeSuffix Cutoff for switching to chunked upload (default 8Mi)
|
|
--drive-use-created-date Use file created date instead of modified date
|
|
--drive-use-shared-date Use date file was shared instead of modified date
|
|
--drive-use-trash Send files to the trash instead of deleting permanently (default true)
|
|
--drive-v2-download-min-size SizeSuffix If Object's are greater, use drive v2 API to download (default off)
|
|
--dropbox-auth-url string Auth server URL
|
|
--dropbox-batch-commit-timeout Duration Max time to wait for a batch to finish comitting (default 10m0s)
|
|
--dropbox-batch-mode string Upload file batching sync|async|off (default "sync")
|
|
--dropbox-batch-size int Max number of files in upload batch
|
|
--dropbox-batch-timeout Duration Max time to allow an idle upload batch before uploading (default 0s)
|
|
--dropbox-chunk-size SizeSuffix Upload chunk size (< 150Mi) (default 48Mi)
|
|
--dropbox-client-id string OAuth Client Id
|
|
--dropbox-client-secret string OAuth Client Secret
|
|
--dropbox-encoding MultiEncoder This sets the encoding for the backend (default Slash,BackSlash,Del,RightSpace,InvalidUtf8,Dot)
|
|
--dropbox-impersonate string Impersonate this user when using a business account
|
|
--dropbox-shared-files Instructs rclone to work on individual shared files
|
|
--dropbox-shared-folders Instructs rclone to work on shared folders
|
|
--dropbox-token string OAuth Access Token as a JSON blob
|
|
--dropbox-token-url string Token server url
|
|
--fichier-api-key string Your API Key, get it from https://1fichier.com/console/params.pl
|
|
--fichier-encoding MultiEncoder This sets the encoding for the backend (default Slash,LtGt,DoubleQuote,SingleQuote,BackQuote,Dollar,BackSlash,Del,Ctl,LeftSpace,RightSpace,InvalidUtf8,Dot)
|
|
--fichier-file-password string If you want to download a shared file that is password protected, add this parameter (obscured)
|
|
--fichier-folder-password string If you want to list the files in a shared folder that is password protected, add this parameter (obscured)
|
|
--fichier-shared-folder string If you want to download a shared folder, add this parameter
|
|
--filefabric-encoding MultiEncoder This sets the encoding for the backend (default Slash,Del,Ctl,InvalidUtf8,Dot)
|
|
--filefabric-permanent-token string Permanent Authentication Token
|
|
--filefabric-root-folder-id string ID of the root folder
|
|
--filefabric-token string Session Token
|
|
--filefabric-token-expiry string Token expiry time
|
|
--filefabric-url string URL of the Enterprise File Fabric to connect to
|
|
--filefabric-version string Version read from the file fabric
|
|
--ftp-close-timeout Duration Maximum time to wait for a response to close (default 1m0s)
|
|
--ftp-concurrency int Maximum number of FTP simultaneous connections, 0 for unlimited
|
|
--ftp-disable-epsv Disable using EPSV even if server advertises support
|
|
--ftp-disable-mlsd Disable using MLSD even if server advertises support
|
|
--ftp-disable-tls13 Disable TLS 1.3 (workaround for FTP servers with buggy TLS)
|
|
--ftp-encoding MultiEncoder This sets the encoding for the backend (default Slash,Del,Ctl,RightSpace,Dot)
|
|
--ftp-explicit-tls Use Explicit FTPS (FTP over TLS)
|
|
--ftp-host string FTP host to connect to
|
|
--ftp-idle-timeout Duration Max time before closing idle connections (default 1m0s)
|
|
--ftp-no-check-certificate Do not verify the TLS certificate of the server
|
|
--ftp-pass string FTP password (obscured)
|
|
--ftp-port string FTP port, leave blank to use default (21)
|
|
--ftp-shut-timeout Duration Maximum time to wait for data connection closing status (default 1m0s)
|
|
--ftp-tls Use Implicit FTPS (FTP over TLS)
|
|
--ftp-tls-cache-size int Size of TLS session cache for all control and data connections (default 32)
|
|
--ftp-user string FTP username, leave blank for current username, $USER
|
|
--ftp-writing-mdtm Use MDTM to set modification time (VsFtpd quirk)
|
|
--gcs-anonymous Access public buckets and objects without credentials
|
|
--gcs-auth-url string Auth server URL
|
|
--gcs-bucket-acl string Access Control List for new buckets
|
|
--gcs-bucket-policy-only Access checks should use bucket-level IAM policies
|
|
--gcs-client-id string OAuth Client Id
|
|
--gcs-client-secret string OAuth Client Secret
|
|
--gcs-encoding MultiEncoder This sets the encoding for the backend (default Slash,CrLf,InvalidUtf8,Dot)
|
|
--gcs-location string Location for the newly created buckets
|
|
--gcs-object-acl string Access Control List for new objects
|
|
--gcs-project-number string Project number
|
|
--gcs-service-account-file string Service Account Credentials JSON file path
|
|
--gcs-storage-class string The storage class to use when storing objects in Google Cloud Storage
|
|
--gcs-token string OAuth Access Token as a JSON blob
|
|
--gcs-token-url string Token server url
|
|
--gphotos-auth-url string Auth server URL
|
|
--gphotos-client-id string OAuth Client Id
|
|
--gphotos-client-secret string OAuth Client Secret
|
|
--gphotos-encoding MultiEncoder This sets the encoding for the backend (default Slash,CrLf,InvalidUtf8,Dot)
|
|
--gphotos-include-archived Also view and download archived media
|
|
--gphotos-read-only Set to make the Google Photos backend read only
|
|
--gphotos-read-size Set to read the size of media items
|
|
--gphotos-start-year int Year limits the photos to be downloaded to those which are uploaded after the given year (default 2000)
|
|
--gphotos-token string OAuth Access Token as a JSON blob
|
|
--gphotos-token-url string Token server url
|
|
--hasher-auto-size SizeSuffix Auto-update checksum for files smaller than this size (disabled by default)
|
|
--hasher-hashes CommaSepList Comma separated list of supported checksum types (default md5,sha1)
|
|
--hasher-max-age Duration Maximum time to keep checksums in cache (0 = no cache, off = cache forever) (default off)
|
|
--hasher-remote string Remote to cache checksums for (e.g. myRemote:path)
|
|
--hdfs-data-transfer-protection string Kerberos data transfer protection: authentication|integrity|privacy
|
|
--hdfs-encoding MultiEncoder This sets the encoding for the backend (default Slash,Colon,Del,Ctl,InvalidUtf8,Dot)
|
|
--hdfs-namenode string Hadoop name node and port
|
|
--hdfs-service-principal-name string Kerberos service principal name for the namenode
|
|
--hdfs-username string Hadoop user name
|
|
--http-headers CommaSepList Set HTTP headers for all transactions
|
|
--http-no-head Don't use HEAD requests to find file sizes in dir listing
|
|
--http-no-slash Set this if the site doesn't end directories with /
|
|
--http-url string URL of http host to connect to
|
|
--hubic-auth-url string Auth server URL
|
|
--hubic-chunk-size SizeSuffix Above this size files will be chunked into a _segments container (default 5Gi)
|
|
--hubic-client-id string OAuth Client Id
|
|
--hubic-client-secret string OAuth Client Secret
|
|
--hubic-encoding MultiEncoder This sets the encoding for the backend (default Slash,InvalidUtf8)
|
|
--hubic-no-chunk Don't chunk files during streaming upload
|
|
--hubic-token string OAuth Access Token as a JSON blob
|
|
--hubic-token-url string Token server url
|
|
--jottacloud-encoding MultiEncoder This sets the encoding for the backend (default Slash,LtGt,DoubleQuote,Colon,Question,Asterisk,Pipe,Del,Ctl,InvalidUtf8,Dot)
|
|
--jottacloud-hard-delete Delete files permanently rather than putting them into the trash
|
|
--jottacloud-md5-memory-limit SizeSuffix Files bigger than this will be cached on disk to calculate the MD5 if required (default 10Mi)
|
|
--jottacloud-no-versions Avoid server side versioning by deleting files and recreating files instead of overwriting them
|
|
--jottacloud-trashed-only Only show files that are in the trash
|
|
--jottacloud-upload-resume-limit SizeSuffix Files bigger than this can be resumed if the upload fail's (default 10Mi)
|
|
--koofr-encoding MultiEncoder This sets the encoding for the backend (default Slash,BackSlash,Del,Ctl,InvalidUtf8,Dot)
|
|
--koofr-endpoint string The Koofr API endpoint to use (default "https://app.koofr.net")
|
|
--koofr-mountid string Mount ID of the mount to use
|
|
--koofr-password string Your Koofr password for rclone (generate one at https://app.koofr.net/app/admin/preferences/password) (obscured)
|
|
--koofr-setmtime Does the backend support setting modification time (default true)
|
|
--koofr-user string Your Koofr user name
|
|
-l, --links Translate symlinks to/from regular files with a '.rclonelink' extension
|
|
--local-case-insensitive Force the filesystem to report itself as case insensitive
|
|
--local-case-sensitive Force the filesystem to report itself as case sensitive
|
|
--local-encoding MultiEncoder This sets the encoding for the backend (default Slash,Dot)
|
|
--local-no-check-updated Don't check to see if the files change during upload
|
|
--local-no-preallocate Disable preallocation of disk space for transferred files
|
|
--local-no-set-modtime Disable setting modtime
|
|
--local-no-sparse Disable sparse files for multi-thread downloads
|
|
--local-nounc string Disable UNC (long path names) conversion on Windows
|
|
--local-unicode-normalization Apply unicode NFC normalization to paths and filenames
|
|
--local-zero-size-links Assume the Stat size of links is zero (and read them instead) (deprecated)
|
|
--mailru-check-hash What should copy do if file checksum is mismatched or invalid (default true)
|
|
--mailru-encoding MultiEncoder This sets the encoding for the backend (default Slash,LtGt,DoubleQuote,Colon,Question,Asterisk,Pipe,BackSlash,Del,Ctl,InvalidUtf8,Dot)
|
|
--mailru-pass string Password (obscured)
|
|
--mailru-speedup-enable Skip full upload if there is another file with same data hash (default true)
|
|
--mailru-speedup-file-patterns string Comma separated list of file name patterns eligible for speedup (put by hash) (default "*.mkv,*.avi,*.mp4,*.mp3,*.zip,*.gz,*.rar,*.pdf")
|
|
--mailru-speedup-max-disk SizeSuffix This option allows you to disable speedup (put by hash) for large files (default 3Gi)
|
|
--mailru-speedup-max-memory SizeSuffix Files larger than the size given below will always be hashed on disk (default 32Mi)
|
|
--mailru-user string User name (usually email)
|
|
--mega-debug Output more debug from Mega
|
|
--mega-encoding MultiEncoder This sets the encoding for the backend (default Slash,InvalidUtf8,Dot)
|
|
--mega-hard-delete Delete files permanently rather than putting them into the trash
|
|
--mega-pass string Password (obscured)
|
|
--mega-user string User name
|
|
-x, --one-file-system Don't cross filesystem boundaries (unix/macOS only)
|
|
--onedrive-auth-url string Auth server URL
|
|
--onedrive-chunk-size SizeSuffix Chunk size to upload files with - must be multiple of 320k (327,680 bytes) (default 10Mi)
|
|
--onedrive-client-id string OAuth Client Id
|
|
--onedrive-client-secret string OAuth Client Secret
|
|
--onedrive-drive-id string The ID of the drive to use
|
|
--onedrive-drive-type string The type of the drive (personal | business | documentLibrary)
|
|
--onedrive-encoding MultiEncoder This sets the encoding for the backend (default Slash,LtGt,DoubleQuote,Colon,Question,Asterisk,Pipe,BackSlash,Del,Ctl,LeftSpace,LeftTilde,RightSpace,RightPeriod,InvalidUtf8,Dot)
|
|
--onedrive-expose-onenote-files Set to make OneNote files show up in directory listings
|
|
--onedrive-link-password string Set the password for links created by the link command
|
|
--onedrive-link-scope string Set the scope of the links created by the link command (default "anonymous")
|
|
--onedrive-link-type string Set the type of the links created by the link command (default "view")
|
|
--onedrive-list-chunk int Size of listing chunk (default 1000)
|
|
--onedrive-no-versions Remove all versions on modifying operations
|
|
--onedrive-region string Choose national cloud region for OneDrive (default "global")
|
|
--onedrive-server-side-across-configs Allow server-side operations (e.g. copy) to work across different onedrive configs
|
|
--onedrive-token string OAuth Access Token as a JSON blob
|
|
--onedrive-token-url string Token server url
|
|
--opendrive-chunk-size SizeSuffix Files will be uploaded in chunks this size (default 10Mi)
|
|
--opendrive-encoding MultiEncoder This sets the encoding for the backend (default Slash,LtGt,DoubleQuote,Colon,Question,Asterisk,Pipe,BackSlash,LeftSpace,LeftCrLfHtVt,RightSpace,RightCrLfHtVt,InvalidUtf8,Dot)
|
|
--opendrive-password string Password (obscured)
|
|
--opendrive-username string Username
|
|
--pcloud-auth-url string Auth server URL
|
|
--pcloud-client-id string OAuth Client Id
|
|
--pcloud-client-secret string OAuth Client Secret
|
|
--pcloud-encoding MultiEncoder This sets the encoding for the backend (default Slash,BackSlash,Del,Ctl,InvalidUtf8,Dot)
|
|
--pcloud-hostname string Hostname to connect to (default "api.pcloud.com")
|
|
--pcloud-root-folder-id string Fill in for rclone to use a non root folder as its starting point (default "d0")
|
|
--pcloud-token string OAuth Access Token as a JSON blob
|
|
--pcloud-token-url string Token server url
|
|
--premiumizeme-encoding MultiEncoder This sets the encoding for the backend (default Slash,DoubleQuote,BackSlash,Del,Ctl,InvalidUtf8,Dot)
|
|
--putio-encoding MultiEncoder This sets the encoding for the backend (default Slash,BackSlash,Del,Ctl,InvalidUtf8,Dot)
|
|
--qingstor-access-key-id string QingStor Access Key ID
|
|
--qingstor-chunk-size SizeSuffix Chunk size to use for uploading (default 4Mi)
|
|
--qingstor-connection-retries int Number of connection retries (default 3)
|
|
--qingstor-encoding MultiEncoder This sets the encoding for the backend (default Slash,Ctl,InvalidUtf8)
|
|
--qingstor-endpoint string Enter an endpoint URL to connection QingStor API
|
|
--qingstor-env-auth Get QingStor credentials from runtime
|
|
--qingstor-secret-access-key string QingStor Secret Access Key (password)
|
|
--qingstor-upload-concurrency int Concurrency for multipart uploads (default 1)
|
|
--qingstor-upload-cutoff SizeSuffix Cutoff for switching to chunked upload (default 200Mi)
|
|
--qingstor-zone string Zone to connect to
|
|
--s3-access-key-id string AWS Access Key ID
|
|
--s3-acl string Canned ACL used when creating buckets and storing or copying objects
|
|
--s3-bucket-acl string Canned ACL used when creating buckets
|
|
--s3-chunk-size SizeSuffix Chunk size to use for uploading (default 5Mi)
|
|
--s3-copy-cutoff SizeSuffix Cutoff for switching to multipart copy (default 4.656Gi)
|
|
--s3-disable-checksum Don't store MD5 checksum with object metadata
|
|
--s3-disable-http2 Disable usage of http2 for S3 backends
|
|
--s3-download-url string Custom endpoint for downloads
|
|
--s3-encoding MultiEncoder This sets the encoding for the backend (default Slash,InvalidUtf8,Dot)
|
|
--s3-endpoint string Endpoint for S3 API
|
|
--s3-env-auth Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars)
|
|
--s3-force-path-style If true use path style access if false use virtual hosted style (default true)
|
|
--s3-leave-parts-on-error If true avoid calling abort upload on a failure, leaving all successfully uploaded parts on S3 for manual recovery
|
|
--s3-list-chunk int Size of listing chunk (response list for each ListObject S3 request) (default 1000)
|
|
--s3-location-constraint string Location constraint - must be set to match the Region
|
|
--s3-max-upload-parts int Maximum number of parts in a multipart upload (default 10000)
|
|
--s3-memory-pool-flush-time Duration How often internal memory buffer pools will be flushed (default 1m0s)
|
|
--s3-memory-pool-use-mmap Whether to use mmap buffers in internal memory pool
|
|
--s3-no-check-bucket If set, don't attempt to check the bucket exists or create it
|
|
--s3-no-head If set, don't HEAD uploaded objects to check integrity
|
|
--s3-no-head-object If set, do not do HEAD before GET when getting objects
|
|
--s3-profile string Profile to use in the shared credentials file
|
|
--s3-provider string Choose your S3 provider
|
|
--s3-region string Region to connect to
|
|
--s3-requester-pays Enables requester pays option when interacting with S3 bucket
|
|
--s3-secret-access-key string AWS Secret Access Key (password)
|
|
--s3-server-side-encryption string The server-side encryption algorithm used when storing this object in S3
|
|
--s3-session-token string An AWS session token
|
|
--s3-shared-credentials-file string Path to the shared credentials file
|
|
--s3-sse-customer-algorithm string If using SSE-C, the server-side encryption algorithm used when storing this object in S3
|
|
--s3-sse-customer-key string If using SSE-C you must provide the secret encryption key used to encrypt/decrypt your data
|
|
--s3-sse-customer-key-md5 string If using SSE-C you may provide the secret encryption key MD5 checksum (optional)
|
|
--s3-sse-kms-key-id string If using KMS ID you must provide the ARN of Key
|
|
--s3-storage-class string The storage class to use when storing new objects in S3
|
|
--s3-upload-concurrency int Concurrency for multipart uploads (default 4)
|
|
--s3-upload-cutoff SizeSuffix Cutoff for switching to chunked upload (default 200Mi)
|
|
--s3-use-accelerate-endpoint If true use the AWS S3 accelerated endpoint
|
|
--s3-v2-auth If true use v2 authentication
|
|
--seafile-2fa Two-factor authentication ('true' if the account has 2FA enabled)
|
|
--seafile-create-library Should rclone create a library if it doesn't exist
|
|
--seafile-encoding MultiEncoder This sets the encoding for the backend (default Slash,DoubleQuote,BackSlash,Ctl,InvalidUtf8)
|
|
--seafile-library string Name of the library
|
|
--seafile-library-key string Library password (for encrypted libraries only) (obscured)
|
|
--seafile-pass string Password (obscured)
|
|
--seafile-url string URL of seafile host to connect to
|
|
--seafile-user string User name (usually email address)
|
|
--sftp-ask-password Allow asking for SFTP password when needed
|
|
--sftp-disable-concurrent-reads If set don't use concurrent reads
|
|
--sftp-disable-concurrent-writes If set don't use concurrent writes
|
|
--sftp-disable-hashcheck Disable the execution of SSH commands to determine if remote file hashing is available
|
|
--sftp-host string SSH host to connect to
|
|
--sftp-idle-timeout Duration Max time before closing idle connections (default 1m0s)
|
|
--sftp-key-file string Path to PEM-encoded private key file
|
|
--sftp-key-file-pass string The passphrase to decrypt the PEM-encoded private key file (obscured)
|
|
--sftp-key-pem string Raw PEM-encoded private key
|
|
--sftp-key-use-agent When set forces the usage of the ssh-agent
|
|
--sftp-known-hosts-file string Optional path to known_hosts file
|
|
--sftp-md5sum-command string The command used to read md5 hashes
|
|
--sftp-pass string SSH password, leave blank to use ssh-agent (obscured)
|
|
--sftp-path-override string Override path used by SSH connection
|
|
--sftp-port string SSH port, leave blank to use default (22)
|
|
--sftp-pubkey-file string Optional path to public key file
|
|
--sftp-server-command string Specifies the path or command to run a sftp server on the remote host
|
|
--sftp-set-modtime Set the modified time on the remote if set (default true)
|
|
--sftp-sha1sum-command string The command used to read sha1 hashes
|
|
--sftp-skip-links Set to skip any symlinks and any other non regular files
|
|
--sftp-subsystem string Specifies the SSH2 subsystem on the remote host (default "sftp")
|
|
--sftp-use-fstat If set use fstat instead of stat
|
|
--sftp-use-insecure-cipher Enable the use of insecure ciphers and key exchange methods
|
|
--sftp-user string SSH username, leave blank for current username, $USER
|
|
--sharefile-chunk-size SizeSuffix Upload chunk size (default 64Mi)
|
|
--sharefile-encoding MultiEncoder This sets the encoding for the backend (default Slash,LtGt,DoubleQuote,Colon,Question,Asterisk,Pipe,BackSlash,Ctl,LeftSpace,LeftPeriod,RightSpace,RightPeriod,InvalidUtf8,Dot)
|
|
--sharefile-endpoint string Endpoint for API calls
|
|
--sharefile-root-folder-id string ID of the root folder
|
|
--sharefile-upload-cutoff SizeSuffix Cutoff for switching to multipart upload (default 128Mi)
|
|
--sia-api-password string Sia Daemon API Password (obscured)
|
|
--sia-api-url string Sia daemon API URL, like http://sia.daemon.host:9980 (default "http://127.0.0.1:9980")
|
|
--sia-encoding MultiEncoder This sets the encoding for the backend (default Slash,Question,Hash,Percent,Del,Ctl,InvalidUtf8,Dot)
|
|
--sia-user-agent string Siad User Agent (default "Sia-Agent")
|
|
--skip-links Don't warn about skipped symlinks
|
|
--sugarsync-access-key-id string Sugarsync Access Key ID
|
|
--sugarsync-app-id string Sugarsync App ID
|
|
--sugarsync-authorization string Sugarsync authorization
|
|
--sugarsync-authorization-expiry string Sugarsync authorization expiry
|
|
--sugarsync-deleted-id string Sugarsync deleted folder id
|
|
--sugarsync-encoding MultiEncoder This sets the encoding for the backend (default Slash,Ctl,InvalidUtf8,Dot)
|
|
--sugarsync-hard-delete Permanently delete files if true
|
|
--sugarsync-private-access-key string Sugarsync Private Access Key
|
|
--sugarsync-refresh-token string Sugarsync refresh token
|
|
--sugarsync-root-id string Sugarsync root id
|
|
--sugarsync-user string Sugarsync user
|
|
--swift-application-credential-id string Application Credential ID (OS_APPLICATION_CREDENTIAL_ID)
|
|
--swift-application-credential-name string Application Credential Name (OS_APPLICATION_CREDENTIAL_NAME)
|
|
--swift-application-credential-secret string Application Credential Secret (OS_APPLICATION_CREDENTIAL_SECRET)
|
|
--swift-auth string Authentication URL for server (OS_AUTH_URL)
|
|
--swift-auth-token string Auth Token from alternate authentication - optional (OS_AUTH_TOKEN)
|
|
--swift-auth-version int AuthVersion - optional - set to (1,2,3) if your auth URL has no version (ST_AUTH_VERSION)
|
|
--swift-chunk-size SizeSuffix Above this size files will be chunked into a _segments container (default 5Gi)
|
|
--swift-domain string User domain - optional (v3 auth) (OS_USER_DOMAIN_NAME)
|
|
--swift-encoding MultiEncoder This sets the encoding for the backend (default Slash,InvalidUtf8)
|
|
--swift-endpoint-type string Endpoint type to choose from the service catalogue (OS_ENDPOINT_TYPE) (default "public")
|
|
--swift-env-auth Get swift credentials from environment variables in standard OpenStack form
|
|
--swift-key string API key or password (OS_PASSWORD)
|
|
--swift-leave-parts-on-error If true avoid calling abort upload on a failure
|
|
--swift-no-chunk Don't chunk files during streaming upload
|
|
--swift-region string Region name - optional (OS_REGION_NAME)
|
|
--swift-storage-policy string The storage policy to use when creating a new container
|
|
--swift-storage-url string Storage URL - optional (OS_STORAGE_URL)
|
|
--swift-tenant string Tenant name - optional for v1 auth, this or tenant_id required otherwise (OS_TENANT_NAME or OS_PROJECT_NAME)
|
|
--swift-tenant-domain string Tenant domain - optional (v3 auth) (OS_PROJECT_DOMAIN_NAME)
|
|
--swift-tenant-id string Tenant ID - optional for v1 auth, this or tenant required otherwise (OS_TENANT_ID)
|
|
--swift-user string User name to log in (OS_USERNAME)
|
|
--swift-user-id string User ID to log in - optional - most swift systems use user and leave this blank (v3 auth) (OS_USER_ID)
|
|
--tardigrade-access-grant string Access grant
|
|
--tardigrade-api-key string API key
|
|
--tardigrade-passphrase string Encryption passphrase
|
|
--tardigrade-provider string Choose an authentication method (default "existing")
|
|
--tardigrade-satellite-address string Satellite address (default "us-central-1.tardigrade.io")
|
|
--union-action-policy string Policy to choose upstream on ACTION category (default "epall")
|
|
--union-cache-time int Cache time of usage and free space (in seconds) (default 120)
|
|
--union-create-policy string Policy to choose upstream on CREATE category (default "epmfs")
|
|
--union-search-policy string Policy to choose upstream on SEARCH category (default "ff")
|
|
--union-upstreams string List of space separated upstreams
|
|
--uptobox-access-token string Your access token
|
|
--uptobox-encoding MultiEncoder This sets the encoding for the backend (default Slash,LtGt,DoubleQuote,BackQuote,Del,Ctl,LeftSpace,InvalidUtf8,Dot)
|
|
--webdav-bearer-token string Bearer token instead of user/pass (e.g. a Macaroon)
|
|
--webdav-bearer-token-command string Command to run to get a bearer token
|
|
--webdav-encoding string This sets the encoding for the backend
|
|
--webdav-headers CommaSepList Set HTTP headers for all transactions
|
|
--webdav-pass string Password (obscured)
|
|
--webdav-url string URL of http host to connect to
|
|
--webdav-user string User name
|
|
--webdav-vendor string Name of the Webdav site/service/software you are using
|
|
--yandex-auth-url string Auth server URL
|
|
--yandex-client-id string OAuth Client Id
|
|
--yandex-client-secret string OAuth Client Secret
|
|
--yandex-encoding MultiEncoder This sets the encoding for the backend (default Slash,Del,Ctl,InvalidUtf8,Dot)
|
|
--yandex-token string OAuth Access Token as a JSON blob
|
|
--yandex-token-url string Token server url
|
|
--zoho-auth-url string Auth server URL
|
|
--zoho-client-id string OAuth Client Id
|
|
--zoho-client-secret string OAuth Client Secret
|
|
--zoho-encoding MultiEncoder This sets the encoding for the backend (default Del,Ctl,InvalidUtf8)
|
|
--zoho-region string Zoho region to connect to
|
|
--zoho-token string OAuth Access Token as a JSON blob
|
|
--zoho-token-url string Token server url
|
|
```
|