Menu

SFTP Access and Uploads

Updated on September 1st, 2023

One of the great things about Flywheel is that there is no need to share SFTP usernames and passwords with your clients or other people that collaborate on sites with you.

Everyone on Flywheel logs into the SFTP server using their own personal username and password, and from there they have access to all of the sites that they own or collaborate on.

Note

Before you can connect via SSH or SFTP you’ll need to make sure your Flywheel account is verified. You can do this by heading to your profile page.

Configure your FTP client

To access your site’s files via SFTP, configure your FTP client using the following settings:

Mode SFTP (not regular FTP)
Host sftp.flywheelsites.com
Port 22
Username Your Flywheel username (not your email address). Find your Flywheel username here.
Password Your Flywheel password

Note

To generate a password for your SFTP account, head to your Profile > Account and click “Set an SFTP password”.

Supported FTP clients

Flywheel supports all major FTP clients, including but not limited to:

For a nice comparison of SFTP clients, check out Wikipedia’s article: Comparison of FTP client software.


Connect to SFTP with Filezilla

FileZilla is an open-source FTP client available for Mac, Windows, and Linux. You can download it for free here.

Note

Please be aware that FileZilla has been known to have malware and potentially unwanted programs included with its installation. If this is your chosen FTP please use caution.

  1. Open FileZilla.
  2. Enter sftp.flywheelsites.com in the Host field.
  3. Your Username is the same as your Flywheel username (not your email address).
  4. Your Password is typically the same as your Flywheel password. To set a new password visit Profile > Account, then click Set an SFTP password.
  5. Enter 22 for the Port.
  6. Click the Quickconnect button or press Enter to connect to the server.
  7. Click Ok if you get a warning about an unknown host key.

Connect to SFTP with Transmit

Transmit is a popular FTP client for Mac. You can learn more about Transmit here.

  1. Open Transmit.
  2. Click on the Quick Connect tab.
  3. Set the Protocol to SFTP.
  4. Enter sftp.flywheelsites.com in the Address field.
  5. Port should display 22 by default, if not, you can set the value manually.
  6. Your User Name is the same as your Flywheel username (not your email address).
  7. Your Password is typically the same as your Flywheel password. To set a new password visit Profile > Account, then click Set an SFTP password.
  8. You can leave Remote Path blank.
  9. Click on Connect or press Enter to connect to the server.
  10. Click Ok if you get a warning about an unknown host key.

Note

To save these settings for future use, click the Add to Servers button. Once saved, you can access these settings via the Servers tab (next to the Quick Connect tab).

Connect to SFTP with Cyberduck

Cyberduck is an FTP client available for Mac and Windows. You can download it for free here.

  1. Open Cyberduck.
  2. Click on the Open Connection button.
  3. Choose SFTP from the dropdown.
  4. Enter sftp.flywheelsites.com in the Server field.
  5. Port should be set to 22 by default, if not, you can enter the value manually.
  6. Your Username is the same as your Flywheel username (not your email address).
  7. Your Password is typically the same as your Flywheel password. To set a new password visit Profile > Account, then click Set an SFTP password.
  8. You can leave SSH Private Key set to None.
  9. Click on Connect or press Enter to connect to the server.
  10. Click Ok if you get a warning about an unknown host key.

Connect to SFTP with Dreamweaver

