How to Troubleshoot Common SFTP Connection Errors

If you’re having trouble connecting to your environment via SFTP, follow these steps to resolve common issues.

Connection Timed Out Error

Problem: Your SFTP client displays a “Connection Timed Out” error.

Steps to Resolve:

1. Check Server Address and Port:
   • Ensure you are using the correct server address and port number. For Servebolt, the port should be set to 22.
2. Verify Internet Connection:
   • Confirm that your internet connection is stable and operational.
3. Check Environment Status:
   • Ensure that the environment or Bolt is online and reachable. You can do this by pinging your environment or your Host IP. You can also check our status page.

Incorrect Protocol, Port, Username, or Password

Problem: You receive errors due to incorrect protocol, port, username, or password settings.

Steps to Resolve:

1. Select SFTP Protocol:
   • Ensure that your SFTP client is set to use the SFTP protocol. For example, in Filezilla, select SFTP when configuring a new site.

2. Verify Port Number:
   • Check that the port number is set to 22 in your SFTP client.
3. Double-Check Credentials:
   • Re-enter your username and password to ensure they are correct.
4. Check SSH/SFTP Access:
   • Verify that SSH/SFTP access is enabled in the Admin Panel under “Access”.

Too Many Failed Login Attempts

Problem: You are locked out due to too many failed login attempts.

Steps to Resolve:

1. Wait for Lockout Period:
   • If you have made 10 failed login attempts, wait for 10 minutes. After 30 failed attempts within an hour, the lockout may last up to an hour.
2. Reset SFTP Password:
   • If necessary, reset your SFTP password in the Admin Panel. Recheck all settings, including protocol, port, hostname, username, and password.

By following these steps, you should be able to troubleshoot and resolve common SFTP connection issues effectively. If problems persist, contact Servebolt support for additional help.