Skip to main content

Running the Agent Manually

The Files.com Agent can be run manually from the command line to test connectivity and functionality. Do not run the Agent manually for production purposes as the Agent will shut down whenever the command line terminal is closed. Always run the Agent as a system service to ensure high availability.

If you are using a Windows based system then you need to use the Agent app EXE to run the Agent manually. The Agent MSI is only used when installing the Agent as a system service and cannot be used to run the Agent manually.

Once the Agent binary is installed, and the configuration file is saved onto your system, use the following command to start the Agent:

Windows:

files-agent start --config files_agent_config.toml --allow-run-outside-of-service-for-testing-only

Mac/Linux:

files-agent start --config files_agent_config.toml

If the Agent app is not installed on your PATH then you can run it by providing absolute paths to the Agent and its configuration file. For example:

Windows:

C:\Users\me\files-agent start --config C:\Users\me\files_agent_config.toml --allow-run-outside-of-service-for-testing-only

Mac/Linux:

/path/to/files-agent start --config /path/to/files_agent_config.toml

Starting the Agent manually will display the message Successfully connected to Files Agent Proxy. If you do not see this message, refer to the troubleshooting guide to resolve the issue.

Successfully running the Agent manually confirms connectivity and functionality prior to installing it as a system service.

Ready to Transform Your File Infrastructure?

Join over 4,000 organizations that trust Files.com to manage their mission-critical file flows. Start your free trial today and see why we're the #1 rated file orchestration platform.

No credit card required • 7-day free trial • Setup in minutes