Configure NetoDNS

You can run NetoDNS with the default configuration, which should be sufficient for most deployments.

Modifying the configuration

NetoDNS uses environment variables to set configuration. All configuration uses the prefix NETO_

Follow the steps in the install instructions for your chosen deployment method to edit and pass the configuration settings:

Install NetoDNS (container) or Install NetoDNS (Linux package)

Configuration settings

Environment Variable	Description	Default Value	Example
NETO_PROTOCOL	Protocol to listen on (e.g., tcp, udp).	tcp	NETO_PROTOCOL=udp
NETO_PORT	Port to listen on.	514	NETO_PORT=10514
NETO_OUTPUT_FILE	Path to the output file where logs are written.	None	NETO_OUTPUT_FILE=/var/log/netodns.log
NETO_DATASRC	Data source identifier for processing logs.	None	NETO_DATASRC=EXAMPLE-SOURCE
NETO_EXCLUDE_QUERIES	Comma-separated list of query names to exclude.	None	NETO_EXCLUDE_QUERIES=example.com,foo.com
NETO_EXCLUDE_QUERIES_RE	Comma-separated list of regular expressions for excluding query names.	None	NETO_EXCLUDE_QUERIES_RE=.*\\.example\\.com$,.*\\.test\\.com$
NETO_INTERVAL	Interval for periodic tasks (in seconds).	30	NETO_INTERVAL=60
NETO_ENDPOINT__APPNAME	Application name for the endpoint.	None	NETO_ENDPOINT__APPNAME=my-app
NETO_ENDPOINT__CUSTOMER	Customer identifier for the endpoint.	None	NETO_ENDPOINT__CUSTOMER=my-customer
NETO_NETOSECRET	API key used for authenticating to Fusion	None	NETO_NETOSECRET=my-secret-key
NETO_PROXY__ENABLED	Whether to enable proxy support (true/false).	false	NETO_PROXY__ENABLED=true
NETO_PROXY__URL	URL of the proxy server.	None	NETO_PROXY__URL=http://proxy.example.com
NETO_ENDPOINT__RETRYMIN	Minimum retry interval for token requests (in seconds).	300	NETO_ENDPOINT__RETRYMIN=5
NETO_ENDPOINT__RETRYMAX	Maximum retry interval for token requests (in seconds).	600000	NETO_ENDPOINT__RETRYMAX=300000