Skip to content

lmiphay/adguardhome-docker

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

adguardhome-docker

Adguardhome in a container.

Configuration

Variables in /etc/adguardhome.conf (on the host server) allow these settings to be customised:

  1. adguardhome version
  2. directories to mount from the host
  3. timezone setting
  4. ports - different DNS and DHCP options - see https://hub.docker.com/r/adguard/adguardhome

The AdGuard Home service is found on: http://127.0.0.1:3000/

Quickstart

$ adguardhome-docker settings
...
$ adguardhome-docker pull
$ adguardhome-docker create
...
$ adguardhome-docker start
$ adguardhome-docker logs
...
$ adguardhome-docker stop
...
$ adguardhome-docker delete

Examine AdGuard Home Logs

The first time AdGuard Home starts, logs similar to this will be seen:

$ adguardhome-docker logs
2021/10/08 16:25:55.806120 [info] AdGuard Home, version v0.106.3
2021/10/08 16:25:55.806232 [info] This is the first time AdGuard Home is launched
2021/10/08 16:25:55.806241 [info] Checking if AdGuard Home has necessary permissions
2021/10/08 16:25:55.806404 [info] AdGuard Home can bind to port 53
2021/10/08 16:25:55.807264 [info] Initializing auth module: /opt/adguardhome/work/data/sessions.db
2021/10/08 16:25:55.810938 [info] auth: initialized.  users:0  sessions:0
2021/10/08 16:25:55.810947 [info] Initialize web module
2021/10/08 16:25:55.810967 [info] This is the first launch of AdGuard Home, redirecting everything to /install.html 
2021/10/08 16:25:55.811008 [info] AdGuard Home is available on the following addresses:
2021/10/08 16:25:55.811123 [info] Go to http://127.0.0.1:3000
2021/10/08 16:25:55.811128 [info] Go to http://172.17.0.3:3000
...

Upgrade

After installing or updating adguardhome-docker:

  1. adguardhome-docker stop
  2. adguardhome-docker pull
  3. docker rename adguardhome adguardhome-0.106.3 # renames the old container
  4. adguardhome-docker create
  5. adguardhome-docker start

Optional - to remove an old container and/or image:

  1. docker rm adguardhome-0.106.3
  2. docker rmi adguard/adguardhome:v0.106.3

OpenRC

To have the container start automatically:

rc-config add adguardhome

Logging

The default docker "json-file" logging driver does not do log rotation.

To select the "local" driver, with a max file size of 10MB and four files, add this to /etc/docker/daemon.json:

{
  "log-driver": "local",
  "log-opts": {
    "max-size": "10m",
    "max-file": "4"
  }
}

References

  1. https://wiki.gentoo.org/wiki/Docker
  2. https://hub.docker.com/r/adguard/adguardhome
  3. https://github.com/AdguardTeam/AdGuardHome/wiki/Docker
  4. https://github.com/AdguardTeam/AdGuardHome
  5. https://www.ibm.com/docs/en/tpmfod/7.1.1.14?topic=configuration-dhcpdconf-example

About

AdGuard Home in a container

Resources

License

Stars

Watchers

Forks

Packages

No packages published