2016-08-04 04:36:28 +08:00
|
|
|
---
|
|
|
|
title: "rclone sync"
|
2020-05-16 22:11:55 +08:00
|
|
|
description: "Make source and dest identical, modifying destination only."
|
2016-08-04 04:36:28 +08:00
|
|
|
slug: rclone_sync
|
|
|
|
url: /commands/rclone_sync/
|
2020-02-10 20:31:45 +08:00
|
|
|
# autogenerated - DO NOT EDIT, instead edit the source code in cmd/sync/ and as part of making a release run "make commanddocs"
|
2016-08-04 04:36:28 +08:00
|
|
|
---
|
2020-05-22 18:17:37 +08:00
|
|
|
# rclone sync
|
2016-08-04 04:36:28 +08:00
|
|
|
|
|
|
|
Make source and dest identical, modifying destination only.
|
|
|
|
|
2020-05-22 18:17:37 +08:00
|
|
|
## Synopsis
|
2016-08-04 04:36:28 +08:00
|
|
|
|
|
|
|
|
|
|
|
Sync the source to the destination, changing the destination
|
2021-11-01 23:42:05 +08:00
|
|
|
only. Doesn't transfer files that are identical on source and
|
|
|
|
destination, testing by size and modification time or MD5SUM.
|
|
|
|
Destination is updated to match source, including deleting files
|
2022-07-10 01:08:20 +08:00
|
|
|
if necessary (except duplicate objects, see below). If you don't
|
|
|
|
want to delete files from destination, use the
|
|
|
|
[copy](/commands/rclone_copy/) command instead.
|
2016-08-04 04:36:28 +08:00
|
|
|
|
|
|
|
**Important**: Since this can cause data loss, test first with the
|
2020-09-02 23:59:04 +08:00
|
|
|
`--dry-run` or the `--interactive`/`-i` flag.
|
|
|
|
|
|
|
|
rclone sync -i SOURCE remote:DESTINATION
|
2016-08-04 04:36:28 +08:00
|
|
|
|
|
|
|
Note that files in the destination won't be deleted if there were any
|
2021-04-01 02:12:08 +08:00
|
|
|
errors at any point. Duplicate objects (files with the same name, on
|
|
|
|
those providers that support it) are also not yet handled.
|
2016-08-04 04:36:28 +08:00
|
|
|
|
|
|
|
It is always the contents of the directory that is synced, not the
|
2022-06-19 21:26:53 +08:00
|
|
|
directory itself. So when source:path is a directory, it's the contents of
|
2016-08-04 04:36:28 +08:00
|
|
|
source:path that are copied, not the directory name and contents. See
|
2022-07-10 01:08:20 +08:00
|
|
|
extended explanation in the [copy](/commands/rclone_copy/) command if unsure.
|
2016-08-04 04:36:28 +08:00
|
|
|
|
|
|
|
If dest:path doesn't exist, it is created and the source:path contents
|
|
|
|
go there.
|
|
|
|
|
2018-11-24 21:44:25 +08:00
|
|
|
**Note**: Use the `-P`/`--progress` flag to view real-time transfer statistics
|
|
|
|
|
2021-04-01 02:12:08 +08:00
|
|
|
**Note**: Use the `rclone dedupe` command to deal with "Duplicate object/directory found in source/destination - ignoring" errors.
|
|
|
|
See [this forum post](https://forum.rclone.org/t/sync-not-clearing-duplicates/14372) for more info.
|
|
|
|
|
2016-08-04 04:36:28 +08:00
|
|
|
|
|
|
|
```
|
2017-09-30 21:19:47 +08:00
|
|
|
rclone sync source:path dest:path [flags]
|
|
|
|
```
|
|
|
|
|
2020-05-22 18:17:37 +08:00
|
|
|
## Options
|
2017-09-30 21:19:47 +08:00
|
|
|
|
|
|
|
```
|
2019-04-13 18:01:58 +08:00
|
|
|
--create-empty-src-dirs Create empty source dirs on destination after sync
|
|
|
|
-h, --help help for sync
|
2016-08-04 04:36:28 +08:00
|
|
|
```
|
|
|
|
|
2019-06-20 23:18:02 +08:00
|
|
|
See the [global flags page](/flags/) for global options not listed here.
|
|
|
|
|
2020-05-22 18:17:37 +08:00
|
|
|
## SEE ALSO
|
2016-08-04 04:36:28 +08:00
|
|
|
|
2018-10-15 18:03:08 +08:00
|
|
|
* [rclone](/commands/rclone/) - Show help for rclone commands, flags and backends.
|
2018-03-19 18:06:13 +08:00
|
|
|
|