Dreamweaver is a popular web design software from Adobe. It has an FTP client built right in – here’s how to connect a Dreamweaver site to your Flywheel site.

  1. Open Dreamweaver.
  2. In the main menu, select Site > Manage Sites.
  3. Create a new site, or select an existing site and click the edit (pencil) icon.
  4. In the Site Setup area, select Servers and add a new server or edit an existing server.
  5. For Server Name, choose anything you like, usually the name of your site.
  6. Connect using SFTP.
  7. Enter sftp.flywheelsites.com for the SFTP address.
  8. Port should autofill with 22.
  9. Choose Username and Password for Authentication.
  10. Your Username is the same as your Flywheel username (not your email address).
  11. Your Password is typically the same as your Flywheel password. To set a new password visit Profile > Account, then click Set an SFTP password.
  12. Clicking the Test button will test your connection to the Flywheel SFTP server.
  13. For Root Directory, enter your Flywheel username, then a forward slash, followed by the site slug. You can also copy the path from your browser when on the site’s Flywheel dashboard, as shown:

    Note

    Organizations and Staging Sites:

    1. If the site is owned by an organization, the path is a little different. You’ll use “org-“, followed by the organization name, a forward slash, then the site slug. For example:
      /org-kurt-enpaste-agency/southpaw-scissors
    2. If you are using a staging site the path will end with staging_site, for example:
      /kurt-enpaste-agency/southpaw-scissors/staging_site

  14. For Web URL, choose the domain that matches the primary domain on Flywheel, which may be a temporary domain. Keep in mind if you have SSL turned on, you should use the https:// protocol.
  15. Click Save.

Password issues

You can view your username on your profile page in Flywheel.

To set a new SFTP password visit Profile > Account then click Set an SFTP password.

 


Add SFTP files to the media library

Sometimes it’s helpful to upload media to your site via SFTP rather than via the WordPress Media Library. This is particularly helpful if you have:

  • A large number of files to add
  • A file with a large file size

If you want to store the files on your server, you can just upload them via SFTP and you’re all set! Just keep track of where you uploaded the file and this path will allow you to link directly to the file.

However, WordPress cannot “see” those files in the WordPress Media Library automatically. To allow those files to be available inside your Media Library, there are a few extra steps required.

Upload your files via SFTP

  1. Using the SFTP client of your choice, upload the file from your computer to your Flywheel server.
  2. Make sure the files are uploaded to the /wp-content/uploads folder.

Install the Bulk Media Register plugin

Since the Media Library is driven by media IDs created when files are added via the WordPress admin area, uploading files into the wp-content/uploads via SFTP won’t automatically add them to the Media Library.

Unlike WordPress, SFTP only interacts with the filesystem and not the database. However, we can add the files to the Media Library by using a plugin. We suggest Bulk Media Register.

  1. Log into your WordPress admin area.
  2. On the sidebar, navigate to Plugins > Add New.
  3. In the search box, enter “bulk media register”.
  4. Install and activate the plugin.

Note

There are alternatives to the plugin mentioned above to import images from your server, such as the premium plugin WP All Import.

Select files to add to the Media Library

  1. On the sidebar, navigate to Bulk Media Register > Select Register.
  2. Select the files you wish to add to your Media Library, and click Register.
  3. Depending on the amount and size of your files, it may take a few minutes for them to be imported.

View your files in the Media Library

Head back to your Media Library. The files that you uploaded via SFTP will now be there!


Need help?

If you’re still having issues, you can always contact Flywheel support and we’d be happy to help you reset your password or configure your SFTP client for access.

Was this article helpful?

Getting Started

New to Flywheel? Start here, we've got all the information you'll need to get started and launch your first site!

View all

Account Management

Learn all about managing your Flywheel user account, Teams and integrations.

View all

Billing

Everything about billing, invoices and payments can be found here.

View all

Features

Flywheel hosting plans include a ton of great features. Learn about how to get a free SSL certificate, set up a staging site, and more!

View all

Platform Info

All the server and setting info you'll need to help you get the most out of your Flywheel hosting plan!

View all

Site Management

Tips and tricks for managing your sites on Flywheel, including going live, troubleshooting issues and migrating or cloning sites.

View all

Developer Hub

Learn how to connect, deploy, and more with SSH on Flywheel's platform.

View all

Growth Suite

Learn more about Growth Suite, our all-in-one solution for freelancers and agencies to grow more quickly and predictably.

View all

Managed Plugin Updates

Learn more about Managed Plugin Updates, and how you can keep your sites up to date, and extra safe.

View all

 

Flywheel help

Help is just a click away! Log into Flywheel dashboard to instantly chat with an expert, respond to a ticket, or follow along with in-depth documentation. We happily offer support 24 hours a day, 7 days a week, 365 days a year!

Log in

Try Flywheel today

Launch your next WordPress site in minutes.

 Free migrations  24/7/365 support  14 day demo sites