All pages
The whole wiki, in one list.
Twenty-three articles in six sections. The sidebar filter matches titles, summaries and keywords, so searching for “port 53” finds Troubleshooting.
All of them are written for AdGuard HomePi-hole, following the switch in the header. Flipping it rewrites the commands, environment variables, installer transcript and caveats throughout — the pages that change most are Quick start, Configuration, The installer, Troubleshooting and the comparison.
Getting started#
What this is, what it needs, and the shortest path to having it running.
- IntroductionWhat this product is, and the gap in your resolver's dashboard it was built to fill.
- Quick startOne command, on a box that can run Docker. Ten minutes including the pull.
- RequirementsHardware, operating system, ports and the one thing that is not optional.
- The first hourWhat backfill is doing, why the numbers keep moving, and when to start trusting them.
Running it#
Installing, configuring, updating and repairing a real instance.
- The installerEvery step install.sh takes, why it takes it, and every flag it accepts.
- Installing by handDocker Compose without the script, for anyone who would rather read the YAML.
- ConfigurationEvery environment variable, what it defaults to, and when to change it.
- UpdatingPulling a new image without losing history, and what happens to the schema.
- BackupsOne file matters. How to copy it safely while the thing is running.
- TroubleshootingThe failures that actually happen, in the order they actually happen.
- SecurityThere is no login. What that means, and what to do about it.
How it works#
What happens between your resolver answering a query and a chart drawing it.
- ArchitectureThe four moving parts and what passes between them.
- IngestHow a circular buffer is turned into ninety days of history without gaps or duplicates.
- Rollups and retentionWhy detail is thrown away, what survives it, and how the seam is drawn honestly.
- EnrichmentTurning an address into a device, a hostname into a company, an answer into a city.
- DetectorsHow anomalies and friction are found, and what each one refuses to claim.
- Data modelThe fact table, the dimensions around it, and why every repeated string is an integer.
Compared#
Where this sits next to the software it reads from.
About this demo#
What the site you are on right now is, and where it differs from the product.
Reference#
Tables, terms and answers to look up rather than read.