Configuration via Local Config Files

Last published : Nov 06, 2026
Platforms: all
Configuration via local config files is an alternative to configuring uberAgent via central config file management or Group Policy.
Related information
Installation
Config File Syntax

Config File Location

Windows

Config File Templates

The installer copies configuration file templates to C:\Program Files\vast limits\uberAgent\Config Templates\. Changes to the template files have no effect - they are only meant to be used as a reference.
As the agent searches for valid configurations only in the %PROGRAMDATA%\vast limits\uberAgent\Configuration\ directory, perform the following steps:
  1. Copy the whole content of the C:\Program Files\vast limits\uberAgent\Config Templates\ to %PROGRAMDATA%\vast limits\uberAgent\Configuration\
  2. Modify the %PROGRAMDATA%\vast limits\uberAgent\Configuration\uberAgent.conf file.

Configuration Optimized for Data Volume

To switch to the configuration optimized for data volume back up uberAgent.conf and rename uberAgent-data-volume-optimized.conf to uberAgent.conf.

Persisting Configuration Files in %ProgramData%

The agent installer completely removes the installation directory, including any configuration files, during uninstalls and upgrades.
To persist configuration files across agent upgrades, place them in %ProgramData%\vast limits\uberAgent\Configuration. As explained here, configuration files in %ProgramData% take precedence over configuration files in the installation directory.
Please note that you need to update configuration files in %ProgramData% when rolling out new versions of the agent.

macOS

The default configuration file uberAgent.conf is located in /Library/Application Support/uberAgent/. During upgrades, files in this directory are not overwritten to preserve customizations. It is recommended to update the default configuration from the config file templates (see below) after an upgrade.

Config File Templates

The installer copies config file templates to /Library/Application Support/uberAgent/Config Templates/. Changes to the template files have no effect - they are only meant to be used as a reference.

Applying Configuration Changes

The agent reads the configuration upon startup of the uberAgent service/daemon. To apply configuration changes, restart the uberAgent service/daemon.