> ## Documentation Index
> Fetch the complete documentation index at: https://docs.siderolabs.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ResolverConfig is a config document to configure DNS resolving.

# ResolverConfig

```yaml theme={null}
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
```

```yaml theme={null}
apiVersion: v1alpha1
kind: ResolverConfig
# Configuration for search domains (in /etc/resolv.conf).
searchDomains:
    disableDefault: true # Disable default search domain configuration from hostname FQDN.
```

<table>
  <thead>
    <tr>
      <th>Field</th>
      <th>Type</th>
      <th>Description</th>
      <th>Value(s)</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>`nameservers`</td>
      <td><a href="#nameservers%5B%5D">NameserverConfig</a></td>
      <td>A list of nameservers (DNS servers) to use for resolving domain names.<br /><br />Nameservers are used to resolve domain names on the host, and they are also<br />propagated to Kubernetes DNS (CoreDNS) for use by pods running on the cluster.<br /><br />This overrides any nameservers obtained via DHCP or platform configuration.<br />Default configuration is to use 1.1.1.1 and 8.8.8.8 as nameservers.</td>

      <td />
    </tr>

    <tr>
      <td>`searchDomains`</td>
      <td><a href="#searchdomains">SearchDomainsConfig</a></td>
      <td>Configuration for search domains (in /etc/resolv.conf).<br /><br />The default is to derive search domains from the hostname FQDN.</td>

      <td />
    </tr>
  </tbody>
</table>

## nameservers\[]

NameserverConfig represents a single nameserver configuration.

<table>
  <thead>
    <tr>
      <th>Field</th>
      <th>Type</th>
      <th>Description</th>
      <th>Value(s)</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>`address`</td>
      <td>Addr</td>
      <td>The IP address of the nameserver.</td>

      <td />
    </tr>
  </tbody>
</table>

## searchDomains

SearchDomainsConfig represents search domains configuration.

<table>
  <thead>
    <tr>
      <th>Field</th>
      <th>Type</th>
      <th>Description</th>
      <th>Value(s)</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>`domains`</td>
      <td>\[]string</td>
      <td>A list of search domains to be used for DNS resolution.<br /><br />Search domains are appended to unqualified domain names during DNS resolution.<br />For example, if "example.com" is a search domain and a user tries to resolve<br />"host", the system will attempt to resolve "host.example.com".<br /><br />This overrides any search domains obtained via DHCP or platform configuration.<br />The default configuration derives the search domain from the hostname FQDN.</td>

      <td />
    </tr>

    <tr>
      <td>`disableDefault`</td>
      <td>bool</td>
      <td>Disable default search domain configuration from hostname FQDN.<br /><br />When set to true, the system will not derive search domains from the hostname FQDN.<br />This allows for a custom configuration of search domains without any defaults.</td>

      <td />
    </tr>
  </tbody>
</table>