Configuring an FTP server

The server form is organized into sections to help you configure your connection step by step.

Server Details

Enter the hostname and port your FTP server is listening on (if you haven't changed this you can leave this field blank and DeployHQ will use the default port 21).

FTP Server Details

Authentication

Enter your username and password.

FTP Authentication

Deployment Path

Enter the directory on the server where your files should be placed.

FTP Deployment Path

Advanced Options

Enable passive (PASV) mode if your server supports it. If your FTP server doesn't report hidden files such as .gitignore by default, you can enable the option to Force the server to report hidden files.

Caveats

If you see timeout issues when connecting your FTP server to DeployHQ, this might be due to the data transfer connection not being established correctly between both endpoints. You might also see 425 Unable to build data connection: Connection timed out when debugging this situation.

If this is the case, make sure to use PASV, as this mode tends to help create a connection properly to your server. Mind that you might need to open the PASV-corresponding ports in your server to allow this kind of connection. More information on this topic can be found here.

If you're seeing a certificate/SSL error whilst trying to add your FTP server, it may be worth trying to connect via FTPS instead, as your server may not allow insecure logins.