Operations and filters
Weik.io 2026.2Choose the rclone command a run uses and the patterns that pick its files. Product page · Video
Watch: Shape what moves, 4:06
The video filters what moves and chooses between copy, move and sync.
This part of the video couldn't be loaded.
| Field | What it does |
|---|---|
operation |
Sets the rclone command the run uses |
filters |
Lists the patterns of the files that move |
flags |
Passes rclone flags that no other field sets |
retries |
Sets how many times rclone tries before the run counts as failed |
retriesSleep |
Sets how long rclone waits between tries |
Operations#
| Operation | What happens | Choose it when |
|---|---|---|
copy |
Copies new and changed files to the destination and leaves the source as it was. | The source must keep its files. |
move |
Moves the files. Once a file is at the destination, rclone deletes it from the source. | The source is a supplier’s outbox that should be empty after the run. |
sync |
Makes the destination the same as the source, which deletes files from the destination that the source doesn’t have. | The destination must mirror the source. |
Other rclone commands work too, such as check after a nightly sync to compare the two ends, or bisync to keep two shares in step both ways. An apply fails when operation isn’t a command of the agent’s rclone. The error points to the field. In Weik.io 2026.2, the agent’s rclone is rclone 1.75.1.
Filters#
filters is a list of patterns. Only the files that match one of them move:
spec:
operation: move
filters: ["*.pdf", "*.xml"]For the filters above, rclone runs with an include rule for each pattern, followed by one exclude rule for everything else:
--filter "+ *.pdf" --filter "+ *.xml" --filter "- **"An entry that starts with + or - is already an rclone filter rule and passes to rclone as written:
filters: ["- archive/**", "+ invoices/*.pdf"]Flags#
rclone flags that no other field sets, such as --max-age and --transfers, go into flags as written. The flags come before the filter rules on rclone’s command line:
spec:
operation: copy
flags: ["--max-age", "24h", "--transfers", "8"]
filters: ["*.csv"]Retries#
retries is how many times rclone tries the work within one run, from 0 to 10. retriesSleep is how long it waits between tries. Without them rclone tries three times with no wait between.
spec:
retries: 5
retriesSleep: 30sA run that still ends with errors fails and raises a problem that points to the run. To see what rclone wrote, run the weikio logs command in the problem. Runs and transferred files shows a failed run.
The transfer document#
apiVersion: weik.io/v1
kind: mft
metadata: { name: supplier-invoices, project: finance }
spec:
schedule: "0 0 5 * * ?"
source: { remote: supplier-ftp, path: /outgoing }
destination: { remote: invoice-archive, path: invoices/incoming }
operation: move
filters: ["*.pdf"]
retries: 5
retriesSleep: 30sApplying a changed transfer builds its next version. Deploy that version to devtest and watch a run before you promote it to production.