search

xptsp / luci-app-adguardhome

Package for luci-app-adguardhome for OpenWRT
Apache License 2.0
2 stars 2 forks source link

readme

LuCI App AdGuardHome

NOTE: Original Source found for LUCI app here by Duncan Hill (openwrt-dev@cricalix.net).

This LuCI app provides basic integration with the AdGuard Home package for OpenWrt. Note that the AdGuard Home package installation and configuration requires interaction with the OpenWrt command line; this app does not remove any of that interaction.

See also: AdGuard Home @ AdGuard

Using/installing this app

First, install the AdGuard Home package - either via the web UI for software package management, or

opkg install adguardhome

Follow the installation instructions for AdGuard Home, and make a note of the username and password for authenticating to the web UI.

Next, install this package - either via the web UI for software package management, or

opkg install luci-app-adguardhome

This package is unable to automatically determine the username and password (the password is encrypted in AdGuard Home's configuration file), so you'll need to go to Services > AdGuard Home > Configuration and provide these credentials. The credentials will be stored unencrypted in /etc/config/adguardhome.

With the credentials saved, the Services > AdGuard Home > Status page should now work, and show you the general status of AdGuard Home.

If you go to Services > AdGuard Home > Logs, you can see the last 50 log lines from both the supporting script used by this package, and the AdGuard Home software.

This app provides a link to the AdGuard Home web UI, making it easy to see more detailed statistics, and the query log.

Dependencies

Dependencies are declared in the Makefile, but are

Screenshots

Status Tab

Status Tab

Logs Tab

General Tab

Configuration Tab

MAC Filter Tab

Package History