83 lines
2.7 KiB
Markdown
83 lines
2.7 KiB
Markdown
# AdGuard Control Hub Wiki
|
|
|
|
Welcome to the AdGuard Control Hub integration wiki! This comprehensive guide will help you get the most out of your AdGuard Home integration with Home Assistant.
|
|
|
|
## Quick Navigation
|
|
|
|
- [Installation Guide](Installation.md) - Step-by-step installation instructions
|
|
- [Configuration](Configuration.md) - Detailed configuration options
|
|
- [Features Overview](Features.md) - Complete feature documentation
|
|
- [API Reference](API-Reference.md) - AdGuard Home API information
|
|
- [Troubleshooting](Troubleshooting.md) - Common issues and solutions
|
|
- [Advanced Usage](Advanced-Usage.md) - Automation examples and advanced features
|
|
- [Development](Development.md) - Contributing and development setup
|
|
|
|
## What is AdGuard Control Hub?
|
|
|
|
AdGuard Control Hub is a comprehensive Home Assistant integration that provides complete control over your AdGuard Home DNS server. It allows you to:
|
|
|
|
- Monitor DNS statistics and performance
|
|
- Control filtering and protection features
|
|
- Manage clients and their settings
|
|
- Create powerful automations based on DNS activity
|
|
- View detailed analytics and reports
|
|
|
|
## Key Features
|
|
|
|
### 🛡️ Complete Protection Control
|
|
- Master protection switch
|
|
- DNS filtering management
|
|
- Safe browsing controls
|
|
- Parental control settings
|
|
- Safe search enforcement
|
|
- Query logging control
|
|
|
|
### 📊 Comprehensive Monitoring
|
|
- Real-time DNS query statistics
|
|
- Blocked query tracking
|
|
- Performance metrics
|
|
- Filter rule counts
|
|
- Client activity monitoring
|
|
|
|
### 🏠 Home Assistant Integration
|
|
- Native Home Assistant entities
|
|
- Lovelace dashboard cards
|
|
- Automation support
|
|
- Service calls
|
|
- Event triggering
|
|
|
|
### 🔧 Easy Configuration
|
|
- GUI-based setup flow
|
|
- Automatic discovery
|
|
- Connection validation
|
|
- Error handling
|
|
- Secure credential storage
|
|
|
|
## Getting Started
|
|
|
|
1. **Prerequisites**: Ensure you have AdGuard Home v0.107.0+ running
|
|
2. **Installation**: Follow the [Installation Guide](Installation.md)
|
|
3. **Configuration**: Set up your connection using the [Configuration Guide](Configuration.md)
|
|
4. **Features**: Explore available features in the [Features Overview](Features.md)
|
|
|
|
## Support
|
|
|
|
If you encounter any issues:
|
|
|
|
1. Check the [Troubleshooting Guide](Troubleshooting.md)
|
|
2. Review the [GitHub Issues](https://github.com/your-username/adguard-control-hub/issues)
|
|
3. Join the discussion in [GitHub Discussions](https://github.com/your-username/adguard-control-hub/discussions)
|
|
|
|
## Contributing
|
|
|
|
We welcome contributions! See the [Development Guide](Development.md) for information on:
|
|
|
|
- Setting up a development environment
|
|
- Running tests
|
|
- Submitting pull requests
|
|
- Reporting bugs
|
|
|
|
---
|
|
|
|
*This integration is not officially affiliated with AdGuard. AdGuard Home is a trademark of AdGuard Software Ltd.*
|