> 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/storage/integrations/azure-files.md).

# Azure Files

Learn how to configure a connection to Azure Files with Couchdrop

## Overview

Connect Azure Files to Couchdrop to use an existing Azure file share with your file transfer workflows.

Once connected, your Azure Files storage is available through Couchdrop for transferring files to and from the underlying file share.

## How to connect Azure Files

{% hint style="warning" %}

#### Before you start

To connect Azure Files, you will need:

* An Azure **Account Name**
* An Azure **Secret Key**
* An Azure **Share Name**

You can find more information about managing Azure Storage accounts in the [Microsoft Azure documentation](https://docs.microsoft.com/en-us/azure/storage/common/storage-account-manage).
{% endhint %}

{% stepper %}
{% step %}

### Add a new Azure Files connection

In Couchdrop, add a new storage connection and select **Azure Files** from the available storage providers.
{% endstep %}

{% step %}

### Configure Azure Files

Enter a **Name for this integration** and select the **Couchdrop folder path** where the connection will appear.

Enter your Azure Files details:

* **Azure Account Name** — Enter the name of your Azure Storage account.
* **Azure Account Key** — Enter the account key for your Azure Storage account.
* **Azure Share Name** — Enter the name of the Azure file share you want to connect to.
* **Endpoint Suffix** — Optionally enter a custom Azure endpoint suffix.

When the connection details are complete, select **Save and Test**.
{% endstep %}

{% step %}

### Select a folder

After the connection has been tested, you can optionally select a specific Azure Files location to map into Couchdrop.

Leaving this blank allows Couchdrop to map the storage connection directly without restricting it to a specific folder.

You can select a location using the folder browser or manually enter a path.
{% endstep %}

{% step %}

### Save and use your Azure Files connection

Optionally, configure **Transfer Shield** and select a content rule group to surface or block unexpected, non-compliant, or malicious files uploaded through this connection.

When the configuration is complete, save the integration.
{% endstep %}
{% endstepper %}


---

# 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/storage/integrations/azure-files.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.