Network: Connect to server

Connect to an FTP, FTPS, or SFTP server.

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

FieldRequiredWhat it does
Connection nameYesConnection name
ProtocolYesThe transfer protocol (FTP, FTPS, or SFTP) Choices: SFTP, FTP, FTPS. Default: sftp.
HostYesThe FTP server hostname or IP address
PortNoThe FTP server port (default 21 for FTP, 22 for SFTP) Default: 0.
UsernameYesThe FTP username
Private key file path (SFTP)NoThe path to the SSH private key file (SFTP only)
Private key passphrase (SFTP)NoSFTP only: the passphrase of an encrypted private key.
Allow legacy ssh-rsa algorithms (SFTP)NoSFTP only: also offer the old ssh-rsa (SHA-1) algorithms, for old servers that need them. Default: off.
Expected host key fingerprint (SFTP)NoSFTP 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)NoSFTP 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)NoFTPS only: start TLS straight away (implicit, usually port 990) instead of switching to it after connecting. Default: off.
Verify TLS certificate (FTPS)NoFTPS 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)NoFTPS only: a CA or server certificate file to trust, for a self-signed or private certificate.
Client certificate file (FTPS)NoFTPS only: your client certificate file, when the server asks for one.
Client certificate key file (FTPS)NoFTPS only: the key file for your client certificate.

See all Network steps.

Errors

ErrorDescription
Connection failedCould not connect to the remote server (check host, port, and network)
Authentication failedThe 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

Related functions

Get started

See it working on your own data

Everything documented here ships with the platform – try the document tools free, or have your first automation working in 7 days.