Proxy Configuration

Learn about working with proxy configuration for file servers

Overview

If the Couchdrop Windows / macOS Agent is running in a network where internet access is only available through a proxy server, additional configuration is required.

You can add the proxy details directly to the Couchdrop Agent configuration file.

For the full agent installation and configuration process, see Windows / Mac File Server.

How to configure a proxy

1

Install and configure the agent

Install and run the Couchdrop Agent, then set the connection token as normal.

2

Stop the agent

Stop the Couchdrop Agent before editing its configuration file.

3

Locate the configuration file

Locate the Couchdrop Agent configuration file.

On Windows, it is normally stored in:

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

Open the configuration file using Notepad or another text editor. The file contains the agent configuration in JSON format.

4

Add the proxy configuration

Locate the "proxies" section and add the HTTP and HTTPS proxy addresses.

{
  "...": "...",
  "proxies": {
    "http": "",
    "https": ""
  },
  "...": "..."
}

Enter the proxy URL required by your network for the "http" and "https" values.

5

Save and restart the agent

Save the configuration file, then start the Couchdrop Agent again.

The agent will use the configured proxy when communicating with Couchdrop.

Proxy settings, along with shortcut links to the agent logs and configuration files, are also available from the Settings gear within the Couchdrop Agent.

Proxy URL syntax

Use the appropriate syntax for your proxy configuration.

Type	Format	Example
No username or password	http://<ip>:<port>	http://127.0.0.1:8080
Username and password	http://username:password@<ip>:<port>	http://proxyuser:password@127.0.0.1:8080
SOCKS proxy	socks://<ip>:<port>	socks://127.0.0.1:8080

Debugging

If the agent cannot connect after configuring the proxy, check the log files stored in the same directory as the configuration files.

You can also use the shortcuts available from the agent Settings menu to open the logs and configuration files.

For additional help, contact [e-mail].