The Windows agent has a collection of logfiles that can be useful for debugging issues. Our support team might also ask for them from time to time.

You can find the default location for the logs here:

C:\Users\%username%\AppData\Local\CouchdropCloudConnector

You can also jump directly to the local logs and configuration file within the settings (gear) within the Couchdrop agent.

Introduction

Connecting to Dropbox is fast to set up and fully supported in Couchdrop. Couchdrop can connect to both Dropbox Personal and Dropbox Business accounts.

Requirements

To connect to Dropbox in Couchdrop you will need:

• A licensed Dropbox account

• Access to an Admin account to connect to Couchdrop (if connecting to Dropbox Business)

Configuration Steps

1. Log in to Couchdrop and add a new storage connection

2. Provide a name for the connection. This is how the Dropbox connection will appear in Couchdrop

3. Select Dropbox Personal or Dropbox Team from the list of available connections

Introduction

Couchdrop supports Microsoft Windows and Apple OSX using a lightweight agent that is installed directly on the file server, another server, or on a virtual machine.

The agent uses a shared token for authentication and communicates with Couchdrop's infrastructure via secure HTTPS calls. The agent can be run in a standalone fashion or .

Introduction

Couchdrop can be connected to a Google Workspace by creating a service account, which Couchdrop can do for you automatically. Couchdrop works with both Personal Google Drive accounts and Google Workspace accounts.

The Couchdrop Agent (Couchdrop Cloud Connector) can be run as a Windows service.

Installing the agent as a service requires some understanding of how Windows services work and the service must be configured to run as the same user that is performing the configuration.

Before starting, make sure that you have installed the Couchdrop Cloud Connector by Make sure you have run and configured everything properly and check that it is working. We recommend closing the desktop configuration app and systray application before starting the service.

Next in a command line, open the Couchdrop Cloud Connector folder located under Program Files and run the following command.

Next, open the service manager:

Find the service for "Couchdrop Cloud Connector" and open it.

Introduction

Couchdrop can be connected to a OneDrive folder in a few simple steps. Couchdrop works with Personal OneDrive accounts and SharePoint Sites.

Install the agent on your Workstation

First, you need to install and configure the Couchdrop agent (Couchdrop Cloud Connector) on your workstation.

You can for configuration instructions. Once you have installed and configured the agent, you need to copy the configuration.

The key difference between Couchdrop and other SFTP servers, is that Couchdrop works with your Cloud Storage instead of local hard disks. This means you can turn any storage platform, shared drive or server into a SFTP and MFT server in a matter of seconds.

Couchdrop is also not limited to one particular storage integration, rather you can mount hundreds of stores in Couchdrop and they appear as independent folders.

See for more info on folders in Couchdrop

Introduction

Connecting Couchdrop to an Amazon S3 bucket is done using an IAM keyset. It can be completed in a few minutes if you have the right access in AWS.

Introduction

Connecting to Egnyte is fast to set up and fully supported in Couchdrop.

Requirements

Introduction

Connecting to Azure Files online is fast to set up and fully supported in Couchdrop.

Requirements

Introduction

Connecting to SharePoint online is fast to set up and fully supported in Couchdrop. Couchdrop uses the Microsoft Graph API, which is the recommended method for connecting to SharePoint and OneDrive.

There are two different authentication methods available with SharePoint Online, Delegate Access or Application Access. The Couchdrop team recommends you use the default Delegate Access method, as it's simpler to configure.

Introduction

Connecting to Box is fast to set up and fully supported in Couchdrop.

Requirements

Delegating Domain-Wide Authority

Learn how to connect Google Workspace to Couchdrop with a Client ID and domain-wide delegation

Introduction

To connect a Google Workspace account to Couchdrop you need to delegate domain-wide authority so Couchdrop can access your users and migrate them automatically.

Requirements

Delegating Domain-Wide Authority requires the following:

• A Google Workspace Administrator Account to access the Admin Console

• Familiarity with the Google Admin Console

• Client ID for Google generated in Couchdrop when configuring a Google Workspace connection

Configuration Steps

1. for your Google Workspace domain.

2. Select the Security tab. If you don't see Security, select Show More from the bottom of the menu list.

3. Choose Access and data control and then API controls.

1. Click Authorize. Test that the connection in Couchdrop is successful to complete your configuration.

For more information on domain-wide delegation, see this Support article from Google:

Overview

Azure Blob is supported natively with Couchdrop. Couchdrop allows users of Azure Blob to upload and download files and Azure Blob customers can easily configure and manage secure access to Azure Blob files and folders for access and use via SFTP, FTP, Automations and Web Access with granular user management and controls through a user-friendly web interface.

Requirements

Configuring access to Azure Blob is a simple process in Couchdrop. Lets get you up and running - you will need.

