
File system Move
CertifiedMove or rename local files
File system Move
Move or rename local files
Moves files or directories within configured allowed-paths; destination parents are created as needed.
Overwrite is false by default and directories cannot be moved into themselves.
Local access requires allowed-paths in the plugin configuration.
Example (Kestra config):
plugins:
configurations:
- type: io.kestra.plugin.fs.local.Move
values:
allowed-paths:
- /data/files
type: io.kestra.plugin.fs.local.MoveExamples
Move a file within the local filesystem
id: move_file
namespace: company.team
tasks:
- id: move
type: io.kestra.plugin.fs.local.Move
from: /input/data.csv
to: /archive/data.csv
overwrite: true
Properties
from *string
Source file or directory path
to *string
Destination path on the local file system
assets
Assets this task consumes as inputs or produces as outputs, for lineage tracking and the asset graph (Enterprise Edition). A flow declaring this property on a task is rejected in the open-source edition.
io.kestra.core.models.assets.AssetsDeclaration
IGNOREFAILWARNAsset failure behavior
Behavior applied to the task state when a declared asset fails to render, emit, or be persisted (e.g. a lock conflict): FAIL escalates it to FAILED, WARN (default) warns it if it would otherwise succeed, IGNORE leaves the state untouched.
Whether to auto-register assets referenced dynamically at runtime that are not statically declared in inputs or outputs.
The assets consumed as inputs.
io.kestra.core.models.assets.AssetIdentifier
1The assets produced as outputs.
io.kestra.plugin.ee.assets.Dataset
1150{}1150io.kestra.plugin.ee.assets.File
1150{}1150io.kestra.plugin.ee.assets.Table
1150{}1150io.kestra.plugin.ee.assets.VM
1150{}1150io.kestra.core.models.assets.External
1150{}1150io.kestra.core.models.assets.Custom
11501Custom asset type
{}1150overwrite booleanstring
falseOverwrite existing files
If false, the task fails when the destination already exists.