openwrt-feed-coredns

This is an openwrt feed that contains definitions to include CoreDNS software into your OpenWRT build.

install from a binary

by using terminal

1. download an ipk file from the releases page https://code.tokarch.uk/mainnika/openwrt-feed-coredns/releases
2. put the file to the device, e.g. path /tmp/coredns.ipk use scp -- scp coredns_1.8.6-1_arm_cortex-a7_neon-vfpv4.ipk root@[openwrt-ip]:/tmp/coredns.ipk
3. use opkg to install the downloaded file, e.g. opkg install /tmp/coredns.ipk

by using luci

1. download an ipk file from the releases page https://code.tokarch.uk/mainnika/openwrt-feed-coredns/releases
2. open luci admin gui and go System → Software
3. use Upload Package buttom to upload local release file

how to add the feed into your build

1. open your feeds.conf.default and add the following line:

   src-git feed_coredns https://code.tokarch.uk/mainnika/openwrt-feed-coredns.git

2. run update script:

   ./scripts/feeds update feed_coredns

3. install coredns packages into your build:

   ./scripts/feeds install -a -p feed_coredns

see for details: https://openwrt.org/docs/guide-developer/feeds

service init

The package setups an init script /etc/init.d/coredns and uci config section:

config coredns 'main'
	option port '53'
	option config '/etc/coredns/Corefile'

There are two options defined:

• port, default: 53 -- a port where coredns will listen for connections
• config, default: /etc/coredns/Corefile -- a Corefile config file

Use uci tool to change these values, e.g.: `uci set coredns.main.port=1053'

coredns configuration

The package provides an empty config Corefile located at /etc/coredns/Corefile. The empty Corefile:

. { }

To configure the coredns instance properly set Corefile with your content.

use cases

openwrt hardware as the external dns resolver

I assume that in this setup openwrt act as a dhcp client (not a server). You can set lan network as a dhcp client by using these uci values (use uci commit to apply):

uci del network.lan.ipaddr
uci del network.lan.netmask
uci del network.lan.ip6assign
uci set network.lan.proto='dhcp'

the main goal is to replace dnsmasq with coredns because they share the same port 53.

1. go System → Startup, disable and stop dnsmasq
2. enable and start coredns
3. now coredns acts as a default resolver and listen all interfaces by default.