Feature Request: Guide for Podman Container

[EntropySmoke]

Some routers support Podman Container that can run Pi-Hole and/or AdGuard Home. For example, UniFi Dream Machine (UDM) and UniFi Dream Machine Pro (UDM-Pro) from Ubiquiti are supposed by these tools that can allow you to run AdGuard Home in Podman Container - https://github.com/boostchicken/udm-utilities/tree/master/on-boot-script .

AGH does an incredible job explaining how to install AGH on Raspberry Pi and OpenWRT with step-by-step instructions. A similar guide or maybe even a plugin on how to make AGH run on UDM/UDM-Pro in a Podman Container are greatly desired!

[ameshkov]

Since we don't have any experience with Podman Container, I'll mark this as "help wanted".

If anyone could suggest a guide, we'd be happy to add it to AGH wiki.

[foxyroxyrooster]

replace 'docker' in official adguardhome docs with 'podman' - that's pretty much all the difference there is. Not worth any effort from adguardhome developers

[tackynugget]

@EntropySmoke That same GitHub user has decent instructions on how to set this up. Have you seen this? https://github.com/boostchicken/udm-utilities/tree/master/AdguardHome

Here's the gist of how I got it working on my UDM Pro.

Enabled SSH

• Navigate to Unifi.ui.com
• Waffle icon in top right > Settings > Advanced > SSH > Enable
• Set a strong password for root

Backed up settings

• Waffle > Network > Classic Settings > Backup > Download Backup > Download File

Created a new corporate network via unifi.ui.com for AdGuardHome

• VLAN## (for the AdGuardHome app)
• No DHCP
• [CIDR range for the AdGuardHome network]

Prepared the UDMP for the AdGuard boot script by following these steps https://github.com/boostchicken/udm-utilities/tree/master/on-boot-script

• SSH’d into the UDMP: ssh root@[UDMPRO IP Address]
• Opened Unifi-OS Shell: unifi-os shell
• Downloaded a thing: curl -L https://raw.githubusercontent.com/boostchicken/udm-utilities/master/on-boot-script/packages/udm-boot_1.0.2_all.deb -o udm-boot_1.0.2_all.deb
• DPKG’d a thing: dpkg -i udm-boot_1.0.2_all.deb
• Made the requisite directories mkdir /mnt/data/AdGuardHome-Conf and mkdir /mnt/data/AdGuardHome-Work
• Exited Unifi-os shell: exit

Created the 10-dns.sh file: touch /mnt/data/on_boot.d/10-dns.sh

• Opened the file via vi: vi /mnt/data/on_boot.d/10-dns.sh
• Entered insert mode: i
• Copied the file from the web and pasted into vi
• Made the following modifications to the 10-dns.sh script

  • VLAN=[VLAN for AdGuardHome]
  • IPV4_IP="[IP Address of the AdGuardHome app]”
  • IPV4_GW="[Gateway address in CIDR format]”
  • FORCED_INTFC=[list of VLANs for AdGuardHome to protect prefixed with br and enclosed in double-quotes--ie "br35 br63 br 491" for VLANs 35, 63, 491. If this is not configured, all traffic will look like it comes from the adguardhome gateway]
  • CONTAINER=adguardhome

• Exited insert mode: [Esc]
• Saved changes and exited: :wq

Inspected the permissions for the 10-dns.sh script and saw root had RW, but not X permissions: ls -l /mnt/data/on_boot.d/10-dns.sh

• Granted root X access: chmod u=rwx /mnt/data/on_boot.d/10-dns.sh
• Double-checked changes: ls -l /mnt/data/on_boot.d/10-dns.sh
• Executed script: /mnt/data/on_boot.d/10-dns.sh

Created the 20-dns.conflist file: touch /mnt/data/podman/cni/20-dns.conflist

• Opened the file via vi: vi /mnt/data/podman/cni/20-dns.conflist
• Entered insert mode: i
• Copied the file from the web and pasted into vi
• Made the following modifications to the 20-dns.conflist

  • "master": "br####",
  • Deleted the “mac” section
  • "address": "[CIDR range for the AdGuardHome network configured above]”,
  • "gateway": "[AdGuardHome gateway IP address]”

• Exited insert mode: [Esc]
• Saved changes and exited: :wq

Ran this command to execute

podman run -d --network dns --restart always \ --name adguardhome \ -v "/mnt/data/AdGuardHome-Conf/:/opt/adguardhome/conf/" \ -v "/mnt/data/AdGuardHome-Work/:/opt/adguardhome/work/" \ --dns=127.0.0.1 --dns=1.1.1.1 \ --hostname adguardhome \ adguard/adguardhome:latest

Disconnected from UDM PRO SSH session: logout

Disabled SSH

• Navigate to Unifi.ui.com
• Waffle icon in top right > Settings > Advanced > SSH > Disable

I got this error: “Error: error creating container storage: the container name "adguardhome" is already in use by "[buncha numbers and letters]". You have to remove that container to be able to reuse that name.: that name is already in use” BUT accessing AdGuardHome via the specified IP in the browser works.

If you mess up you can remove the container: Podman rm adguardhome Might need to rerun the 10 script again if it doesn’t work.

AdGuardHome doesn't auto-update. I started this discussion here to see if someone might be so kind as to assist: https://github.com/boostchicken/udm-utilities/discussions/287