• CoreDNS implements the Kubernetes DNS service.
  • It's deployed in the cluster through the Deployment coredns in the kube-system namespace.
  • The Deployment is automatically horizontally scaled based on the number of nodes in the cluster`.
  • The virtual IP of the CoreDNS Service is always the 10th IP in the Service network (default

For additional configuration, see extending CoreDNS configuration below.

You can find more information about the kinds of records CoreDNS serves and how you can use CoreDNS in the official Kubernetes documentation.

Node local DNS cache

A large amount of DNS queries can overload CoreDNS or lead to higher latency.
That's why MetaKube Core installs a local DNS cache resolver on each node.

  • It's deployed through the node-local-dns DaemonSet in the kube-system namespace and also runs CoreDNS, but with different configuration.
  • The server listens on the fixed address with UDP & TCP on a dummy interface nodelocaldns.
  • Containers are configured to use the node local DNS cache by an entry in their /etc/resolve.conf file.
  • Queries for names in the cluster.local domain are forwarded to CoreDNS and results cached.
  • Queries for other names are forwarded based on the host's /etc/resolv.conf configuration, see external names.

For additional configuration, see extending CoreDNS configuration below.

External names

Queries for names not in the cluster.local domain are not answered by CoreDNS.
They use the following resolvers/servers:

  • Local DNS resolver (systemd-resolved) listening on
  • DNS servers of the OpenStack subnet configured through DHCP

Queries coming from the host directly (not from Pods) don't go to CoreDNS.
E.g. dig kubernetes.svc.cluster.local resolves from a Pod, but not the host.

Extending the CoreDNS configuration

You can extend the configuration of both, node local DNS cache or CoreDNS.
To do so, create a Config Map coredns-extra-configs or node-local-dns-extra-configs respectively in the kube-system namespace.

It must contain a valid CoreDNS style configuration file under the Corefile key.

Example manifest

apiVersion: v1
kind: ConfigMap
  name: coredns-extra-configs
  namespace: kube-system
  Corefile: |
    example.com {
      forward .

With this configuration, CoreDNS will forward queries for names under the example.com domain to


  • Changes to the Config Maps won't immediately take effect.
    To load the new configuration, you must recreate the Pods:

    kubectl --namespace kube-system rollout restart deployment coredns
    kubectl --namespace kube-system rollout restart daemonset node-local-dns
  • When you add another listener to the node local DNS cache, you must use the bind directive to only listen on the nodelocaldns interface or its IP.
    If not, CoreDNS will listen on the wildcard host (all addresses) which includes the local cache resolver of systemd-resolved.
    Since that's already listening on port 53 on, CoreDNS will fail, complaining that the port is already in use.