# Windows / Mac File Server

### 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 [as a service](/connections/connect-storage/windows-mac-file-server/running-the-couchdrop-agent-as-a-service.md).

{% hint style="info" %}
We do not recommend installing the agent directly on the target file server. If possible, use a VM and connect via mapped network drives.
{% endhint %}

### Requirements

To connect a Windows / OSX file server to Couchdrop you will need:

* Remote access via RDP to the file server or a suitable VM
* To have an administrator account
* A reliable internet connection
* A minimum of 16GB and 2 cores on the host or virtual machine
* To be running Windows 10 or above (for Windows Servers)

For a full list of requirements, see [Server Requirements](/connections/connect-storage/windows-mac-file-server/server-requirements.md).

### Configuration Steps

1. Log in to Couchdrop and add a new integration, either from +New > Connect Integration or the Integrations sidebar
2. Click  to add a new integration or Storage connector (Cloud Folder)
3. Select **Windows/OSX Server** from the list of available connections
4. Name the connection and create a cloud folder for Couchdrop
5. Copy the **Agent Token** and download the agent. **This token is only viewable once so be sure to copy it before leaving the screen.**
6. Log in to the remote target file server as an administrator
7. Install the agent and launch it
8. Paste the **Agent Token** from Couchdrop and click **Connect.** After a few seconds, the status indicator should change to show that the server is connected to Couchdrop.
9. Return to the Couchdrop interface, click **Test and Save**. 


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.couchdrop.io/connections/connect-storage/windows-mac-file-server.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.