axllent/adguard-home-bg repository overview

⁠AdGuard Home blocklist generator

Project page: https://github.com/axllent/adguard-home-bg⁠

AdGuard Home blocklist generator is a tool to generate a formatted blocklist for AdGuard Home⁠ from a URL. It accepts a variety of input formats, including:

• Plain line-separated list of domain names
• A hosts-formatted list (eg 0.0.0.0 example.com)
• AdGuard-formatted list

It allows you to append AdGuard rule modifiers⁠ to the generated blocklist to allow for more specific filtering, such as ctags, clients etc.

It comes with a simple command line interface and a web interface. The web interface also enables you to configure a blocklist and rule modifiers, and provides you with a reusable URL which you can then configure AdGuard Home to use. The CLI allows you to download and manipulate the original blocklist on the same manner, however is only useful for saving a blocklist to the filesystem.

⁠Run the docker image

docker run -d --name adguard-home-bg -p 8080:8080 axllent/adguard-home-bg

The server is set to run on the default 8080 port, however if you wish to connect to your container on a different port then you can always map your port to 8080, eg:

docker run -d --name adguard-home-bg -p 80:8080 axllent/adguard-home-bg