Commit 3b7add23 authored by Deac Karns's avatar Deac Karns

use static address; update documentation

parent e7ef3b58
......@@ -5,7 +5,7 @@ Vagrant.configure("2") do |config|
config.vm.box = "ubuntu/xenial64"
config.vm.network "public_network"
config.vm.network "private_network", ip: "172.16.0.53"
config.vbguest.auto_update = false
......
......@@ -14,48 +14,64 @@ Start the vagrant box
vagrant up
```
## Network configuration
You will be prompted by vagrant and asked what network interface you would like to bridge
your connection to. This is important because the vagrant box needs to get an ip address from
your connected network.
>Select the network interface that connects to your local network that is serving DHCP
## Switching Networks
Lets face it, you use more than one network if you use a laptop. In order to get the Pi-hole
box to be on the same network as your laptop you will need to reconfigure the application each
time you switch networks.
This can be cumbersome and repetitive so it has been abstracted into a provisioning step. At any point,
you can re-provision the box to set up Pi-hole and the vagrant box with the appropriate network settings.
Reconfigure the pihole vagrant box
```
vagrant provision
```
------
## DNSMasq
**What is it?**
[dnsmasq](https://en.wikipedia.org/wiki/Dnsmasq) will allow you to create DNS records easily. Any record you add to the `dnsmasq.conf` file will be turned into a local DNS record after you provision the vagrant box.
------
## Begin Using Pi-hole
Before you can take advantage of the Pi-hole vagrant box you will need to tell your computer to use it as your DNS server.
macOs:
Open `System Preferences` -> `Network`
- Open `System Preferences` -> `Network`
- click the `Advanced` button
- add the ip address to the DNS section
click the `Advanced` button
>by default the vagrant box uses the `172.16.0.53` ip address.
add the ip address to the DNS section
------
## Pi-hole Admin panel
If you have properly configured your computers `dns` entry, you should be able to go to the following address to view the Pi-hole admin panel:
[http://dns.pihole/admin](http://dns.pihole/admin)
The password is `secret`...literally, its `secret`
\ No newline at end of file
The password is `secret`...literally, its `secret`
# Advanced network configuration
> By default, this vagrant box is set to use a static ip address `172.16.0.53`. With some minor adjustments your can use a DHCP address that is provided
by a local DHCP server. This can be usefull if you want your pihole server and dnsmasq to be accessible by other computers on the same network.
### Network configuration
You will be prompted by vagrant and asked what network interface you would like to bridge
your connection to. This is important because the vagrant box needs to get an ip address from
your connected network.
>Select the network interface that connects to your local network that is serving DHCP
changing the following line in the `Vagrantfile` you can tell vagrant to use DHCP:
```
config.vm.network "private_network", ip: "172.16.0.53"
```
TO
```
config.vm.network "public_network"
```
### Switching Networks
Lets face it, you use more than one network if you use a laptop. In order to get the Pi-hole
box to be on the same network as your laptop you will need to reconfigure the application each
time you switch networks.
This can be cumbersome and repetitive so it has been abstracted into a provisioning step. At any point,
you can re-provision the box to set up Pi-hole and the vagrant box with the appropriate network settings.
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment