macOS Installation

On macOS, you install the Files.com Agent as a service so it starts automatically when the system powers on or reboots, and so it restarts itself if the agent program needs to recover from a problem. Running the Agent as a service is what makes the connection reliable across restarts and crashes.

Root Path

Before you install the Agent as a service, set the root setting in the configuration file to either a local drive path (/path/to/folder) or a path to an accessible mounted network drive (/mnt/path/to/folder).

Agent Download

Download the agent executable for your system from the official download location. Choose the version with "macos" in the name that matches your architecture and save it to the same location as your configuration file on the host system.

Service Installation

To install the Agent as a launchd service on macOS, run:

files-agent service install --config /path/to/files_agent_config.toml

This method keeps the executable and configuration file in their original locations.

Start the service with:

files-agent service start

If you update the configuration file, stop the service, make your changes, and restart it.

Stop the service with:

files-agent service stop

Remove the service with:

files-agent service uninstall