Information for: DEVELOPERS   PARTNERS

Connecting to Acquia Cloud with an FTP client

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

Before you begin

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

  • Register your public key with Acquia Cloud

    To connect to an Acquia Cloud server, you must 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 SSH File Transfer Protocol (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 isn’t 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 any client that supports SFTP connections to remote servers. Here are a few possibilities to consider:

Example

Here is an example demonstrating 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 sitename, and where [env] is the environment you want to connect to (one of prod, test, or dev).
    • Password: Leave this field empty.
  3. Click Advanced.

    WinSCP advanced settings

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

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

  6. Under Local directory, change to the docroot directory 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 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.

  9. Click Ok.

  10. In the Save session as dialog, enter [site].[env], where [site] is the sitename, 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.