If you’re having troubles with SFTP, you’re in the right place! We’re here to help you understand common SFTP issues and how to address them.
The first step here is to be sure to follow our SFTP connection guide. The most common stumbling blocks, though, are as follows:
sftp.flywheelsites.com, and that the port number is 22.
If you’ve checked all the above off the list, then be sure you’re using an FTP client, like Transmit (Mac), Cyberduck (Mac), Filezilla (Mac / Windows), or WinSCP (Windows), or Forklift (Mac), just to name some of the most popular options. The main thing is to use an FTP program; you can’t simply visit
sftp.flywheelsites.com in a browser.
If your FTP client warns you about host keys when you try to connect, click the appropriate option to ignore the warning and connect anyway.
And if your FTP client can’t proceed with connection because of host keys, try quitting the program and restarting your machine. Sometimes this helps to update old information.
The biggest cause of this issue is browser caching, especially with CSS files. Your browser might not be downloading the newest version of the file, so be sure to flush your browser cache completely, and/or open the page in a private/incognito window. Some browsers, like Chrome, also allow you to force the page to load without cache by using a hard refresh, which is
cmd + shift + r on Mac (
ctrl + shift + r on Windows). Flushing the server cache from the Advanced tab of the site’s Flywheel Dashboard may also help.
If you’re editing a CSS file, also be sure that the new CSS is specific enough to override the site’s existing CSS.
In order to avoid database conflicts with concurrent users, SFTP uses a sort of caching, which takes a little time to clear out. This means that, while most of the time a new site should show up in your SFTP directory right away, it is normal for a site to take a several minutes to appear there. This is especially common when creating a new site, clone, or Staging site.
If a new site doesn’t seem to be showing up in SFTP right away, then the first thing to try is disconnecting and reconnecting. Once reconnected, use your FTP client’s “refresh” button inside each folder you open.
If that doesn’t work, disconnect from the site completely, and wait at least 10–15 minutes before reconnecting. (All site users who might be connected to SFTP should disconnect as well.) The period of inactivity should flush out the old connection details so the new, updated information will show next time. You may still want to try using the “refresh” button in your FTP client once connected though.
SFTP will automatically close the connection after several minutes of inactivity. So if you’re not navigating to new directories, or editing/adding/removing files at least somewhat frequently, then there’s a chance the connection may be closed due to inactivity.
While the time limit is high enough that this shouldn’t happen to you if you’re actively working on a site, if you know you’re going to be focused on file editing for a while, the best defense is to use your FTP client’s “refresh” command occasionally, or to make file changes locally and just use FTP to upload the file changes once you’re finished.
This issue may also have to do with the local network or FTP client in use. If you have frequent issues, it may be worth testing other FTP client software and other networks to help narrow down the problem.
This could be because the connection was closed, as described in the section above, or it could be that the FTP client or network lost the connection. The best first step here is to try the “refresh” command in your FTP client, then retry saving or uploading the file. If that doesn’t work, then disconnecting and reconnecting is likely the best option.
As with other items on this list, this too may have to do with the local network or FTP client in use, and testing other networks and programs isn’t a bad idea.
Sorry you’re still having problems, but we’re happy to help! Just reach out to our support team and we’ll gladly jump in.
The most commonly asked questions, and a few we just think you should know.25 Articles
Questions that don't fit elsewhere, or those about Flywheel in general.56 Articles
Everything you need to know to get your first Flywheel site up and running.16 Articles
Details about how to manage DNS and point your domain names at Flywheel.13 Articles
Questions relating to payments, billing and managing your account on Flywheel.13 Articles
Learn everything there is to know about what Blueprints are, how to create them and how to make the best use of them.5 Articles
How to access your WordPress database to make changes and update content.3 Articles
Everything you need to know about our amazing, free local WordPress development software for Mac and PC.6 Articles
Everything you need to know about managing your team with our Organizations feature.8 Articles
Which plugins work best, which plugins work worst, and everything in between.7 Articles
Details about everything Flywheel does to makes your site so secure.13 Articles
Information on setting up and troubleshooting with SFTP connections and file transfers.4 Articles
All there is to know about our free, automatically installed and activated SSL certificates.9 Articles
How to get the most out of Staging, which allows you to duplicate a site, make changes, and then push those changes to the live site.7 Articles
Everything you need to know about our Whitelabel subscriptions for branding and reselling Flywheel.4 Articles
Here's a free ebook!