Skip to main content

SFTP Errors

This page covers common connection and transfer errors you may encounter when using SFTP.

Connection Errors​

"Connection timed out" / "Connection refused"​

The SFTP client cannot reach the remote server.

Cause: The client's IP address is not whitelisted on the server's firewall, or the SFTP service is not running on the expected port.

Resolution:

  1. Determine the client IP address. See SFTP Troubleshooting for commands to check your public IP.
  2. Whitelist the client IP address on the remote server's firewall or security group.
  3. Verify the SFTP service is running and listening on the configured port (default: 22).

"Permission denied" / "Authentication failed"​

The server rejected the login credentials.

Cause: Incorrect username, wrong private key, a password or passphrase where the server expects none, or incorrect file permissions on the private key.

Resolution:

  1. Verify the username matches exactly (case-sensitive).
  2. Ensure the password field is blank if using key-based authentication, and that no passphrase is set on the key unless the server requires one.
  3. Confirm the private key file has read-only permissions (chmod 400 on Linux/macOS). See SFTP Troubleshooting for Windows permission commands.
  4. Make sure you are using the correct key format for your client (.pem for OpenSSH, .ppk for PuTTY/WinSCP). See Authentication for conversion steps.

FTP / FTPS Limitations​

If your server uses FTP or FTPS (as opposed to SFTP), be aware of the following:

  • Passive mode only -- eCourtDate supports Passive (PASV) mode for FTP/FTPS connections. Active mode is not supported.
  • UTF-8 filenames required -- Filenames must use UTF-8 encoding. Files with non-UTF-8 characters in their names may fail to transfer or may not be recognized by keyword filters.

Need help? Contact the eCourtDate team at help@ecourtdate.com.