Docker dnsmasq

Deploy dnsmasq with a simple web UI using Docker.

How-to

Prepare your dnsmasq.conf

# Log all dns queries
log-queries

# Don't use hosts nameservers
no-resolv

# Use cloudflare as default nameservers
server=1.1.1.1
server=1.0.0.1
strict-order

# Serve all .company queries using a specific nameserver
server=/company/10.0.0.1

# Or explicitly define host-ip mappings
address=/myhost.company/10.0.0.2
address=/myhost2.company/10.0.0.3

Run

docker compose up -d

Usage

• Open http://localhost:8080 to see web UI.
• If the port 53 is busy with other services like systemd, you should stop them.
• Use your Docker's host ip to set your DNS server on other devices in your network.
• You can use your /etc/hosts file as a Docker volume. dnsmasq will respect that.

Support 💛

Contributing 🤝

Don't be shy and reach out to us if you want to contribute 😉

1. Fork it!
2. Create your feature branch: git checkout -b my-new-feature
3. Commit your changes: git commit -am 'Add some feature'
4. Push to the branch: git push origin my-new-feature
5. Submit a pull request

Issues

Each project may have many problems. Contributing to the better development of this project by reporting them. 👍