Skip to content
Weik.ioDocs
2026.2
Try Weik.io

Operations and filters

Weik.io 2026.2

Choose 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.

On this page
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: 30s

A 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#

finance/transfers/supplier-invoices.yaml
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: 30s

Applying a changed transfer builds its next version. Deploy that version to devtest and watch a run before you promote it to production.

Sign in to the live demo

Sign in with the shared viewer account. It can open every screen of the example projects but can't change anything.

E-mail
viewer@demo.weik.io
Password
try-weikio-live-demo
Open the live demo