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

Register your public key with Acquia Cloud

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

Enable Live Development

In order to interact with your codebase on Acquia Cloud using SFTP, you must first enable live development. For information about how to do this, see Using Live development mode to change code on your server.

Choosing an FTP client

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

Windows OS

Mac OS X

Here is an example showing how to connect to Acquia Cloud using SFTP:

Windows Example: Connecting with 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