Fixing FTP and SFTP Connection Errors
Find the message or symptom from a failed test below. The server's Log ( on iPhone and iPad, the toolbar on a Mac) shows how far the connection got.
Address not found
Address Not Found offers a correction when FTP Files can tell what you meant, such as Use nas.local for nas. Names ending in .local only work on the same network.
The connection times out or is refused
Nothing answered. Check that:
- The server is on, awake and running its SFTP or FTP service.
- The port matches the protocol. With Automatic, the test then says Couldn't connect with any encryption. Check the address and port.
- No firewall blocks the port.
- On a slow link, Connect Timeout in Settings (the Finder tab on a Mac) is raised from 5 seconds.
Away from home
A NAS, Mac or PC at home needs a VPN or port forwarding to be reached from elsewhere; a web host doesn't. With a VPN such as Tailscale on both ends, use the server's VPN address. With port forwarding on the router, FTP and FTPS need the passive ports forwarded too.
Login works but folders don't list
The passive ports are blocked or not forwarded; see Ports and passive mode in Adding a Server.
Login refused
Incorrect username or password lets you correct both and tap Authenticate; Missing username and password means the server wants a login.
- Web hosts often want the full user name, such as
upload@example.com. - A server that only accepts keys refuses every password; pick an SSH Key in the prompt, as SSH Keys explains.
- FTP Files signs in with a password or a key, so a server that only offers keyboard-interactive or two-factor login refuses it.
FTPS isn't supported
Server does not support explicit FTPS. Try implicit FTPS or connect without encryption. means the server wouldn't start encryption. Try Implicit FTPS or SFTP over SSH; see Which protocol? in Adding a Server.
Host key and certificate prompts
See Host Keys for Verify New Host and Wrong Hostkey, and FTPS Certificates for Untrusted Certificate, Certificate Mismatch and Revoked Certificate.
Access denied
The login worked, but Directory can't be read. Over SFTP an empty Directory means the server's root, which many servers refuse. Set it to ~/ or a folder you can read, on a NAS a shared folder; see NAS, Linux and Raspberry Pi.
Local network access
iPhone and iPad ask before FTP Files may reach devices on your network. If the answer was no, you'll see Local Network Access Required: tap Open Settings and turn on Local Network, also under Privacy & Security → Local Network in Settings, and in System Settings on a Mac. It only matters for names ending in .local, .lan, .home.arpa or .internal, and private addresses such as 192.168.1.20.
Protocol still Automatic
Test this server to resolve its connection protocol, which is set to Automatic. means it was never tested. Tap Test Server once.
Still stuck?
Further Help lists the ways to reach Anders; include the kind of server and the test's message.