Ad blocking

Version 1.1.3 · plug-in API >=1.14 <2.0

PublishedHow to add it
On this page

Ad blocking: Problems

Find what is wrong with Ad blocking from what its tab or its card says, then follow the numbered answer.

Find your answer
Flow chart: Ad blocking is not working as it should. The same chart is written out in words after it.Failed or Not answeringNot supportedActive, but the card iswrongNeeds setting upNo answer from Ad blockingProtected, but 0 blockedAd blocking is notworking as it shouldWhat does its tab say?What does the cardsay?Start it again1Update it or updateStarboard2Add the address3Check the address andpassword4Check what is counted5
The chart in words

Start: Ad blocking is not working as it should

1 Start it again

  1. On Ad blocking's tab, read the message under its state: it says why it stopped.
  2. Select Try again.
  3. If it stopped soon after an update, select Roll back to and the version you had. Read Updates.
  4. Still failing: go to System, then Logs, and find its name.

2 Update it or update Starboard

Your Starboard's plug-in API is outside what this version of Ad blocking works with, so Starboard stopped it.

  1. Select Check for an update on its tab.
  2. If there is none, update Starboard. Read Update Starboard.

3 Add the address

The card says "Add the address in the plug-in's settings": Its address is empty.

  1. Go to Settings, then Plug-ins, then Ad blocking.
  2. Enter Its address and Password, and for AdGuard Home the User name.
  3. Select Save.
  4. Wait a minute for the card to ask again.

4 Check the address and password

Ad blocking asked Pi-hole or AdGuard Home and got no numbers back, or did not answer Starboard within 3 seconds.

  1. Open the address in Its address in your browser. If it does not open, Pi-hole or AdGuard Home is not running at that address.
  2. Check Which one matches what you run.
  3. Enter the password again and select Save. A saved password is never shown, so entering it again is the only way to be sure.
  4. For Pi-hole, check it is Pi-hole 6. Ad blocking uses the way Pi-hole 6 answers, and an older Pi-hole gives it no numbers.
  5. For AdGuard Home, check User name, and that the address includes its port, such as http://192.0.2.2:3000.
  6. Wait a minute for the card to ask again.

5 Check what is counted

The card shows 0 blocked with "no lookups yet": Pi-hole or AdGuard Home answered, but has counted no lookups today.

  • Check your router or your devices use Pi-hole or AdGuard Home for their lookups (DNS). If none does, there is nothing to count.
  • Open Pi-hole or AdGuard Home itself and compare its own count for today.

Report a problem

If none of these helps, tell its maker, with what its tab and the card say: the plug-ins' issues on GitHub.

Find out more

This page on GitHub, where the help is written.