FTP connections

Use FTP only when your provider requires an unencrypted connection. Plain FTP sends your username, password and file contents without encryption. FTPeach shows a warning beside the protocol selector. If the server offers an encrypted option, use FTPS or SFTP with the details your provider supplies.

On this page

Connect to an FTP server

Get the FTP hostname, port, username, password and destination folder from your provider. The address of your public website may not be its FTP hostname.

  1. Open the source menu at the top of a pane and choose Server.
  2. Choose FTP. Enter the server hostname in Address, then its Port. Use the provider's port rather than guessing from a website URL.
  3. Enter Username and Password, then select Connect.
  4. When the folder listing appears, open the folder your provider named. Try a small file with Your first transfer before a large upload.

FTP connection form with the unencrypted-connection warning beside the protocol selector.FTP connection form with the unencrypted-connection warning beside the protocol selector.

The warning marks plain FTP.

To reuse the connection, save a bookmark.

Passive and active mode

FTP uses a connection for commands and separate connections for folder listings and file contents. This is why a successful login does not always mean files can be listed or transferred. These modes apply to both FTP and FTPS.

Mode Who opens the data connection? What to check when it fails
Passive Your computer connects to a port offered by the server. Ask the administrator whether the server's passive ports are reachable through its firewall and router.
Active The server connects back to your computer. The server must be able to reach your computer through its firewall and router. Use only when your administrator has arranged this.

Start with passive mode. In Edit > Settings > Connection, leave Active FTP mode (instead of passive) unchecked. If the administrator specifically asks for active mode, enable it, choose Save, then reconnect. Changing the setting does not switch an existing connection.

Connection settings showing Active FTP mode unchecked and the proxy option below it.Connection settings showing Active FTP mode unchecked and the proxy option below it.

An unchecked Active FTP mode means passive mode. The setting is unavailable while a proxy is enabled; keep passive mode for proxy connections.

Active mode is not a general cure for a blocked transfer: it needs an incoming connection to your computer. See the networking reference for deployment details.

When FTP does not connect or list files

Message or symptom Next step
Incorrect username or password. Confirm the FTP account and whether the provider actually requires FTPS or SFTP.
The server refused the connection. Check the address and port. Check the FTP hostname and port and ask whether the service is running.
The server isn't responding. Check the address, port and network. Check server availability, VPN requirements and network access.
Login appears to work, but the listing or transfer stalls Check the data-connection mode above and ask the administrator to check the relevant firewall and router ports.
The server couldn't connect back in active FTP mode. Try passive mode. Turn active mode off, save and reconnect, unless your administrator requires and can configure active mode.
You don't have permission for this operation. Confirm the destination folder and the account's permissions. A successful login does not grant access to every folder.

For a failed file operation, follow transfer troubleshooting. Use the log when asking for help, removing private details before sharing it.

Read this page on GitHub

Swipe to explore the enlarged image.