How to Troubleshoot SFTP Connection Issues
If you are having trouble SFTPing in to your server, follow these steps
one-by-one until your problem is resolved.
- Make sure you log in to your server's IP ADDRESS (not your
domain) with the SYSTEM USER used to create your app;
attempting to connect to your domain directly is one of the most common
causes of SFTP connection failures.
- Make sure you attempt to connect over SFTP.
ServerPilot does not support unsecure FTP connections.
- Reset your system
user password in ServerPilot.
- Restart your SFTP client.
This can reset any password caching your client might be
- Uninstall and then reinstall your client.
This will clear any hidden caching done on your local machine.
- Try to connect with a different SFTP client.
- Attempt to SSH in to your server as
If you are unable to connect to your server over SSH, then password
authentication may have been disabled and you
will need to
- Attempt to connect through your provider's console.
If you are unable to do so, this indicates an issue with your server
that you will need to address with your provider.
Check Your SSH Config
If these above steps have failed, you might also want to check your server's
SSH in to your server as root and enter the following command:
grep 'AllowUsers' /etc/ssh/sshd_config
ServerPilot does not make any changes to this file by default.
If that command returns anything like "AllowUsers Root" or similar,
either you or your developer have edited your SSH configuration.
You will need to undo your customizations and restart SSH for your system
users created by ServerPilot to begin working correctly again.
Last updated: September 27, 2016