File system Download
CertifiedDownload local file to internal storage
File system Download
Download local file to internal storage
Copies a local file (within configured allowed-paths) into Kestra internal storage. Fails if the source is missing; preserves size and file extension when possible.
Local access requires allowed-paths in the plugin configuration.
Example (Kestra config):
plugins:
configurations:
- type: io.kestra.plugin.fs.local.Download
values:
allowed-paths:
- /data/files
type: io.kestra.plugin.fs.local.DownloadExamples
id: fs_local_download
namespace: company.team
tasks:
- id: download
type: io.kestra.plugin.fs.local.Download
from: "/data/files/source.csv"
workerGroup: "etl-worker"
Download a local file and fail if its SHA-256 checksum does not match
id: fs_local_download_checksum
namespace: company.team
tasks:
- id: download
type: io.kestra.plugin.fs.local.Download
from: "/data/files/source.csv"
validateChecksum: true
checksumExpected: "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"
Properties
from *string
Source file path
Absolute local path of the file to download
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
{}1150checksumAlgorithm string
SHA_256MD5SHA_1SHA_256SHA_512Checksum algorithm to use
Defaults to SHA_256. The computed checksum is always exposed on the output as checksum. MD5 and SHA_1 are deprecated and considered weak; prefer SHA_256 or SHA_512.
checksumExpected string
Expected checksum value to compare against the downloaded file
Required when validateChecksum is true. Comparison is case-insensitive.
validateChecksum booleanstring
falseValidate the downloaded file against an expected checksum
When enabled, the task fails if the computed checksum does not match checksumExpected. The downloaded file is not stored in internal storage if validation fails.
Outputs
checksum string
Checksum of the downloaded file
Hex-encoded digest computed with checksumAlgorithm. Populated whenever the file is downloaded successfully.
size integer
Size of the downloaded file in bytes
uri string
uriURI of the file in Kestra storage
