Connecting to Acquia Cloud with an FTP client

You can use a third-party FTP client to connect to your Acquia Cloud environments and work directly with your code, files, backups, and import folders.

Before you begin

To successfully connect with and use FTP with your Acquia Cloud based applications, take the following steps:

  • Register your public key with Acquia Cloud

    To connect to an Acquia Cloud server, you need to both have a private/public key pair and register the public key in Acquia Cloud. For information about how to do this, see Enabling SSH access.

  • Enable Live Development

    You must first enable live development to interact with your codebase on Acquia Cloud using SFTP. For information about how to do this, see Using Live development mode to change code on your server. If you are working with files, this step is not necessary.

    Important

    After you make changes to your codebase using live development, you must commit all the changes to your Acquia Cloud repository, or else the changes will be lost when you exit live development.

Selecting an FTP client

You can use just about any client that supports SFTP connections to remote servers. Here are a few possibilities to consider:

Example

Here is an example that demonstrates how to connect to Acquia Cloud with SFTP, based on WinSCP:

  1. Start the WinSCP application.

  2. In left pane of the WinSCP Login screen, select Session and enter the following:

    WinSCP login screen

    • Under File protocol, select SFTP.
    • In the Host name field, enter the full DNS server name of the Acquia Cloud server you want to connect to. The server name is listed on the Cloud > Servers page of the Acquia user interface. For example: ded-1234.devcloud.hosting.acquia.com.
    • In the User name field, enter [site].[env], where [site] is the site name, and where [env] is the environment you want to connect to (one of prod, test, or dev).
    • Password: Leave this field blank.
  3. Click Advanced.

    WinSCP advanced settings

  4. In the left pane of the Advanced Site Settings page, select Directories.

  5. Under Remote directory, enter the live development folder for your application’s Development environment, /mnt/gfs/[sitename].dev/livedev/docroot.

  6. Under Local directory, enter the docroot folder in your local code repository.

  7. In the left pane of the Advanced Site Settings page, select Authentication.

  8. In the Private key file field, select your private key. You may need to convert your SSH key into a format compatible with WinSCP. You can use PuTTYgen (which is included 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.

  9. Click Ok.

  10. In the Save session as dialog, enter [site].[env], where [site] is the site name, and where [env] is the environment you want to connect to (one of prod, test, or dev).

  11. Click Login to connect to your Acquia Cloud server.

Contact supportStill need assistance? Contact Acquia Support

Acquia: Think Ahead

53 State Street, 10th Floor
Boston, MA 02109
United States
Phone: 888-922-7842

Map: Google Maps
View other locations