In this article

Use these optional Relay configuration parameters to have more control over DNS Relay performance. 

Set custom DNS servers during installation

As of Relay version 1.3.0 admins can use customer DNS servers when registering or validating with remote API. This allows deployments behind restrictive or custom DNS setups to direct registration traffic through specific DNS servers, improving reliability and flexibility.

[client.registration_override_dns]
enabled = true
address = "103.247.36.36:53"
protocol = "udp"
timeout = "5s"

Optional high latency configuration parameters

DNSFilter identified niche cases where the Relay experiences high latency when failing over between two relays. Use these optional configuration parameters to improve the issue. 

Relay 0.2.0 and greater has two optional configuration parameters related to resolvers validation:

# Ping DNS servers settings, defaults to 60 seconds and ping is disabled
#ping_upstream_servers = true
#ping_upstream_servers_interval = "60s"

These optional parameters can be added to the relay.conf file before the log section (shown below)

...
# Desired upstream use order, defaults to "udp", "tcp", "tcp-tls", set only one to disable the others
upstream_order = [ "udp", "tcp", "tcp-tls" ]
  
# Ping DNS servers settings, defaults to 60 seconds and ping is disabled
#ping_upstream_servers = true
#ping_upstream_servers_interval = "60s"
  
[log]
# Console error log, defaults to "error"
# Set to "debug" for troubleshooting
level = "debug"
verbose = true
...

Parameter description

Parameter examples

The following example enables resolvers validation with 60 seconds interval:

ping_upstream_servers = true
#ping_upstream_servers_interval = "60s"

The following example enables resolvers validation with 30 seconds interval:

ping_upstream_servers = true
ping_upstream_servers_interval = "30s"

The following examples disables resolvers validation:

ping_upstream_servers = false
ping_upstream_servers_interval = "60s"

#ping_upstream_servers = true
ping_upstream_servers_interval = "60s"