Local Dns Server With Vagrant Homestead

I've been using Laravel Homestead for a while now, many thanks to Taylor for making life so much easier. If you are using Homestead your usual workflow might be something along the lines of Creating new laravel app > Adding site entry in Homestead.yaml file > Adding domain into /etc/hosts file and then get to work.
Everything is pretty simple except managing the /etc/hosts file. Really, I never wanted to add more and more domains into it without having any idea about which domain is still required and which is no longer in business. This is when I decided to let Homestead manage all those domains for me.

Long story short, I installed Dnsmasq on Homestead and added it as a DNS on host machine, now all the domain entries are stored on Homestead virtual machine and I can take care of business without worrying about pesky domain mappings.

Here is how you can set up a basic DNS for your applications.

Before setting up everything else you'll need to make a change in your Homestead Vagrantfile, open up the Vagrantfile and make sure it looks like this


path = "#{File.dirname(__FILE__)}"

require 'yaml'
require path + '/scripts/homestead.rb'

Vagrant.configure(VAGRANTFILE_API_VERSION) do |config|

  # comment out the default line like this below
  # Homestead.configure(config, YAML::load(File.read(path + '/Homestead.yaml')))

  preferences = YAML::load(File.read(path + '/Homestead.yaml'))
  # run default Homestead provision
  Homestead.configure(config, preferences)

# remove existing hosts file if any
  config.vm.provision "shell" do |shell|
    shell.inline = "rm $1"
    shell.args = ["/home/vagrant/hosts"]

  # add custom provision script to populate domain mapping
  preferences["sites"].each do |site|
    config.vm.provision "shell" do |shell|

      # populate the domain mapping file from Homestead sites configuration
      # the dot after $2 is important
      shell.inline = "echo $1  $2. >> /home/vagrant/hosts"
      shell.args = [preferences["ip"], site["map"]]


This will take all the Sites entries defined in Homestead.yaml file and use those domains to populate a domain mapper file much like /etc/hosts file

Now vagrant up and SSH into Homestead and install dnsmasq by running

sudo apt-get install dnsmasq

Now with that installed you need to set a couple things up.

open /etc/dnsmasq.conf file in your editor of choice and clear it out, then add this configuration to file


# define local domain part
# this will allow you to have domains with .app extension,
# so make sure all your development apps are using .app as extension,
# e.g. somedomain.app, myapp.app

# listen on both local machine and private network

# read domain mapping from this file as well as /etc/hosts

save and close the file.
Now restart dnsmasq by running

sudo service dnsmasq restart

and you are set.

Now log out of Homestead and make one last change on your machine. This is the time to let our host machine know about new DNS server on the network.

Set up Mac

I added new DNS by going to Network Connection Icon > Open Network Preferences > Active Connection (From Left Pane) > Advanced > DNS (Tab).

Then in left pane add these IPs by clicking the + button

Click Ok and Apply

Set up Linux

On my Linux the process was going to Network manager icon > Edit Connecions... > Select active connection > Edit... > IPv4 settings (Tab).

Then in Additional DNS servers enter the DNS servers separated by comma:,,

and click Save

Set up Windows

Please install Linux and follow the instructions from Linux section

And you're now good to go. Here, the first IP is our local DNS running on Homestead machine and rest two are Google's DNS. Now every time you make a request to open any site these DNS will be queried in same order as defined. Homestead DNS will be queried first, and if it is offline other two will be queried.

Now lets just perform a quick check to make sure things are working as they should be, grab a domain from Homestead.yaml file and open up a terminal on hot machine. Now run

dig yourdomain.app

It should output some details about the domain which should look like this

; <<>> DiG 9.8.3-P1 <<>> yourdomain.app
;; global options: +cmd
;; Got answer:
;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 28778
;; flags: qr aa rd ra; QUERY: 1, ANSWER: 1, AUTHORITY: 0, ADDITIONAL: 0

;yourdomain.app.        IN    A

yourdomain.app. 0   IN      A

;; Query time: 46 msec
;; WHEN: Sun Jun  8 15:23:41 2014
;; MSG SIZE  rcvd: 54

Notice the fourth line which says

;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 28778

If you did everything correct it should say status: NOERROR if it says status: NXDOMAIN that means the domain cannot be resolved to any IP address. And finally the answer section should show the IP address of Homestead machine

yourdomain.app. 0   IN      A

If anything goes wrong just try to restart dnsmasq by running

sudo service dnsmasq restart

and see if that resolves the issue, otherwise feel free to post your /etc/dnsmasq.conf file in comment and I'll try to help.

Open up your browser and go to yourdomain.app, you should see Laravel greetings.
Enjoy the freedom.