# 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 (Main Gateway): `10.0.0.254`
- AdGuard Home DNS: `10.0.0.245`
- TP-Link Archer AX72 Pro (AP Mode): `10.0.0.246`
- DHCP Range: `10.0.0.1 - 10.0.0.200`
- DNS Options: `10.0.0.245` (filtered), `10.0.0.254` (unfiltered)

## Files in this Repository

### 📖 [openwrt-adguard-setup.md](openwrt-adguard-setup.md)
Comprehensive configuration guide covering:
- Initial OpenWRT setup and network configuration
- DHCP server configuration with static leases
- Advanced DHCP options (dual DNS, boot options, NTP, etc.)
- Custom DNS settings per client
- Multiple access control methods
- AdGuard Home installation and configuration
- TP-Link AX72 Pro WiFi 6 AP configuration
- Integration and testing procedures
- Troubleshooting and maintenance

### 🛡️ [device-control.sh](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](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

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

## Features

✅ DHCP server with customizable range  
✅ Static IP assignment for critical devices  
✅ Dual DNS configuration (filtered + unfiltered)  
✅ 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  
✅ Advanced DHCP options (NTP, boot options, static routes)  

## Network Topology

```
Cable Modem
    ↓
OpenWRT Router (10.0.0.254) - Main Gateway, DHCP, Firewall
    ↓
AdGuard Home (10.0.0.245) - DNS Filtering
    ↓
TP-Link AX72 Pro (10.0.0.246) - WiFi 6 Access Point
    ↓
Devices (10.0.0.1-200)
```

## Device Access Control

Simple commands to manage device access:

```bash
# 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)
- TP-Link Archer AX72 Pro (or similar WiFi 6 router for AP mode)
- Basic networking knowledge
- SSH access to OpenWRT

## Support

Refer to the comprehensive troubleshooting sections in the main guide, or consult:
- [OpenWRT Forum](https://forum.openwrt.org/)
- [AdGuard Home Documentation](https://github.com/AdguardTeam/AdGuardHome/wiki)

## License

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