Dnsmasq is a lightweight, easy to configure, DNS forwarder and DHCP server. It is designed to provide DNS and optionally, DHCP, to a small network. It can serve the names of local machines which are not in the global DNS. The DHCP server integrates with the DNS server and allows machines with DHCP-allocated addresses to appear in the DNS with names configured either in each host or in a central configuration file.
NOTE: NET_ADMIN capability is required.
This image is based on official dnsmasq builds for debian and it is built on top of the clover/base.
| Name | Default value | Description |
|---|---|---|
PUID | not set | desired user id of the process owner |
PGID | not set | desired group id of the process pwner (primary group of the PUID user) |
PUSER | not set | desired PUID user name |
PGROUP | not set | desired PGID group name |
CHOWN | not set | space-separated list of directories to change ownership to PUID/PGID during container startup |
CRON | not set (0) | will start cron inside the container if set to 1 |
DNSMASQ_PORT | 53 | port to listen for DNS requests on |
DNSMASQ_LOG_FACILITY | - | log to file (set to - for stderr) |
DNSMASQ_LOG_QUERIES | 1 | log DNS queries (set to 0 to disable) |
DNSMASQ_LOG_DHCP | 1 | extra logging for DHCP |
DNSMASQ_* | not set | any dnsmasq configuration parameters * |
DNSMASQ_-prefixed environment variablesDNSMASQ_-prefixed environment variables are named after their corresponding configuration parameters: an uppercased name with all - replaced with _.
Switches may only have a value of 0 (disabled) or 1 (enabled).
In dnsmasq some of the key-value pairs may appear more than once - in this case the value of the corresponding environment variable is a space-separated list.
If the key-value pair is a "singleton" - the whole value will be passed.
All of these variables will be translated into command line options during startup.
For more information please consult the man page.
| Location | Description |
|---|---|
/etc/dnsmasq.conf | main dnsmasq configuration file (if DNSMASQ_CONF_FILE is not specified) |
linux/amd64;linux/386;linux/arm/v7;linux/arm64/v8;linux/ppc64le;linux/s390x;Content type
Image
Digest
sha256:5382f304a…
Size
17.5 MB
Last updated
4 months ago
docker pull clover/dnsmasq