---
title: "Connecting to Cloud Platform with an SFTP client"
date: "2024-02-14T06:18:38+00:00"
summary: "Connect securely to Cloud Platform environments using SFTP clients. Learn how to set up, choose a client, and access your files, backups, and import folders with step-by-step instructions for seamless file management."
image:
type: "page"
url: "/acquia-cloud-platform/connecting-cloud-platform-sftp-client"
id: "9dd1b5ce-5f4d-489c-896d-bd0f4417be81"
---

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

Before you begin
----------------

To connect with and use SFTP with your Cloud Platform-based applications:

*   **Register your public SSH key with Cloud Platform**:   
    To connect to a Cloud Platform infrastructure, you must have an SSH private/public key pair and register the public key in Cloud Platform. For information about how to do this, see [Getting started with SSH](/acquia-cloud-platform/manage-apps/command-line/ssh/getting-started).
    
    Acquia Cloud Classic Only
    
    After you make changes to your codebase using live development, you must commit all the changes to your Cloud Platform repository, or else the changes will be lost when you exit live development.
    

Selecting an SFTP client
------------------------

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

*   [Cyberduck](https://cyberduck.io/) - MacOS
*   [Transmit](http://panic.com/transmit/) - MacOS
*   [WinSCP](http://winscp.net/eng/download.php) - Windows

Example
-------

Here is an example demonstrating how to connect to Cloud Platform with SFTP, based on WinSCP:

1.  Start the WinSCP application.
2.  On the **WinSCP Login** window, select **Session** and enter the following:
    
    ![cloud-platform_logging-in-to-winscp.png](https://acquia.widen.net/content/27a4f62b-ba0e-4414-9678-235a131d6bfb/web/cloud-platform_logging-in-to-winscp.png?w=720&itok=wrqm21Nw)
    
    1.  In **File protocol**, select **SFTP**.
    2.  In the Cloud Platform user interface, access the Overview page for an environment. For more information, visit [working with environments](/acquia-cloud-platform/working-environments "Working with environments"). This page has the information that you can use in the following steps.
    3.  In **Host name**, enter the full DNS infrastructure name of the Cloud Platform infrastructure that you want to connect to. For example, in `exampletest@examplestg.ssh.prod.acquia-sites.com`, the **Host name** is the value after "@", which is `examplestg.ssh.prod.acquia-sites.com`.
    4.  In **User name**, enter `[site].[env]`, where `[site]` is the [sitename](/definitions/sitename), and `[env]` is the environment you want to connect to (for example, `prod`, `test`, or `dev`).
    5.  In **Password**, do not enter any details.
3.  Select **Advanced**.
    
    ![cloud-platform_configuring-winscp.png](https://acquia.widen.net/content/208d6e8f-7d29-4a98-9466-0445013635ef/web/cloud-platform_configuring-winscp.png)
    
4.  On the **Advanced Site Settings** page, select **Directories**.
5.  In **Remote directory**, change to the live development folder for your application’s Development environment: `/mnt/files/[site].dev/files`
6.  In **Local directory**, change to the docroot directory in your local code repository.
7.  On the **Advanced Site Settings** page, select **Authentication**.
8.  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](/acquia-cloud-platform/manage-apps/command-line/ssh/getting-started/sftp-key).
9.  Select **Ok**.
10.  In the **Save session as** dialog, enter `[site].[env]`, where `[site]` is the [sitename](/definitions/sitename), and where `[env]` is the environment you want to connect to (one of `prod`, `test`, or `dev`).
11.  Select **Login** to connect to your Cloud Platform infrastructure.