Command-line interface for AdGuard Home - Network-wide ad blocking and DNS management via AdGuard Home REST API. Designed for AI agents and power users who need to manage filtering, DNS rewrites, clients, DHCP, and query logs without a GUI.
Network-wide ad blocking and DNS management via the AdGuard Home REST API. Designed for AI agents and power users who need to manage filtering, DNS rewrites, clients, DHCP, and query logs without a GUI.
This CLI is installed as part of the cli-anything-adguardhome package:
pip install cli-anything-adguardhome
Prerequisites:
curl -s -S -L https://raw.githubusercontent.com/AdguardTeam/AdGuardHome/master/scripts/install.sh | sh -s -- -v# Show help
cli-anything-adguardhome --help
# Start interactive REPL mode
cli-anything-adguardhome
# Check server status
cli-anything-adguardhome server status
# Run with JSON output (for agent consumption)
cli-anything-adguardhome --json server status
When invoked without a subcommand, the CLI enters an interactive REPL session:
cli-anything-adguardhome
# Enter commands interactively with tab-completion and history
Connection and configuration management.
| Command | Description |
|---|---|
show | Show current connection configuration |
save | Save connection settings to a config file |
test | Test the connection to AdGuard Home |
Server status and control commands.
| Command | Description |
|---|---|
status | Show server protection status |
version | Show AdGuard Home version |
restart | Restart the AdGuard Home server |
DNS filter list management.
| Command | Description |
|---|---|
list | List all configured filter lists |
status | Show filtering status |
toggle | Enable or disable filtering globally |
add | Add a new filter list by URL |
remove | Remove a filter list |
enable | Enable a specific filter list |
disable | Disable a specific filter list |
refresh | Force-refresh all filter lists |
Parental control, safe browsing, and safe search settings.
| Command | Description |
|---|---|
parental status | Show parental control status |
parental enable | Enable parental control |
parental disable | Disable parental control |
safebrowsing status | Show safe browsing status |
safebrowsing enable | Enable safe browsing |
safebrowsing disable | Disable safe browsing |
safesearch status | Show safe search status |
safesearch enable | Enable safe search |
safesearch disable | Disable safe search |
Manage blocked internet services.
| Command | Description |
|---|---|
list | List currently blocked services |
set | Set the list of blocked services |
Client device management.
| Command | Description |
|---|---|
list | List all configured clients |
add | Add a new client by name and IP |
remove | Remove a client |
show | Show details for a specific client |
Query statistics.
| Command | Description |
|---|---|
show | Show DNS query statistics |
reset | Reset all statistics |
config | View or update statistics retention interval |
DNS query log management.
| Command | Description |
|---|---|
show | Show recent DNS query log entries |
config | View or update query log settings |
clear | Clear the query log |
DNS rewrite rules.
| Command | Description |
|---|---|
list | List all DNS rewrite rules |
add | Add a DNS rewrite rule |
remove | Remove a DNS rewrite rule |
DHCP server management.
| Command | Description |
|---|---|
status | Show DHCP server status |
leases | List active DHCP leases |
add-static | Add a static DHCP lease |
remove-static | Remove a static DHCP lease |
TLS/HTTPS configuration.
| Command | Description |
|---|---|
status | Show TLS configuration status |
cli-anything-adguardhome server status
cli-anything-adguardhome server version
# List current filters
cli-anything-adguardhome filter list
# Add a new blocklist
cli-anything-adguardhome filter add --url https://somehost.com/list.txt --name "My List"
# Refresh all filters
cli-anything-adguardhome filter refresh
# Add a local DNS entry
cli-anything-adguardhome rewrite add --domain "myserver.local" --answer "192.168.1.50"
# List all rewrites
cli-anything-adguardhome rewrite list
cli-anything-adguardhome clients add --name "My PC" --ip 192.168.1.100
cli-anything-adguardhome clients list
# Show stats (human-readable)
cli-anything-adguardhome stats show
# Show stats (JSON for agents)
cli-anything-adguardhome --json stats show
All commands support dual output modes:
--json flag): Structured JSON for agent consumption# Human output
cli-anything-adguardhome filter list
# JSON output for agents
cli-anything-adguardhome --json filter list
When using this CLI programmatically:
--json flag for parseable outputconfig test before other commands1.0.0