Manually Install AdGuard Home in a MikroTik Container (Method 2)

In the previous guide , I installed an AdGuard Home container using a ready-made Docker image.

That approach is fast, but some installations fail even after repeated attempts. This guide uses a blank Docker image with no service installed, then installs AdGuard Home inside it.

The offline image can reduce image-pull failures and allows other services to be added. The trade-off is more setup work.

I. Enable Container support

• Open Terminal and run /system/device-mode/update container=yes.

  

• When prompted, power-cycle the router.
• After reboot, run /system/device-mode/print and confirm container: yes.

  

II. Prepare container networking and install the blank image

II.A. Prepare networking

1. Create a bridge named dockers.

   

2. Assign an IP address.

   

3. Create a VETH interface.

   

4. Add the port to the dockers bridge.

   

II.B. Install the blank Docker image

1. Download the blank image from Google Drive or the Mega mirror .
   • It is based on Alpine Linux 3.17 Slim.
   • It uses Supervisor to start services.
   • It contains no personal customization or harmful scripts.
   • If you do not trust a prebuilt image, build your own.
2. Upload the image to MikroTik through Files in WinBox.

   

   

3. Open Container, click Add, and configure:

Click Apply. If the image is installed correctly, the result should look like the screenshot.

Click Start and confirm Status changes to Running.

III. Install AdGuard Home in the blank image

1. Open WinBox Terminal:

1

/container/shell 0

0 is the container ID. Run /container print if the ID is different.

2. Download AdGuard Home:

1
2

cd /opt
wget https://github.com/AdguardTeam/AdGuardHome/releases/download/v0.107.38/AdGuardHome_linux_amd64.tar.gz

3. Extract it:

1

tar -vxzf AdGuardHome_linux_amd64.tar.gz

4. Configure Supervisor to start AdGuard Home:

1

vi /etc/supervisord.conf

Add:

1
2

[program:adguardhome]
command=/opt/AdGuardHome/AdGuardHome

Save with ESC, then :wq! and Enter.

Stop and start the container again.

Open http://10.0.0.2:3000/ to configure AdGuard Home.

IV. Set DHCP DNS to AdGuard Home

• Open IP > DHCP Server > Network.

  

Good luck.