Skip to main content

Allowing the Agent to Follow Links

You can configure the Agent to follow links, allowing it to access folders that are outside of its configured root folder.

Links should only be used when you need the Agent to access locations that are outside of the root folder. If you want the Agent to access a network location directly, you can specify the path to the network location for the root setting in the configuration file.

To enable this option, update the configuration file to include "follow_links": true and then restart the Agent.

Within the Agent root folder, or subfolder, you can create symlinks that point to folders outside of the root folder, including any network attached or mounted folders. Symlinks can point to any valid and accessible NFS, CIFS, or UNC path.

Windows

To create a symlink on a Windows based system, run the following commands from a Command/DOS (CMD) terminal window:

cd C:\PATH\TO\AGENT\ROOT_FOLDER
mklink /D LINK_NAME \\SERVERNAME\C$\PATH\TO\TARGET_FOLDER

When linking to network locations, Microsoft recommends the use of UNC pathsExternal LinkThis link leads to an external website and will open in a new tab rather than using mounted drive letters.

Ensure that the Windows user account, or service account, that is running the Agent has the correct access permissions for the target of the link.

Linux/Mac

To create a symlink on a Linux or Mac based system, run the following commands from a terminal window:

cd /path/to/agent/root_folder
ln -s /path/to/target_folder link_name

Ensure that the user account, or service account, that is running the Agent has the correct access permissions to the target of the link.

Get Instant Access to Files.com

The button below will take you to our Free Trial signup page. Click on the white "Start My Free Trial" button, then fill out the short form on the next page. Your account will be activated instantly. You can dive in and start yourself or let us help. The choice is yours.