github.com/rclone/rclone@v1.66.1-0.20240517100346-7b89735ae726/docs/content/commands/rclone_move.md (about) 1 --- 2 title: "rclone move" 3 description: "Move files from source to dest." 4 slug: rclone_move 5 url: /commands/rclone_move/ 6 groups: Filter,Listing,Important,Copy 7 versionIntroduced: v1.19 8 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/move/ and as part of making a release run "make commanddocs" 9 --- 10 # rclone move 11 12 Move files from source to dest. 13 14 ## Synopsis 15 16 17 Moves the contents of the source directory to the destination 18 directory. Rclone will error if the source and destination overlap and 19 the remote does not support a server-side directory move operation. 20 21 To move single files, use the [moveto](/commands/rclone_moveto/) 22 command instead. 23 24 If no filters are in use and if possible this will server-side move 25 `source:path` into `dest:path`. After this `source:path` will no 26 longer exist. 27 28 Otherwise for each file in `source:path` selected by the filters (if 29 any) this will move it into `dest:path`. If possible a server-side 30 move will be used, otherwise it will copy it (server-side if possible) 31 into `dest:path` then delete the original (if no errors on copy) in 32 `source:path`. 33 34 If you want to delete empty source directories after move, use the 35 `--delete-empty-src-dirs` flag. 36 37 See the [--no-traverse](/docs/#no-traverse) option for controlling 38 whether rclone lists the destination directory or not. Supplying this 39 option when moving a small number of files into a large destination 40 can speed transfers up greatly. 41 42 Rclone will sync the modification times of files and directories if 43 the backend supports it. If metadata syncing is required then use the 44 `--metadata` flag. 45 46 Note that the modification time and metadata for the root directory 47 will **not** be synced. See https://github.com/rclone/rclone/issues/7652 48 for more info. 49 50 **Important**: Since this can cause data loss, test first with the 51 `--dry-run` or the `--interactive`/`-i` flag. 52 53 **Note**: Use the `-P`/`--progress` flag to view real-time transfer statistics. 54 55 56 ``` 57 rclone move source:path dest:path [flags] 58 ``` 59 60 ## Options 61 62 ``` 63 --create-empty-src-dirs Create empty source dirs on destination after move 64 --delete-empty-src-dirs Delete empty source dirs after move 65 -h, --help help for move 66 ``` 67 68 69 ## Copy Options 70 71 Flags for anything which can Copy a file. 72 73 ``` 74 --check-first Do all the checks before starting transfers 75 -c, --checksum Check for changes with size & checksum (if available, or fallback to size only). 76 --compare-dest stringArray Include additional comma separated server-side paths during comparison 77 --copy-dest stringArray Implies --compare-dest but also copies files from paths into destination 78 --cutoff-mode HARD|SOFT|CAUTIOUS Mode to stop transfers when reaching the max transfer limit HARD|SOFT|CAUTIOUS (default HARD) 79 --ignore-case-sync Ignore case when synchronizing 80 --ignore-checksum Skip post copy check of checksums 81 --ignore-existing Skip all files that exist on destination 82 --ignore-size Ignore size when skipping use modtime or checksum 83 -I, --ignore-times Don't skip items that match size and time - transfer all unconditionally 84 --immutable Do not modify files, fail if existing files have been modified 85 --inplace Download directly to destination file instead of atomic download to temp/rename 86 --max-backlog int Maximum number of objects in sync or check backlog (default 10000) 87 --max-duration Duration Maximum duration rclone will transfer data for (default 0s) 88 --max-transfer SizeSuffix Maximum size of data to transfer (default off) 89 -M, --metadata If set, preserve metadata when copying objects 90 --modify-window Duration Max time diff to be considered the same (default 1ns) 91 --multi-thread-chunk-size SizeSuffix Chunk size for multi-thread downloads / uploads, if not set by filesystem (default 64Mi) 92 --multi-thread-cutoff SizeSuffix Use multi-thread downloads for files above this size (default 256Mi) 93 --multi-thread-streams int Number of streams to use for multi-thread downloads (default 4) 94 --multi-thread-write-buffer-size SizeSuffix In memory buffer size for writing when in multi-thread mode (default 128Ki) 95 --no-check-dest Don't check the destination, copy regardless 96 --no-traverse Don't traverse destination file system on copy 97 --no-update-dir-modtime Don't update directory modification times 98 --no-update-modtime Don't update destination modtime if files identical 99 --order-by string Instructions on how to order the transfers, e.g. 'size,descending' 100 --partial-suffix string Add partial-suffix to temporary file name when --inplace is not used (default ".partial") 101 --refresh-times Refresh the modtime of remote files 102 --server-side-across-configs Allow server-side operations (e.g. copy) to work across different configs 103 --size-only Skip based on size only, not modtime or checksum 104 --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) 105 -u, --update Skip files that are newer on the destination 106 ``` 107 108 ## Important Options 109 110 Important flags useful for most commands. 111 112 ``` 113 -n, --dry-run Do a trial run with no permanent changes 114 -i, --interactive Enable interactive mode 115 -v, --verbose count Print lots more stuff (repeat for more) 116 ``` 117 118 ## Filter Options 119 120 Flags for filtering directory listings. 121 122 ``` 123 --delete-excluded Delete files on dest excluded from sync 124 --exclude stringArray Exclude files matching pattern 125 --exclude-from stringArray Read file exclude patterns from file (use - to read from stdin) 126 --exclude-if-present stringArray Exclude directories if filename is present 127 --files-from stringArray Read list of source-file names from file (use - to read from stdin) 128 --files-from-raw stringArray Read list of source-file names from file without any processing of lines (use - to read from stdin) 129 -f, --filter stringArray Add a file filtering rule 130 --filter-from stringArray Read file filtering patterns from a file (use - to read from stdin) 131 --ignore-case Ignore case in filters (case insensitive) 132 --include stringArray Include files matching pattern 133 --include-from stringArray Read file include patterns from file (use - to read from stdin) 134 --max-age Duration Only transfer files younger than this in s or suffix ms|s|m|h|d|w|M|y (default off) 135 --max-depth int If set limits the recursion depth to this (default -1) 136 --max-size SizeSuffix Only transfer files smaller than this in KiB or suffix B|K|M|G|T|P (default off) 137 --metadata-exclude stringArray Exclude metadatas matching pattern 138 --metadata-exclude-from stringArray Read metadata exclude patterns from file (use - to read from stdin) 139 --metadata-filter stringArray Add a metadata filtering rule 140 --metadata-filter-from stringArray Read metadata filtering patterns from a file (use - to read from stdin) 141 --metadata-include stringArray Include metadatas matching pattern 142 --metadata-include-from stringArray Read metadata include patterns from file (use - to read from stdin) 143 --min-age Duration Only transfer files older than this in s or suffix ms|s|m|h|d|w|M|y (default off) 144 --min-size SizeSuffix Only transfer files bigger than this in KiB or suffix B|K|M|G|T|P (default off) 145 ``` 146 147 ## Listing Options 148 149 Flags for listing directories. 150 151 ``` 152 --default-time Time Time to show if modtime is unknown for files and directories (default 2000-01-01T00:00:00Z) 153 --fast-list Use recursive list if available; uses more memory but fewer transactions 154 ``` 155 156 See the [global flags page](/flags/) for global options not listed here. 157 158 # SEE ALSO 159 160 * [rclone](/commands/rclone/) - Show help for rclone commands, flags and backends. 161