Help Centre › Building Processes
Connect to an FTP, FTPS, or SFTP server.
Add it to a process
In the process designer, open the Add step tab. Find Connect to server under Network › Connection, or type its name in the search box, and drag it onto the canvas.
Fields
| Field | Required | What it does |
|---|---|---|
| Connection name | Yes | Connection name |
| Protocol | Yes | The transfer protocol (FTP, FTPS, or SFTP) Choices: SFTP, FTP, FTPS. Default: sftp. |
| Host | Yes | The FTP server hostname or IP address |
| Port | No | The FTP server port (default 21 for FTP, 22 for SFTP) Default: 0. |
| Username | Yes | The FTP username |
| Private key file path (SFTP) | No | The path to the SSH private key file (SFTP only) |
| Private key passphrase (SFTP) | No | SFTP only: the passphrase of an encrypted private key. |
| Allow legacy ssh-rsa algorithms (SFTP) | No | SFTP only: also offer the old ssh-rsa (SHA-1) algorithms, for old servers that need them. Default: off. |
| Expected host key fingerprint (SFTP) | No | SFTP only: the server's host key fingerprint (SHA256 base64 or MD5 hex). The step refuses a server whose key differs. |
| Trust host key on first connect (SFTP) | No | SFTP only: accept an unknown host key the first time and remember it. Later connections must show the same key. Default: off. |
| Use implicit FTPS (port 990) | No | FTPS only: start TLS straight away (implicit, usually port 990) instead of switching to it after connecting. Default: off. |
| Verify TLS certificate (FTPS) | No | FTPS only: check the server's certificate. Turn off only for a self-signed certificate you cannot add as a CA file. Default: on. |
| CA / server certificate file (FTPS) | No | FTPS only: a CA or server certificate file to trust, for a self-signed or private certificate. |
| Client certificate file (FTPS) | No | FTPS only: your client certificate file, when the server asks for one. |
| Client certificate key file (FTPS) | No | FTPS only: the key file for your client certificate. |
See all Network steps.
Errors
| Error | Description |
|---|---|
| Connection failed | Could not connect to the remote server (check host, port, and network) |
| Authentication failed | The username, password, or key was rejected by the server |
Tips
- Use SFTP for encrypted, secure file transfers
- Store credentials in the Vault instead of hardcoding them in the process