# 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.*