DEV Community

Cover image for How to Add Domains and IP Addresses to Docker Containers
Berk
Berk

Posted on • Originally published at burakberk.dev

How to Add Domains and IP Addresses to Docker Containers

#dnsamsq #hosts #domain #docker

Overview

In this blog post, we'll explore how to enhance Docker container networking by adding custom domain and IP address mappings using dnsmasq and /etc/hosts file. We'll cover two methods: integrating dnsmasq with NetworkManager and configuring dnsmasq without NetworkManager. By the end of this post, you'll be able to easily manage custom domain resolutions in your containers.

Table of Contents

  1. Install Dnsmasq
  2. Configure Dnsmasq
    1. Dnsmasq Standalone Usage
    2. Dnsmasq with NetworkManager
  3. Configure Docker
  4. Add Test Domain Names to /etc/hosts
  5. Test the Custom Domain Names

Install Dnsmasq

  • Make sure dnsmasq is installed. 
which dnsmasq
Enter fullscreen mode Exit fullscreen mode
  • If not installed, install it 
# For Debian / Ubuntu
sudo apt install dnsmasq

# For RHEL / CentOS / Fedora
sudo dnf install dnsmasq
Enter fullscreen mode Exit fullscreen mode

Configure Dnsmasq

Dnsmasq Standalone Usage

In this section, we'll configure dnsmasq if you are not using NetworkManager.

  • Create a new configuration file for dnsmasq: 
sudo vim /etc/dnsmasq.conf
Enter fullscreen mode Exit fullscreen mode
  • Add the following configuration options: 
# Listen on the Docker bridge interface
interface=docker0

# Specify a default DNS server to forward queries
server=8.8.8.8  # Example: Google DNS
Enter fullscreen mode Exit fullscreen mode
  • Start the dnsmasq service and enable it to run on boot: 
sudo systemctl stop dnsmasq && \
sudo systemctl enable --now dnsmasq && \
sudo systemctl status dnsmasq
Enter fullscreen mode Exit fullscreen mode

Dnsmasq with NetworkManager

If you are using NetworkManager, you can use dnsmasq as its plugin.

  • Open NetworkManager main configuration file with an text editor: 
sudo vim /etc/NetworkManager/NetworkManager.conf
Enter fullscreen mode Exit fullscreen mode
  • Find the [main] section and add dns=dnsmasq 
[main]
dns=dnsmasq
Enter fullscreen mode Exit fullscreen mode
  • Create dnsmasq configuration file in the config daemon directory. 
sudo vim /etc/NetworkManager/dnsmasq.d/split-dns.conf
Enter fullscreen mode Exit fullscreen mode 
# Listen on the Docker bridge interface
interface=docker0

# Specify a default DNS server to forward queries
server=8.8.8.8  # Example: Google DNS
Enter fullscreen mode Exit fullscreen mode
  • Check if NetworkManager is running without no problem. 
sudo systemctl restart NetworkManager && \
sleep 5 && \
sudo systemctl status NetworkManager
Enter fullscreen mode Exit fullscreen mode
  • If there are problems, check the NetworkManager logs. 
journalctl -u NetworkManager -r
Enter fullscreen mode Exit fullscreen mode

Configure Docker

  • Check the IP address of the docker0. 
ip a show docker0
Enter fullscreen mode Exit fullscreen mode 
4: docker0: <NO-CARRIER,BROADCAST,MULTICAST,UP> mtu 1500 qdisc noqueue state DOWN group default
    link/ether 02:42:a9:72:e1:3a brd ff:ff:ff:ff:ff:ff
    inet 172.17.0.1/16 brd 172.17.255.255 scope global docker0
       valid_lft forever preferred_lft forever
    inet6 fe80::42:a9ff:fe72:e13a/64 scope link
       valid_lft forever preferred_lft forever
Enter fullscreen mode Exit fullscreen mode
  • Configure Docker to use the Dnsmasq 
sudo vim /etc/docker/daemon.json
Enter fullscreen mode Exit fullscreen mode 
{
  "dns": ["172.17.0.1"]
}
Enter fullscreen mode Exit fullscreen mode
  • Restart the docker service 
sudo systemctl restart docker
Enter fullscreen mode Exit fullscreen mode

Add Test Domain Names to /etc/hosts

For testing purposes, add a domain to /etc/hosts.

sudo bash -c "echo '192.168.1.12 nonexisting.example.com' >> /etc/hosts"
Enter fullscreen mode Exit fullscreen mode

Restart the dnsmasq service to get updates.

sudo systemctl restart dnsmasq
Enter fullscreen mode Exit fullscreen mode

Test the Custom Domain Names

In the /etc/hosts file, we defined nonexisting.example.com as 192.168.1.10.

Lets test if the configuration works as expected.

docker run --rm --name dns-test busybox nslookup nonexisting.example.com
Enter fullscreen mode Exit fullscreen mode

The output should be:

Server:     172.17.0.1
Address:    172.17.0.1:53

Non-authoritative answer:

Non-authoritative answer:
Name:   example.com
Address: 192.168.1.10
Enter fullscreen mode Exit fullscreen mode

Viola, you can set any custom domain name in the /etc/hosts file on the host machine and containers will use it by default.

For More

If you like the post, you can head to my personal blog site and read more about DevOps, Linux, system engineering, and self-hosted applications for homelab!

Burak Berk Keskin

Blog of a DevOps & System Engineer

favicon burakberk.dev

Top comments (0)

Read next

kailashnirmal profile image

Dockerizing your Java Spring Boot application with Maven, along with a PostgreSQL database

Kailash Nirmal -

pradumnasaraf profile image

Dockerizing a Golang API with MySQL and adding Docker Compose Support

Pradumna Saraf -

mrcaption49 profile image

Build your first CI/CD pipeline

Pranav Bakare -

thenjdevopsguy profile image

Open Cluster Management: Manage All k8s Clusters In One Place

Michael Levan -