File system Upload
CertifiedUpload file to the local filesystem
File system Upload
Upload file to the local filesystem
Writes a file from Kestra internal storage to a local path under configured allowed-paths; access outside is denied.
Source must be a kestra:// URI. Overwrite defaults to true; the destination path defaults to the source filename inside the first configured allowed-paths entry.
Example (Kestra config):
plugins:
configurations:
- type: io.kestra.plugin.fs.local.Upload
values:
allowed-paths:
- /data/files
type: io.kestra.plugin.fs.local.UploadExamples
id: fs_local_upload
namespace: company.team
inputs:
- id: file
type: FILE
tasks:
- id: upload
type: io.kestra.plugin.fs.local.Upload
from: "{{ inputs.file }}"
to: "/data/uploads/file.txt"
overwrite: true
workerGroup: "etl-worker"
Properties
from *Requiredstring
Source file URI
Kestra internal storage URI of the file to upload
Pebble expression referencing an Internal Storage URI e.g. {{ outputs.mytask.uri }}.
overwrite booleanstring
trueOverwrite existing files
If false, the task fails when the target file already exists
pluginDefaultsRef Non-dynamicstring
Reference (ref) of the pluginDefaults to apply to this task.
to string
Destination path
Optional local path; when omitted, defaults to the source filename inside the first configured allowed-paths entry
Outputs
size integer
Size of the uploaded file in bytes
uri string
uriURI of the uploaded file
