Skip to content
A Docker image that sets up a local DNS server.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
src
.travis.yml
LICENSE
README.md

README.md

docker-image-dns

Build Status

This repository contains the Docker image that can be used to set up a local dns server. This DNS server will let you browse to containers by appending .docker to the container name in the browser.

This image is based on https://github.com/jderusse/docker-dns-gen

Usage

Configure the local DNS Masq by doing the following:

sudo vim /etc/NetworkManager/dnsmasq.d/01_docker

Enter the following text:

bind-interfaces
interface=lo
interface=docker0
server=/docker/127.0.0.1#54

Restart the NetworkManager:

sudo systemctl restart NetworkManager

Next start the container and make sure it always restarts:

docker run --detach --name dns \
  --restart always \
  --publish 54:53/udp \
  --volume /var/run/docker.sock:/var/run/docker.sock \
  chesszebra/dns -R

Alternatively, if you are running a more barebones linux without dnsmasq and NetworkManager this is probably the easiest way to get it working:

  1. Skip the NetworkManager config since it does not apply.
  2. Start the container instead with –publish 53:53/udp
  3. Add 127.0.0.1 to /etc/resolv.conf
You can’t perform that action at this time.