SparkBox / Guides / AdGuard Home setup

How to set up AdGuard Home

· Updated 31 July 2026 · SparkBox team

Network-wide ad & tracker blocker. This guide covers how to access it, log in for the first time, configure the basics, and where its data lives so you can back it up.

SparkBox Apps page — one-click install cards for every module
SparkBox Apps page — one-click install cards for every module
In this guide:
  1. What is AdGuard Home?
  2. Before you start
  3. How to access it
  4. First login
  5. Where your data lives

1. What is AdGuard Home?

AdGuard Home is a network-wide ad-blocking DNS server. It blocks ads and trackers for every device on your network with a modern UI and built-in DNS-over-HTTPS, DNS-over-TLS, and DNSCrypt support.

Pi-hole blocking ads for every device on the network
Pi-hole blocking ads for every device on the network
SparkBox dashboard home with app launcher tiles and system stats
SparkBox dashboard home with app launcher tiles and system stats

2. Before you start

AdGuard Home is an alternative to Pi-hole. You should only enable ONE ad-blocker DNS at a time. Disable the privacy module if switching.

3. How to access it

Once it's enabled, AdGuard Home runs on your SparkBox at:

SparkBox dashboard login screen
SparkBox dashboard login screen
http://<your-NAS-IP>:3054

On first launch AdGuard shows a setup wizard. When it asks for the Admin Web Interface port, accept the DEFAULT port (80) so SparkBox's launcher keeps working afterward — do not change it to 3000. Then point your router's DNS to this server's IP.

4. First login

AdGuard runs a setup wizard on first launch — pick a username and password there, then use those to log in. No pre-set defaults.

If it instead asks for a password you didn't set, check Settings → Passwords in your SparkBox dashboard — every auto-generated credential is listed there.

5. Where your data lives

AdGuard Home's config and persistent data are stored on the SparkBox host under:

/opt/sparkbox/modules/adguard/config/

Backups via the SparkBox dashboard's Backup tile include this directory by default, so a single restore brings AdGuard Home back to its current state on a fresh install.

Next steps

That's AdGuard Home live on SparkBox.

If something doesn't match what you see, post in d/sparkbox or hit us up on YouTube. Every SparkBox bug gets patched; every UX-stumble in this guide gets rewritten.

Get SparkBox → More guides →

Questions, or did this not match your box?

Every guide here came from a real problem someone hit. If yours behaves differently, say so — that is how these get corrected, and how the fix gets prioritised.

Ask in the community →

We answer there rather than in a comment box, because that is where the people who have already solved it are.

About this guide: Generated from the SparkBox module manifest and verified against a live install. If you spot something that doesn't match your experience, tell us in d/sparkbox.