> For the complete documentation index, see [llms.txt](https://docs.couchdrop.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.couchdrop.io/get-started/connect-your-existing-storage.md).

# Connect your existing storage

Connect Couchdrop to the storage platform where your files already live.

## Introduction

Couchdrop connects to the storage platform where your files already live, such as SharePoint, Amazon S3, Azure, Google Drive, or Dropbox.

Connected storage appears inside Couchdrop as part of its virtual file system, so you can work with different storage platforms through one consistent folder structure.

Files are not copied into or stored by Couchdrop when you connect a storage platform. When a file is uploaded to a connected folder, Couchdrop transfers it directly to the underlying storage location.

{% hint style="info" %}

#### How connected storage works

A connected storage location appears as a folder in Couchdrop, but the folder is a view of your underlying storage.

For example, if `/SharePoint` is connected to a SharePoint document library, files uploaded to `/SharePoint` are written directly to that SharePoint location. They are not moved into Couchdrop-hosted storage first.

You can organize multiple storage connections within the same Couchdrop virtual file system and use them with SFTP users, file transfers, and automations.
{% endhint %}

## Connect your cloud storage to Couchdrop

{% hint style="warning" %}

### Before you start

To connect your existing storage, you will need:

* Administrator access to your Couchdrop account
* Access to the storage platform you want to connect
* The credentials, account permissions, or API details required by that platform
  {% endhint %}

{% stepper %}
{% step %}

### Create a storage connection

In Couchdrop, select:

**+ Create → Add Storage Connection**

You can also create a connection from the **Connections** page.
{% endstep %}

{% step %}

### Choose where it appears

Enter a folder name and choose where the connection should appear in Couchdrop.

For example:

`/SharePoint`

{% hint style="info" %}
Connected storage appears in Couchdrop as a virtual folder.

The files remain in the underlying storage platform while Couchdrop provides access to them through its file system.
{% endhint %}
{% endstep %}

{% step %}

### Select your storage platform

Choose the storage platform you want to connect.

You will need the credentials, API key, account access, or permissions required by that platform.

Follow the setup steps shown for the selected connection, then test and save it.
{% endstep %}

{% step %}

### Check the connection

Open **File Browser**.

Your connected storage should appear as a folder in the location you selected.

Open it and confirm that Couchdrop can browse the files and folders inside it.
{% endstep %}
{% endstepper %}

## Next steps

Your storage is now connected to Couchdrop.

In the previous guide, you created an SFTP user that pointed to Couchdrop-hosted storage.

Now update that user so files uploaded over SFTP go directly to your connected storage.

1. Open **SFTP & FTP Users** and select the user you created earlier.
2. Open the user's settings.
3. Change the **Home Directory** to a folder inside your connected storage.
4. Save the changes.
5. Connect over SFTP using the same user credentials and upload a test file.

Open **File Browser** and confirm the file appears in the connected storage folder.

Because the user's root directory now points to connected storage, files uploaded by that user are written to that storage location rather than Couchdrop-hosted storage.

Next, **build your first automation** to automatically organize files after they arrive.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.couchdrop.io/get-started/connect-your-existing-storage.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.