Cara Deploy Container AdGuard Home di Mikrotik v7

Menjalankan AdGuard Home langsung di dalam router MikroTik adalah solusi efisien untuk DNS filtering, blokir iklan, tracker, dan malware di seluruh jaringan LAN tanpa perlu server tambahan. Untuk update cara deploy AdGuard Home di MikroTik RouterOS 7.22++ punya dua metode: manual via /container dan model baru via /app menggunakan YAML.

Sebelum memulai, pastikan Anda sudah mengikuti cara mengaktifkan container dan struktur jaringan container (bridge khusus container, dan firewall NAT.) pada dokumentasi -> [Cara Konfigurasi Container di MikroTik RouterOS v7] karena ini artikel lanjutan.

Saat artikel ini dibuat dan menggunakan RouterOS v7.23.2 (stable), Adguard home belum ada di katalog /app. Jadi saya contohin deploy manual atau pakai YAML.

Deploy Adguardhome Metode /container (Manual)

Membuat Interface VETH

Agar container dapat terhubung dengan jaringan, kita perlu membuat virtual interface (VETH) khusus untuk Adguard-home.

/interface/veth/add name=veth-adguardhome address=172.17.0.2/16 gateway=172.17.0.1

172.17.0.2: IP Address yang dialokasikan untuk AdGuard Home. 172.17.0.1: IP Gateway (IP Router di interface bridge khusus container).

Masukan veth adguardhome ke Bridge

/interface/bridge/port/add bridge=bridge2-docker interface=veth-adguardhome

Tambahkan Mount

Mount ini penting supaya konfigurasi AdGuard Home tidak hilang saat container di-recreate. Folder conf menyimpan AdGuardHome.yaml, sedangkan work dipakai untuk data runtime.

2. Buat Folder & Mounts:

/container mounts
add list=adguardhome-conf src=disk1/container/adguardhome-conf dst=/opt/adguardhome/conf
add list=adguardhome-work src=disk1/container/adguardhome-work dst=/opt/adguardhome/work

Pull & Deploy Container

Sekarang pulling image AdGuard Home dari Docker Hub dan menjalankannya. Jalankan perintah ini untuk mengunduh dan membuat container:

/container
add name=adguardhome \
    remote-image=adguard/adguardhome:latest \
    interface=veth-adguardhome \
    root-dir=disk1/container/adguardhome \
    workdir=/opt/adguardhome/work \
    mountlists=adguardhome-conf,adguardhome-work \
    cmd="-c /opt/adguardhome/conf/AdGuardHome.yaml -w /opt/adguardhome/work" \
    logging=yes \
    start-on-boot=yes

Tunggu sampai statusnya berubah dari extracting menjadi stopped. Setelah itu, jalankan container:

/container start [find name=adguardhome]

Metode /app dengan YAML

Sekali lagi saya ingatkan sebelum memulai, pastikan Anda sudah menjalani Wizard /app pada dokumentasi -> [Cara Konfigurasi Container di MikroTik RouterOS v7] karena ini artikel lanjutan.

Kalau Mikrotik Anda pakai RouterOS 7.22++ dan ingin deployment yang lebih declarative, /app bisa jadi pilihan. MikroTik mengizinkan deployment custom app lewat YAML pada /app add yaml=..., dan diingat struktur YAML RouterOS berbeda dari docker-compose, termasuk field metadata seperti name, descr, category, services, configs, dan networks.

Contoh YAML AdGuard Home

Simpan YAML berikut sebagai referensi, lalu import lewat Winbox -> App -> klik [+] (Add New) -> tab YAML -> paste YAML ini ke dalam kotak YAML:

name: adguardhome
descr: AdGuard Home DNS filtering
page: https://adguard.com/en/adguard-home/overview.html
category: networking
default-credential: web setup

services:
  adguardhome:
    image: docker.io/adguard/adguardhome:latest
    ports:
      - 53:53/tcp:dns-tcp
      - 53:53/udp:dns-udp
      - 3000:3000:web
    environment:
      TZ: Asia/Jakarta
    volumes:
      - adguardhome-conf:/opt/adguardhome/conf
      - adguardhome-work:/opt/adguardhome/work
    command:
      - -c
      - /opt/adguardhome/conf/AdGuardHome.yaml
      - -w
      - /opt/adguardhome/work

Setup Wizard AdGuard Home

Setelah container berjalan, AdGuard belum aktif sepenuhnya. Anda perlu melakukan setup awal melalui browser.

1. Buka browser dan akses: http://172.17.0.2:3000
2. Klik Get Started.
3. Admin Web Interface: Set ke port 3000
4. DNS Server: Pastikan di set ke port 53.
5. Buat Username dan Password admin.

Integrasi Adguardhome ke Jaringan Mikrotik

Agar semua perangkat di rumah/kantor otomatis terfilter iklannya, kita perlu mengarahkan DNS router ke IP container AdGuardhome.

1. Masuk ke IP > DNS.
2. Set Servers ke IP Container: 172.17.0.2.
3. Centang Allow Remote Requests.

Pastikan perangkat user konfigurasi DNS nya ke router mikrotik.

Mengakses Dashboard

Sekarang Anda bisa mengakses dashboard AdGuard Home kapan saja melalui http://172.17.0.2:3000 konfigurasi adguardhome lebih lanjut atau untuk melihat statistik blokir iklan.

---

Tips Troubleshooting

• Error “Manifest not found”: Biasanya karena arsitektur image tidak sesuai. Pastikan Anda pull image yang sesuai dengan CPU router (arm/arm64). MikroTik biasanya otomatis mendeteksi ini.
• Container Stop Sendiri: Cek log dengan perintah /log print. Seringkali masalah permission pada folder disk1 atau RAM router penuh.

Dengan langkah ini, MikroTik Anda kini lebih powerfull, tidak hanya sebagai router tapi juga sebagai DNS Filtering.

Tags mikrotik-container