FTP Files
All topics

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.

Get FTP Files

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:

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.

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.