FileZilla on Pantheon

Information about using the FileZilla FTP client for your Pantheon Drupal or Wordpress site.


FileZilla is a free open source FTP client that is available for Windows, Mac OS X, and Linux.

Getting Started

Make sure you have your SFTP credentials on hand, you will need this later to connect to Pantheon using FileZilla. See how to find the SFTP credentials for your site.

Download FileZilla

If you do not have FileZilla installed, download the latest version and install it on your computer.

Configure FileZilla

Open FileZilla and launch the Site Manager by clicking the first icon in the menu bar, or by going to the File Menu > Site Manager option. From the Site Manager screen, click the New Site button.

Enter your SFTP connection details:

Adding a new site to the Site Manager

Authentication

Select from one of the following Logon Type: options in the General tab:

  • For SSH Key-Based authentication set the Logon Type: dropdown to "Key file". In the Key file: box enter the path to or browse and select your private SSH key (usually named id_rsa) associated with the public key loaded into your User Dashboard.

  • For Password-Based authentication set the Logon Type: dropdown to "Normal" and then enter your Pantheon account email address and your password. You can also select the "Ask for password" type if you don't want to save the password and instead be prompted for it every time you can connect.

Connection Prompt

When you first connect via SFTP you may be prompted to accept the server's host key and store it in cache for future connections. This allows you to connect to the server and manage your files for the current session.

Access Code and Files

After logging in, you can access your application code in the /code directory.

Your file uploads (Drupal's sites/default/files and WordPress's wp-content/uploads) can be found in the files directory. Your log files can be found in the /logs directory.

Troubleshooting

Uploading to the Files Directory

Filezilla does not correctly upload files when the target directory on Pantheon is files. We recommend setting the target directory to code/sites/default/files, which is a symlink to files on Pantheon. If you experience issues using FileZilla, try the task using an alternate program such as Transmit (Mac OS) or WinSCP (Windows).

nodename nor servname provided, or not known

The following error is caused by an invalid hostname, most often the result of a typo:

Error:            ssh_init: nodename nor servname provided, or not known
Error:            Could not connect to server

Double check settings and resolve typos to fix this issue.