Skip to content
Devilbox

Add project hosts entry on Linux

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.

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 directoryTLD_SUFFIXProject URLRequired DNS name
project-1lochttp://project-1.locproject-1.loc
www.project-1lochttp://www.project-1.locwww.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

    Terminal window
    host> sudo vi /etc/hosts

  2. Add DNS records for the above listed examples:

    Terminal window
    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

    Terminal window
    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
    Terminal window
    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