TrueCloudLab/rclone
16
0
Fork 2
Code Issues 1 Pull requests 1 Projects Releases Packages Wiki Activity Actions
rclone/docs/content/commands/rclone_sync.md

63 lines
2.1 KiB
Markdown
Raw Normal View History

Use cobra autogenerated docs * put the most up to date docs into the code * generate command docs using rclone gendocs * put command docs into own directory * remake them into MANUAL.md
2016-08-03 20:36:28 +00:00
---
title: "rclone sync"
docs: add description to commands and index page
2020-05-16 14:11:55 +00:00
description: "Make source and dest identical, modifying destination only."
Use cobra autogenerated docs * put the most up to date docs into the code * generate command docs using rclone gendocs * put command docs into own directory * remake them into MANUAL.md
2016-08-03 20:36:28 +00:00
slug: rclone_sync
url: /commands/rclone_sync/
gendocs: add autogenerated header to all docs
2020-02-10 12:31:45 +00:00
# autogenerated - DO NOT EDIT, instead edit the source code in cmd/sync/ and as part of making a release run "make commanddocs"
Use cobra autogenerated docs * put the most up to date docs into the code * generate command docs using rclone gendocs * put command docs into own directory * remake them into MANUAL.md
2016-08-03 20:36:28 +00:00
---
docs: make command docs titles be one higher
2020-05-22 10:17:37 +00:00
# rclone sync
Use cobra autogenerated docs * put the most up to date docs into the code * generate command docs using rclone gendocs * put command docs into own directory * remake them into MANUAL.md
2016-08-03 20:36:28 +00:00
Make source and dest identical, modifying destination only.
docs: make command docs titles be one higher
2020-05-22 10:17:37 +00:00
## Synopsis
Use cobra autogenerated docs * put the most up to date docs into the code * generate command docs using rclone gendocs * put command docs into own directory * remake them into MANUAL.md
2016-08-03 20:36:28 +00:00
Sync the source to the destination, changing the destination
Version v1.57.0
2021-11-01 15:42:05 +00: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
Version v1.59.0
2022-07-09 17:08:20 +00: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.
Use cobra autogenerated docs * put the most up to date docs into the code * generate command docs using rclone gendocs * put command docs into own directory * remake them into MANUAL.md
2016-08-03 20:36:28 +00:00
**Important**: Since this can cause data loss, test first with the
Version v1.53.0
2020-09-02 15:59:04 +00:00
`--dry-run` or the `--interactive`/`-i` flag.
rclone sync -i SOURCE remote:DESTINATION
Use cobra autogenerated docs * put the most up to date docs into the code * generate command docs using rclone gendocs * put command docs into own directory * remake them into MANUAL.md
2016-08-03 20:36:28 +00:00
Note that files in the destination won't be deleted if there were any
Version v1.55.0
2021-03-31 18:12:08 +00:00
errors at any point. Duplicate objects (files with the same name, on
those providers that support it) are also not yet handled.
Use cobra autogenerated docs * put the most up to date docs into the code * generate command docs using rclone gendocs * put command docs into own directory * remake them into MANUAL.md
2016-08-03 20:36:28 +00:00
It is always the contents of the directory that is synced, not the
docs: grammatical clarification in sync docs
2022-06-19 13:26:53 +00:00
directory itself. So when source:path is a directory, it's the contents of
Use cobra autogenerated docs * put the most up to date docs into the code * generate command docs using rclone gendocs * put command docs into own directory * remake them into MANUAL.md
2016-08-03 20:36:28 +00:00
source:path that are copied, not the directory name and contents. See
Version v1.59.0
2022-07-09 17:08:20 +00:00
extended explanation in the [copy](/commands/rclone_copy/) command if unsure.
Use cobra autogenerated docs * put the most up to date docs into the code * generate command docs using rclone gendocs * put command docs into own directory * remake them into MANUAL.md
2016-08-03 20:36:28 +00:00
If dest:path doesn't exist, it is created and the source:path contents
go there.
Version v1.45
2018-11-24 13:44:25 +00:00
**Note**: Use the `-P`/`--progress` flag to view real-time transfer statistics
Version v1.55.0
2021-03-31 18:12:08 +00: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.
Use cobra autogenerated docs * put the most up to date docs into the code * generate command docs using rclone gendocs * put command docs into own directory * remake them into MANUAL.md
2016-08-03 20:36:28 +00:00
```
Version v1.38
2017-09-30 13:19:47 +00:00
rclone sync source:path dest:path [flags]
```
docs: make command docs titles be one higher
2020-05-22 10:17:37 +00:00
## Options
Version v1.38
2017-09-30 13:19:47 +00:00
```
Version v1.47.0
2019-04-13 10:01:58 +00:00
--create-empty-src-dirs Create empty source dirs on destination after sync
-h, --help help for sync
Use cobra autogenerated docs * put the most up to date docs into the code * generate command docs using rclone gendocs * put command docs into own directory * remake them into MANUAL.md
2016-08-03 20:36:28 +00:00
```
docs: add a new page with global flags and link to it from the command docs In f544234 we removed the global flags from each command as it was making each page very big and causing 1000s of lines of duplication in the man page. This change adds a new flags page with all the global flags on and links each command page to it. Fixes #3273
2019-06-20 15:18:02 +00:00
See the [global flags page](/flags/) for global options not listed here.
docs: make command docs titles be one higher
2020-05-22 10:17:37 +00:00
## SEE ALSO
Use cobra autogenerated docs * put the most up to date docs into the code * generate command docs using rclone gendocs * put command docs into own directory * remake them into MANUAL.md
2016-08-03 20:36:28 +00:00
Version v1.44
2018-10-15 10:03:08 +00:00
* [rclone](/commands/rclone/) - Show help for rclone commands, flags and backends.
Version v1.40
2018-03-19 10:06:13 +00:00
Reference in a new issue Copy permalink