We implement comprehensive internet safety and security measures for our educational environment. This repository contains the configuration backup for AdGuardHome, our DNS-based content filtering solution that protects students from inappropriate content and enhances network security.
AdGuardHome-configs/
│
├── 📄 README.md # This documentation file
├── 📄 AdGuardHome.yaml # Main configuration file
├── 📄 permission-fix.bat # Ownership utility for backup/repair operations
│
├── 📁 data/ # AdGuardHome data directory
│ ├── 📄 sessions.db # User sessions database
│ ├── 📄 stats.db # Statistics database
│ └── 📁 filters/ # Custom filter directory
│ ├── 📄 1.txt # Filter list 1
│ ├── 📄 2.txt # Filter list 2
│ └── 📄 ... # Additional filter lists
- AdGuardHome installed on Windows
- PowerShell 5.1 or newer
- Administrative privileges
-
Download and Extract AdGuardHome
# Download latest version from https://github.com/AdguardTeam/AdGuardHome/releases # Extract to C:\AdGuardHome (recommended)
-
Install AdGuardHome Service
cd C:\AdGuardHome AdGuardHome.exe -s install
-
Initial Setup
- Open your browser and navigate to
http://localhost:3000 - Follow the initial setup wizard
- Complete the basic configuration
- Open your browser and navigate to
-
Stop Service for Configuration
AdGuardHome.exe -s stop
-
Run Permission Fix Script (As Administrator)
# Execute the permission fix utility permission-fix.bat
-
Deploy Configuration Files
- Copy the
data/directory toC:\AdGuardHome\ - Replace
AdGuardHome.yamlinC:\AdGuardHome\ - Important: Preserve your encryption password from the original file
- Copy the
-
Restart Service
AdGuardHome.exe -s start
Our AdGuardHome configuration includes:
- Content Filtering: Comprehensive blocking of inappropriate content
- Security Enhancements: Protection against malware and phishing sites
- Educational Focus: Whitelisting for educational resources
- Monitoring: Detailed logging and statistics
- Custom Rules: Tailored filtering rules for educational environments
-
Permission Errors
# Run as Administrator permission-fix.bat
-
Service Won't Start
# Check logs in C:\AdGuardHome\AdGuardHome.log # Verify configuration file syntax
-
Configuration Validation
AdGuardHome.exe --check-config
- Regularly check
AdGuardHome.yamlfor custom rules updates - Monitor filter lists in
data/filters/directory - Review statistics in the web interface
- Schedule regular backups using provided scripts
- Always backup original configuration before applying changes
- Keep encryption passwords secure and never commit to version control
- Regularly update AdGuardHome to latest version
- Review and update filter lists periodically
This configuration is provided for educational purposes. Please ensure compliance with:
- Your organization's IT policies
- Local regulations regarding content filtering
- Privacy laws and regulations
To suggest improvements or report issues:
- Fork this repository
- Create a feature branch
- Submit a pull request with detailed description
For technical assistance with this configuration:
- Check the AdGuardHome documentation
- Review existing issues in this repository
- Consult with your network administrator
Note: Always test configurations in a controlled environment before deploying to production systems. Regular backups are essential for maintaining service continuity.
AdGuardHome Configuration Backup ·
| Contributor | Role | Link |
|---|---|---|
| IT Syathiby 2024 | Configuration Development & Maintenance |  |
| IT Rodja | Initial Guide & Inspiration |  |