Claude
Skills
Sign in
Back

pp-adguard-home

Included with Lifetime
$97 forever

Printing Press CLI for Adguard Home. AdGuard Home REST-ish API. Our admin web interface is built on top of this REST-ish API.

Backend & APIs

What this skill does

<!-- GENERATED FILE — DO NOT EDIT.
     This file is a verbatim mirror of library/monitoring/adguard-home/SKILL.md,
     regenerated post-merge by tools/generate-skills/. Hand-edits here are
     silently overwritten on the next regen. Edit the library/ source instead.
     See the repository agent guide, section "Generated artifacts: registry.json, cli-skills/". -->

# Adguard Home — Printing Press CLI

## Prerequisites: Install the CLI

This skill drives the `adguard-home-pp-cli` binary. **You must verify the CLI is installed before invoking any command from this skill.** If it is missing, install it first:

1. Install via the Printing Press installer. It defaults binaries to `$HOME/.local/bin` on macOS/Linux and `%LOCALAPPDATA%\Programs\PrintingPress\bin` on Windows:
   ```bash
   npx -y @mvanhorn/printing-press-library install adguard-home --cli-only
   ```
2. Verify: `adguard-home-pp-cli --version`
3. Ensure the reported install directory is on `$PATH` for the agent/runtime that will invoke this skill.

If the `npx` install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.3 or newer):

```bash
go install github.com/mvanhorn/printing-press-library/library/monitoring/adguard-home/cmd/adguard-home-pp-cli@latest
```

If `--version` reports "command not found" after install, the runtime cannot see the binary directory on `$PATH`. Do not proceed with skill commands until verification succeeds.

## Command Reference

**access** — Manage access

- `adguard-home-pp-cli access list` — List (dis)allowed clients, blocked hosts, etc.
- `adguard-home-pp-cli access set` — Set (dis)allowed clients, blocked hosts, etc.

**adguard-home-profile** — Manage adguard home profile

- `adguard-home-pp-cli adguard-home-profile get` — Get
- `adguard-home-pp-cli adguard-home-profile update` — Updates current user info

**apple** — Manage apple

- `adguard-home-pp-cli apple mobile-config-do-h` — Get DNS over HTTPS .mobileconfig.
- `adguard-home-pp-cli apple mobile-config-do-t` — Get DNS over TLS .mobileconfig.

**blocked-services** — Blocked services controls

- `adguard-home-pp-cli blocked-services all` — Get available services to use for blocking
- `adguard-home-pp-cli blocked-services available-services` — Deprecated: Use `GET /blocked_services/all` instead.
- `adguard-home-pp-cli blocked-services list` — Deprecated: Use `GET /blocked_services/get` instead.
- `adguard-home-pp-cli blocked-services schedule` — Get blocked services
- `adguard-home-pp-cli blocked-services schedule-update` — Update blocked services
- `adguard-home-pp-cli blocked-services set` — Deprecated: Use `PUT /blocked_services/update` instead.

**cache-clear** — Manage cache clear

- `adguard-home-pp-cli cache-clear` — Clear DNS cache

**clients** — Clients list operations

- `adguard-home-pp-cli clients add` — Add a new client
- `adguard-home-pp-cli clients delete` — Remove a client
- `adguard-home-pp-cli clients find` — Get information about clients by their IP addresses or ClientIDs.
- `adguard-home-pp-cli clients search` — Retrieve information about clients by performing an exact match search using IP addresses, CIDRs, MAC addresses, or...
- `adguard-home-pp-cli clients status` — Get information about configured clients
- `adguard-home-pp-cli clients update` — Update client information

**dhcp** — Built-in DHCP server controls

- `adguard-home-pp-cli dhcp add-static-lease` — Adds a static lease
- `adguard-home-pp-cli dhcp check-active` — Searches for an active DHCP server on the network
- `adguard-home-pp-cli dhcp interfaces` — Gets the available interfaces
- `adguard-home-pp-cli dhcp remove-static-lease` — Removes a static lease
- `adguard-home-pp-cli dhcp reset` — Reset DHCP configuration
- `adguard-home-pp-cli dhcp reset-leases` — Reset DHCP leases
- `adguard-home-pp-cli dhcp set-config` — Updates the current DHCP server configuration
- `adguard-home-pp-cli dhcp status` — Gets the current DHCP settings and status
- `adguard-home-pp-cli dhcp update-static-lease` — Updates IP address, hostname of the static lease. IP version must be the same as previous.

