dockurr/dnsmasq

dnsmasq

https://github.com/dockur/dnsmasq

https://github.com/dockur/dnsmasq/ https://hub.docker.com/r/dockurr/dnsmasq/tags https://hub.docker.com/r/dockurr/dnsmasq/tags https://github.com/dockur/dnsmasq/pkgs/container/dnsmasq https://hub.docker.com/r/dockurr/dnsmasq

Docker container of https://thekelleys.org.uk/dnsmasq/doc.html, an open-source DNS server.

Features ✨

• Provides a lightweight DNS/DHCP server
• Forwards DNS queries to upstream resolvers
• Supports local hostname and domain resolution
• Supports DHCP leases and static reservations
• Supports custom DNS records and hosts files
• Allows custom dnsmasq.conf configuration
• Lightweight Alpine-based image

Usage 🐳

Docker Compose:

yaml
services:
  dnsmasq:
    image: dockurr/dnsmasq
    container_name: dnsmasq
    environment:
      DNS1: "1.0.0.1"
      DNS2: "1.1.1.1"
    ports:
      - 53:53/udp
      - 53:53/tcp
    cap_add:
      - NET_RAW
      - NET_ADMIN
    restart: always

Docker CLI:

bash
docker run -it --rm --name dnsmasq -p 53:53/udp -p 53:53/tcp -e "DNS1=1.0.0.1" -e "DNS2=1.1.1.1" --cap-add=NET_ADMIN docker.io/dockurr/dnsmasq

Configuration ⚙️

You can set the DNS1 and DNS2 environment variables to change which upstream DNS servers to use.

For example, you can set them to the public https://www.cloudflare.com/learning/dns/what-is-1.1.1.1/ servers like this:

yaml
environment:
  DNS1: "1.0.0.1"
  DNS2: "1.1.1.1"

You can extend the default configuration with a volume that mounts a directory containing *.conf configuration files:

yaml
volumes:
  - ./dnsmasq.d/:/etc/dnsmasq.d/

You can also override https://github.com/dockur/dnsmasq/blob/master/dnsmasq.conf completely with a volume that binds your custom configuration file:

yaml
volumes:
  - ./dnsmasq.conf:/etc/dnsmasq.conf

FAQ 💬

• Port 53 is already in use?

If some process on the host is already binding to port 53, you may see an error similar to the following:

Error response from daemon: driver failed programming external connectivity on
endpoint dnsmasq (...): Error starting userland proxy: listen tcp4 0.0.0.0:53: bind:
address already in use

You can inspect which process is binding to that port:

bash
$ netstat -lnpt | grep -E ':53 +'
tcp    0    0 127.0.0.53:53    0.0.0.0:*    LISTEN    197/systemd-resolve

On hosts running systemd, such as in this example, you can workaround this by specifying the IP addresses on which to bind port 53, for example:

yaml
ports:
  - "192.168.1.###:53:53/udp"
  - "192.168.1.###:53:53/tcp"

There are many other host-specific cases where some process and configuration binds port 53. It may be an unused DNS daemon, such as bind that needs to be uninstalled or disabled, or a number of other causes. So finding out which process is binding the port is a good place to start debugging.

Stars 🌟

https://raw.githubusercontent.com/star-stats/stars/refs/heads/data/charts/dockur-dnsmasq.svg](https://github.com/dockur/dnsmasq/stargazers)