SFTP
Read and write files on an SFTP server, with the same folder globbing, Bookmark and per-file fan-out the cloud file connectors have.
Settings
What the connection form asks for. Every connection has a Staging side, which it needs, and an optional Production side with values of its own; both ask for the same settings.
| Host | |
| Port | Blank uses 22. |
| Base folder | Optional folder every path on a node is relative to, e.g. /home/partner/incoming. Blank uses the login directory. |
| Host key fingerprint | Optional SHA256 fingerprint (from `ssh-keyscan -t rsa host | ssh-keygen -lf -`). Set it and a server presenting a different key is refused; leave it blank to accept whichever key the server offers. |
| Username | |
| Method | Choices: Password; Private key. |
| Password | Shown when Method is Password. Stored encrypted, and never shown again after you save it. |
| Private key | Paste the whole OpenSSH or PKCS#8 private key, including the BEGIN/END lines; its line breaks are restored for you. Shown when Method is Private key. Stored encrypted, and never shown again after you save it. |
| Key passphrase | Only if the private key is encrypted. Shown when Method is Private key. Stored encrypted, and never shown again after you save it. |
Testing the connection
Test connects, signs in and finds the base folder. It only reads, never writes to the server, and gives up after 10 seconds.
Good to know
- Set the host key fingerprint and a server presenting a different key is refused. Left blank, whichever key the server offers is accepted.
- A server that goes silent cannot hold a run for ever: Trinium gives up on a stalled connection and fails the run by name.
- A Live run reading from SFTP waits for each file to stop changing before it reads it, and skips by name one that is still being written.
Nodes that use it
Copy, move or delete the files an input, List Files or File from URL hands it through its Files anchor, before the data is processed or after the run succeeds or fails.
List the files in a folder as rows, with each one's path, name, size and modified time, without reading any of them.
Write the pipeline's output to an SFTP server with a templated path (dates, run id) and a write mode.
Read a single file or a whole folder from an SFTP server. A Bookmark can read only the files no successful run has read.