Skip to main content
apiVersion: v1alpha1
kind: ResolverConfig
# A list of nameservers (DNS servers) to use for resolving domain names.
nameservers:
    - address: 1.1.1.1 # The IP address of the nameserver.
    - address: ff08::1 # The IP address of the nameserver.
# Configuration for search domains (in /etc/resolv.conf).
searchDomains:
    # A list of search domains to be used for DNS resolution.
    domains:
        - example.com

apiVersion: v1alpha1
kind: ResolverConfig
# Configuration for search domains (in /etc/resolv.conf).
searchDomains:
    disableDefault: true # Disable default search domain configuration from hostname FQDN.
FieldTypeDescriptionValue(s)
nameserversNameserverConfigA list of nameservers (DNS servers) to use for resolving domain names.

Nameservers are used to resolve domain names on the host, and they are also
propagated to Kubernetes DNS (CoreDNS) for use by pods running on the cluster.

This overrides any nameservers obtained via DHCP or platform configuration.
Default configuration is to use 1.1.1.1 and 8.8.8.8 as nameservers.
searchDomainsSearchDomainsConfigConfiguration for search domains (in /etc/resolv.conf).

The default is to derive search domains from the hostname FQDN.

​
nameservers[]

NameserverConfig represents a single nameserver configuration.
FieldTypeDescriptionValue(s)
addressAddrThe IP address of the nameserver.

​
searchDomains

SearchDomainsConfig represents search domains configuration.
FieldTypeDescriptionValue(s)
domains[]stringA list of search domains to be used for DNS resolution.

Search domains are appended to unqualified domain names during DNS resolution.
For example, if “example.com” is a search domain and a user tries to resolve
”host”, the system will attempt to resolve “host.example.com”.

This overrides any search domains obtained via DHCP or platform configuration.
The default configuration derives the search domain from the hostname FQDN.
disableDefaultboolDisable default search domain configuration from hostname FQDN.

When set to true, the system will not derive search domains from the hostname FQDN.
This allows for a custom configuration of search domains without any defaults.