Synchronize Files

File synchronization refers to the process of keeping files in two paths synchronized. In the console, selecting a path and pointing the pull arrow to another path can establish a file synchronization relationship between the two directories, creating a file transfer pipeline between the two paths. The file transfer pipeline flows in one direction. When a file is added to the source directory, the client program automatically transfers it to the destination directory. When establishing a file transfer pipeline, multiple options are provided to create different synchronization modes to meet different needs. This document will explain in detail the different meanings of each option.

Create transfer pipe

File transfer between paths

• From

The directory to be monitored, where all files in the transfer come from.

• To

The directory where files will be transferred to.

Sync mode

• Relative sync

It transfers files from the source to the destination.

• Absolute sync

It keeps files exactly the same between the source and destination. Extra files at the destination will be removed.

Force overwrite

• When checked

During the transfer process, if a file with the same name is found in the target directory but with a different file size or content, the file will be overwritten by the new file.

• When not checked

If a file with the same name is found in the destination directory during the transfer, it will be skipped even if the file size is different.

Note: If you choose not to overwrite, in case the file transfer is interrupted due to certain circumstances, when the connection is restored and the transfer resumes, the file will be skipped.

Validate md5

After the transfer is complete, whether to enable md5 verification of the file's integrity. If the verification fails, the file will be deleted and transferred again. This option can ensure the integrity of the file. It is recommended to enable this option when transferring large files.

Filters

Use wildcard pattern to filter files you want to transfer。

• Exclude

Exclude files or folders that match the specified keyword. During the transfer process, if a file name matches the wildcard pattern you created, it will be skipped and not transferred, similar to a blacklist or .gitignore file. This is generally used to filter out unwanted files.

• Include

Only transfer files that match the wildcard pattern you created. Before transferring, it will first match and search according to the wildcard pattern you created, and then transfer all matching files. This is similar to a whitelist. It is generally used when there are too many files in the source directory, but only certain files are needed.

Note: The default setting is "Exclude" without any filters, which means it will transfer all files. If you want to transfer all files, you can keep the default setting.

Note: If you set an "Include" rule without any valid filters, no transfers will take place. Please be mindful of avoiding this situation.

For wildcard rules, please refer to Examples of wildcard