Skip to content

Latest commit

 

History

History
92 lines (54 loc) · 2.68 KB

environment.md

File metadata and controls

92 lines (54 loc) · 2.68 KB
Raw

AdGuard DNS Client environment configuration

Warning

This is a temporary document. The final version will be posted to the AdGuard DNS Knowledge Base.

AdGuard DNS Client uses environment variables to store some of the configuration. All other configuration is stored in the configuration file.

Contents

Note

In its current state, the log system is only intended for debugging startup errors.

LOG_OUTPUT

The log destination, must be an absolute path to the file or one of the special values.

Note

If LOG_FORMAT is set to adguard_legacy, output is set to stderr.

  • syslog means that the platform-specific system log is used, which is syslog for Linux and Event Log for Windows.

    [!NOTE] Log entries written to the system log are in text format and use the system timestamp.

  • stdout for standard output stream.

  • stderr for standard error stream.

  • Absolute path to the log file.

    Example: /home/user/logs.

    Example: C:\Users\user\logs.txt.

This environment variable has priority over log.output field from the configuration file.

Default: Unset.

LOG_FORMAT

The format for log entries.

Note

If LOG_FORMAT is set to adguard_legacy, output is set to stderr.

  • adguard_legacy;
  • default;
  • json;
  • json_hybrid;
  • text.

This environment variable has priority over log.format field from the configuration file.

Default: Unset.

LOG_TIMESTAMP

When set to 1, log entries have a timestamp. When set to 0, log entries don’t have it.

This environment variable has priority over log.timestamp field from the configuration file.

Default: Unset.

VERBOSE

When set to 1, enable verbose logging. When set to 0, disable it.

This environment variable has priority over log.verbose field from the configuration file.

Default: Unset.