Skip to main content

Agent Configuration File

The Files.com Agent configuration file is generated by Files.com when the Remote Server for the Agent is created.

You can download the configuration file for an existing Agent Remote Server from within its Remote Server settings.

The configuration file is TOMLExternal LinkThis link leads to an external website and will open in a new tab formatted and should be reviewed by the system administrator prior to use. The configuration file is designed (and intended) to be edited manually for customization by the system administrator.

Prior to use, system administrator should also review the following fields of the TOML file:

FieldDescription
rootThis specifies the top-level directory that the Agent has access to. Set this value to a directory location on the system that you wish the Agent to access. Make sure that the path is enclosed in single quotes. For example, '/path/to/agent/folder', 'C:\windows\folder', '/mnt/otherserverfolder', or 'M:\mounted\networkfolder'.
permission_setThis shows the permissions that your Files.com administrator specified for the Agent. If the system administrator disagrees, they can change this value. Valid options are read_write, read_only, and write_only.
follow_linksThis option specifies whether the Agent is allowed to follow links, allowing access to linked folders that exist outside of the root option. Valid options are true or false. The default is false when this option is omitted from the configuration file.
max_concurrent_jobs

This option adjusts the number of jobs that can be processed simultaneously. By default, it scales based on the number of CPUs multiplied by 4. If the agent is encountering job queue is full errors, you may consider increasing this value, depending on the constraints of your system.

Do not edit or change any other fields in the configuration file.

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.