Sometimes, you'd like to use sFTP to connect to the File System at Acquia Cloud to download a backup copy of files from the file system, or to have a copy of files for local development.
sFTP is a familiar protocol, File Transfer Protocol, it uses SSH and it supports the full security and authentication functionality of SSH to protect against password sniffing and man in the middle attacks, with the ease and convenience of FTP. It's great for large numbers of files or for times when you'd like a fault tolerant protocol that remembers where you were in a download.
When you're looking for an sFTP program, just search your favorite app store, or find a well known free one
These instructions are for WinsSCP, but other programs are similar
- In File protocol, select SFTP (SSH Fille Transfer Protocol).
- In Host name (or Server) , enter the name of the file server listed on the Servers page of the Acquia Cloud Platform user interface. For example:
- In User name, enter
[site]is the sitename, and where
[env]is the environment you want to connect to (one of
dev). For an application named bestcompany you'd use bestcompany.dev to ssh to the Dev environment or bestcompany.prod to conect to the prod environment.
- Leave the password blank, you're going to authenticate with your SSH key.
Note: Always double-check in cloud.acquia.com for your application and environment that the host name and host or server name that you are using match eachother and are correct.
Aquia Cloud NEXT environments:
To connect to your Acquia Cloud Next file system through SFTP, you can use the fully qualified SSH domain name in the
<USER_NAME>@<HOST_NAME> format. For example,
On the Advanced Site Settings page, select Authentication.
In Private key file, select your private key. You must convert your SSH key into a format compatible with WinSCP. You can use PuTTYgen (which is in the WinSCP installation package) to convert your key into the
.ppk format required by WinSCP. For more information, see Converting SSH keys for WinSCP.
Once you are connected via SSH (for the PuTTY FTP program you connect via PuTTY, then open the FTP utility), then you are logged into the user directory for your application by default.
- You want to switch directories to the File System.
- In most cases the information you need is in the public files directory, and this has the format
Using our earlier example bestcompany.prod, that's /mnt/files/bestcompany.prod/default/files - where default is the default directory where Drupal stores files you may need to adjust that foldername if you have a multi-site. Take a look in the sites directories to see which folders are there, and if there are more folders than default, consult your sites.php file from the codebase for an idea of which folder is for which domain.