devilbox/docs/howto/dns/add-project-dns-entry-on-linux.rst

orphan

Add project hosts entry on Linux

On Linux, custom DNS entries can be added to the /etc/hosts and will take precedence over the same entries provided by any DNS server.

Table of Contents

local

Assumption

In order to better illustrate the process, we are going to use two projects as an example. See the following table for project directories and env_tld_suffix.

Project directory	TLD_SUFFIX	Project URL	Required DNS name
project-1	loc	http://project-1.loc	project-1.loc
www.project-1	loc	http://www.project-1.loc	www.project-1.loc

Step by step

When using Docker on Linux you can use 127.0.0.1 for the IP address.

1. Open /etc/hosts with root privileges or via sudo with your favorite editor

   host> sudo vi /etc/hosts

2. Add DNS records for the above listed examples:

   127.0.0.1  project-1.loc
   127.0.0.1  www.project-1.loc

3. Safe the file and verify the DNS entries with the ping command

   host> ping -c1 project-1.loc
   
   PING project-1.loc (127.0.0.1) 56(84) bytes of data.
   64 bytes from localhost (127.0.0.1): icmp_seq=1 ttl=64 time=0.066 ms

   host> ping -c1 www.project-1.loc
   
   PING www.project-1.loc (127.0.0.1) 56(84) bytes of data.
   64 bytes from localhost (127.0.0.1): icmp_seq=1 ttl=64 time=0.066 ms