OpenWRT and AdGuard Home Configuration Guide

Complete setup guide for configuring OpenWRT router with AdGuard Home DNS filtering and device access control.

Network Configuration

Target Setup:

OpenWRT Router: 10.0.0.246
AdGuard Home DNS: 10.0.0.245
DHCP Range: 10.0.0.1 - 10.0.0.200
Gateway: 10.0.0.254 (existing TPLink router)

Files in this Repository

📖 openwrt-adguard-setup.md

Comprehensive configuration guide covering:

Initial OpenWRT setup and network configuration
DHCP server configuration with static leases
Custom DNS settings per client
Multiple access control methods
AdGuard Home installation and configuration
Integration and testing procedures
Troubleshooting and maintenance

🔧 device-control.sh

Bash script for easy device access management:

Block/unblock devices from internet access
List all currently blocked devices
Check device blocking status
View action logs
Simple command-line interface

✅ setup-checklist.md

Step-by-step checklist with:

Pre-setup information gathering
Phase-by-phase setup tracking
Testing procedures
Backup creation steps
Maintenance schedule
Troubleshooting quick reference

Quick Start

Follow the setup-checklist.md for a guided setup process
Refer to openwrt-adguard-setup.md for detailed explanations
Deploy device-control.sh to your OpenWRT router for easy device management

Features

✅ DHCP server with customizable range
✅ Static IP assignment for critical devices
✅ Per-client DNS server configuration
✅ Device-level internet access control
✅ AdGuard Home DNS filtering and ad-blocking
✅ Local DNS name resolution
✅ Comprehensive logging and monitoring

Device Access Control

Simple commands to manage device access:

# Block a device
./device-control.sh block 10.0.0.100 "Kids Tablet"

# Unblock a device
./device-control.sh unblock 10.0.0.100

# List all blocked devices
./device-control.sh list

# Check device status
./device-control.sh status 10.0.0.100

Prerequisites

OpenWRT router (any compatible device)
Server/device for AdGuard Home (Docker, Linux, or Windows)
Basic networking knowledge
SSH access to OpenWRT

Support

Refer to the comprehensive troubleshooting sections in the main guide, or consult:

License

Feel free to use and modify for your own network setup.