1. An active Couchdrop account

2. An active Azure Storage Account.

3. Access to create a Container (or use an existing one).

Configuration Steps

Step 1: Create an Azure Blob Container - or Use an existing container

1. In the Azure Portal - Navigate to Storage accounts → select your storage account.

2. In the left menu, click Containers.

3. Click + Container, give it a name, and set access level to Private (recommended).

Step 2. Generate Credentials for Azure

Option A: Access Key (simple but broad permissions)

1. In the storage account, go to Access keys.

2. Copy the Storage account name and Key1.

Option B: SAS Token (more secure / scoped)

1. In the storage account, go to Shared access signature.

2. Select:

   • Allowed services: Blob

3. Connect Couchdrop to Azure

1. Log in to your Couchdrop dashboard.

2. Click + Create -> Connect to Storage -> choose Azure Blob.

3. Enter the required details:

You will now see your Azure blob container as a folder in Couchdrop.

Frequently Asked Questions

Supported Features

Couchdrop has comprehensive support for interacting with Files in Azure Blob

Introduction

Couchdrop can be connected to a Google Drive folder in a few simple steps. Couchdrop works with Personal Google Drive accounts and Google Workspaces.

Requirements

To connect to Google Drive online in Couchdrop you will need:

• A licensed Google Drive Account

• A folder in Google Drive

Configuration Steps

1. Log in to Couchdrop and add a new storage connection

2. Select Google Drive Personal from the list of available connections

3. Click Connect to Google.

The Windows / OSX Agent allows for connections to on-prem file servers running Microsoft Windows or macOS. This software is run as an executable and can also be run as a service.

Server Requirements

While connection requirements can vary depending on the types of transfers involved, we recommend the resources below.

In networks where internet access is only allowed behind a proxy server some additional manual configuration is needed.

Configuration steps

This guide walks you through securely connecting SharePoint to Couchdrop using an application registered in Microsoft Entra, with access restricted to a specific site using the Sites.Selected permission.

Prerequisites

• Access to

• Admin rights to register apps and grant tenant-wide permissions

• Access to

Steps

The process has three main steps that will be explained in detail.

1. Configuring an Application in Entra

2. Granting Site permissions to the Application in Microsoft Graph Explorer

3. Connecting to SharePoint in Couchdrop using the configured Application

Configuring an Application in Entra

1. Register a New Application

1. Go to

2. Navigate to App registrations → + New registration

3. Enter a name (e.g., Couchdrop-SharePoint)

2. Copy your new Client ID and Tenant ID

After registration, you will be taken to a settings page for your new app. Copy the following from the Overview tab:

• Application (client) ID

• Directory (tenant) ID

3. Create a Client Secret

1. Go to Certificates & secrets

2. Click + New client secret

3. Provide a description (e.g., CouchdropSecret), select expiry, and click Add

4. Assign API Permissions

Microsoft Graph API

1. Navigate to API permissions → + Add a permission

2. Select Microsoft Graph → Application permissions

3. Find and check Sites.Selected

Granting site permissions to App via Microsoft Graph Explorer

1. Retrieve the Site ID

To find the SharePoint site's ID, open the following URL in your browser and replace elements in brackets with your tenant and Site information.

Example:

This will return an XML object containing the Site ID:

2. Sign in to Graph Explorer

1. Visit

2. Sign in with your Microsoft account

3. Click the user icon (top-right) → Consent to permissions

3. Send Permission Grant Request (for a specific site)

ENDPOINT

BODY

Replace:

• {site_id} with the GUID you retrieved earlier

• <APPLICATION_CLIENT_ID> with your app’s Client ID

• <APPLICATION_DISPLAY_NAME> with your app name (e.g., Couchdrop-SharePoint

Click Run Query. A successful response will return 201 Created.

4. Send Permission Grant Request (root site)

ENDPOINT

BODY

Replace:

• <APPLICATION_CLIENT_ID> with your app’s Client ID

• <APPLICATION_DISPLAY_NAME> with your app name (e.g., Couchdrop-SharePoint)

Click Run Query. A successful response will return 201 Created.

Connecting to SharePoint in Couchdrop using the configured Application

1. Return to Couchdrop and choose to create a new SharePoint connector.

2. Uncheck the option to use Delegated OAUTH Access to connect via Application Access.

3. Complete the configuration using:

• SharePoint Domain

• Client ID

• Directory (Tenant) ID

4. You must then “Choose a folder” and manually specify the SharePoint subfolder path. This ensures Couchdrop connects to the exact SharePoint site you granted access to via Sites.Selected.

Folder Path Syntax

5. Click Test to verify that you have successfully assigned access. Select Add Integration to complete the process.