Skip to content

Advanced node settings

The Agent Installer configures a Test Node completely; most nodes never need these settings. Change them only when Quadified support asks you to, or when your site needs a proxy.

The .env file

The agent reads optional settings from a file named .env in the QuadATFAgent folder, next to the TMSAgent program. Each line is NAME=value. Restart the agent after changing it (see Agent service).

Setting What it does
ATF_HTTP_PROXY The HTTP(S) proxy the agent uses, for sites where the node can reach the internet only through a proxy. For example ATF_HTTP_PROXY=http://proxy.example.com:3128.
ATF_IOS_MODE iPhone support: auto (default: on when the iPhone tools are present), on (required; the agent does not start without them) or off.
LOG_LEVEL How much the agent logs. Default info; set forcedebug when support asks for debug logs.
NO_FILE_LOG Set to any value to stop writing log files.
LOG_FMT_JSON Set to any value to write log files as JSON lines.
METRICS_PORT Port of the agent's local metrics endpoint (default 29100).
ATF_CLIENT_RESERVE_TIMEOUT_SEC How long, in seconds, a test step waits for a running device health check to finish before it fails (default 30).

Files not to touch

  • node-identity.json: the node's own credential. Do not delete, copy or edit it. A node without it cannot connect; to replace it, run a new Agent Installer command for the node.
  • Log files quadatflog-*.log in the QuadATFAgent folder: send them to support when asked.