Skip to content

Commit

Permalink
Update mkdocs.yml
Browse files Browse the repository at this point in the history
Signed-off-by: Nils Streedain <[email protected]>

Fix Pi-hole branding reference

Signed-off-by: Nils Streedain <[email protected]>

Update formatting

Signed-off-by: Nils Streedain <[email protected]>
  • Loading branch information
nilsstreedain committed Jun 7, 2024
1 parent c777967 commit c17489b
Show file tree
Hide file tree
Showing 2 changed files with 15 additions and 1 deletion.
15 changes: 14 additions & 1 deletion docs/guides/misc/vlans.md
Original file line number Diff line number Diff line change
@@ -1,31 +1,39 @@
# VLANs and virtual LAN interfaces
This guide will help you configure pi-hole to operate across defined virtual LAN interfaces on networks with VLANs configured.

This guide will help you configure Pi-hole to operate across defined virtual LAN interfaces on networks with VLANs configured.

## Notes & Warnings

- This guide should only be used by users with advanced networking knowledge with networks utilizing VLAN configurations
- Opening up ports for devices on insecure networks can be dangerous, proceed with caution
- If you want these the device to have static IP addresses or other further network routing configurations, those steps would need to be added based on your specific network setup and requirements.

## Setup VLANs

### Install `vlan` Package

```
sudo apt install vlan
```

### Configure VLAN interfaces

Create network interface configuration file for vlans

```
sudo nano /etc/network/interfaces.d/vlans
```

Add the following for each vlan interface you would like to add, replacing the `<>` brackets:

```
auto <interface>.<vlan id>
iface <interface>.<vlan id> inet manual
vlan-raw-device <interface>
```

For example, configuring VLAN id 8 and 16 on interface eth0 should look like:

```
auto eth0.8
iface eth0.8 inet manual
Expand All @@ -37,22 +45,27 @@ iface eth0.16 inet manual
```

### Restart and test

Restart Device Networking

```
sudo systemctl restart networking
```

Test config for an IP in each VLAN

```
hostname -I
```

Example output:

```
192.168.1.100 192.168.8.1 192.168.16.1
```

### Configure Pi-hole to Listen on the VLAN Interfaces

1. Go to the [Pi-hole admin dashboard](http://pi.hole/admin/)
2. Navigate to **Settings** > **DNS**
3. Under **Interface listening behavior**, choose **Listen on all interfaces** or **Permit all origins** depending on your security preference. More information about these settings can be found [here](https://docs.pi-hole.net/ftldns/interfaces/).
1 change: 1 addition & 0 deletions mkdocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -175,6 +175,7 @@ nav:
- 'Troubleshooting': guides/vpn/openvpn/troubleshooting.md
- 'Misc':
- 'Benchmarking': guides/misc/benchmark.md
- 'VLANs': guides/misc/vlans.md
- 'Tor & Pi-hole':
- 'Overview': guides/misc/tor/overview.md
- 'Basic Setup': guides/misc/tor/setup.md
Expand Down

0 comments on commit c17489b

Please sign in to comment.