SFTP Download Documentation
Version:Â 1.2.0Â
Retrieved:Â 2025-10-09 15:16:18
SFTP Download
The module downloads the file specified by either the Remote File property or the sftpdownload.file on the incomming message. If the sftpdownload.file contains an array of files, all files will be downloaded.
Possible Errors
If a file or the download directory doesn't exist on the SFTP server the module will set an error on the message and a warning on the module. When input is an array of files, the module will download them one by one. If one file doesn't exist, the module will stop the download and set an error on the message and a warning on the module.
Settings
| Name | Requirements | Purpose | Default |
|---|---|---|---|
| Host | String with length 1-128 | The SFTP server to use. | localhost |
| Port | Number | The port to use. | 22 |
| Remote File | String with length 0-256 | The file to use on the SFTP server, if left empty the value will be taken from 'sftpdownload.file' on the incoming message. | Â |
| Download Directory | String with length 0-256 | The directory where to store the file, if left empty the value will be taken from 'sftpdownload.directory' on the incoming message. The directory must exist. | Â |
| Delete remote file after download | Boolean | If true the remote file(s) will be deleted after a successful download" | true |
Credential
This module contains an option to select credentials to use in the module. All credentials supported by the module are presented in a drop-down.
Input
If the Remote File property is set, the module will download that file from the SFTP server. If it is left empty, the filename or an array of filenames, will be taken from the sftpdownload.file property on the incoming message.
Output
Output is the same as input
Examples
Download file from SFTP server by setting the module property
# Settings:
Host="localhost"
Port=22
Remote File="example.txt"
Download Directory="downloads"
Delete remote file after download=true
# Incoming message:
{
"SomeKey": "SomeValue"
}
Download file from the SFTP server by taking the name from the incoming message.
# Settings:
Host="localhost"
Port=22
Remote File=""
Download Directory="downloads"
Delete remote file after download=true
# Incoming message:
"sftpdownload": {
"file": "myfile.txt"
}
Download multiple files from the SFTP server by taking the name from the incoming message
# Settings:
Host="localhost"
Port=22
Remote File=""
Download Directory="downloads"
Delete remote file after download=true
# Incoming message:
"sftpdownload": {
"file": [
"file1",
"test/file2",
"testdata/data/file3"
]
}
Search Documentation
Data Sources
Files