**dns-config** — Manage dns config

- `adguard-home-pp-cli dns-config` — Set general DNS parameters

**dns-info** — Manage dns info

- `adguard-home-pp-cli dns-info` — Get general DNS parameters

**filtering** — Rule-based filtering

- `adguard-home-pp-cli filtering add-url` — Add filter URL or an absolute file path
- `adguard-home-pp-cli filtering check-host` — Check if host name is filtered
- `adguard-home-pp-cli filtering config` — Set filtering parameters
- `adguard-home-pp-cli filtering refresh` — Reload filtering rules from URLs. This might be needed if new URL was just added and you don't want to wait for...
- `adguard-home-pp-cli filtering remove-url` — Remove filter URL
- `adguard-home-pp-cli filtering set-rules` — Set user-defined filter rules
- `adguard-home-pp-cli filtering set-url` — Set URL parameters
- `adguard-home-pp-cli filtering status` — Get filtering parameters

**i18n** — Application localization

- `adguard-home-pp-cli i18n change-language` — Change current language. Argument must be an ISO 639-1 two-letter code.
- `adguard-home-pp-cli i18n current-language` — Get currently set language. Result is ISO 639-1 two-letter code. Empty result means default language.

**install** — First-time install configuration handlers

- `adguard-home-pp-cli install check-config` — Checks configuration
- `adguard-home-pp-cli install configure` — Applies the initial configuration.
- `adguard-home-pp-cli install get-addresses` — Gets the network interfaces information.

**login** — Manage login

- `adguard-home-pp-cli login` — Perform administrator log-in

**logout** — Manage logout

- `adguard-home-pp-cli logout` — Perform administrator log-out

**parental** — Blocking adult and explicit materials

- `adguard-home-pp-cli parental disable` — Disable parental filtering
- `adguard-home-pp-cli parental enable` — Enable parental filtering
- `adguard-home-pp-cli parental status` — Get parental filtering status

**protection** — Manage protection

- `adguard-home-pp-cli protection` — Set protection state and duration

**querylog** — Manage querylog

- `adguard-home-pp-cli querylog get-query-log-config` — Get query log parameters
- `adguard-home-pp-cli querylog put-query-log-config` — Set query log parameters
- `adguard-home-pp-cli querylog query-log` — Get DNS server query log.

**querylog-clear** — Manage querylog clear

- `adguard-home-pp-cli querylog-clear` — Clear query log

**querylog-config** — Manage querylog config

- `adguard-home-pp-cli querylog-config` — Deprecated: Use `PUT /querylog/config/update` instead.

**querylog-info** — Manage querylog info

- `adguard-home-pp-cli querylog-info` — Deprecated: Use `GET /querylog/config` instead. NOTE: If `interval` was configured by editing configuration file or...

**rewrite** — DNS rewrites

- `adguard-home-pp-cli rewrite add` — Add a new Rewrite rule
- `adguard-home-pp-cli rewrite delete` — Remove a Rewrite rule
- `adguard-home-pp-cli rewrite list` — Get list of Rewrite rules
- `adguard-home-pp-cli rewrite settings-get` — Get rewrite settings
- `adguard-home-pp-cli rewrite settings-update` — Update rewrite settings
- `adguard-home-pp-cli rewrite update` — Update a Rewrite rule

**safebrowsing** — Blocking malware/phishing sites

- `adguard-home-pp-cli safebrowsing disable` — Disable safebrowsing
- `adguard-home-pp-cli safebrowsing enable` — Enable safebrowsing
- `adguard-home-pp-cli safebrowsing status` — Get safebrowsing status

**safesearch** — Enforce family-friendly results in search engines

- `adguard-home-pp-cli safesearch disable` — Disable safesearch
- `adguard-home-pp-cli safesearch enable` — Enable safesearch
- `adguard-home-pp-cli safesearch settings` — Update safesearch settings
- `adguard-home-pp-cli safesearch status` — Get safesearch status

**stats** — AdGuard Home statistics

- `adguard-home-pp-cli stats get-config` — Get statistics parameters

Related in Backend & APIs