[HOWTO] install PIHOLE on OMV using portainer WEBGUI on a MacVlan

# Note: 192.168.1.xxx is an example network, you must update all these to match your own.
# Thanks to http://tonylawrence.com/posts/unix/synology/free-your-synology-ports/ for your reference post
version: 2

services:
  pihole:
    container_name: pihole
    image: pihole/pihole:latest
    hostname: pihole
    domainname: yourdomain.org               # <-- Update or leave comment if you do not have
    mac_address: d0:ca:ab:cd:ef:05           # <-- Update ( must be a random MAC, because you create a virtual NIC for it)
    cap_add:
      - NET_ADMIN
    networks:
      macvlan_NET:                      # <-- MACVlan Name no need to change, but do not exist previosly.
        ipv4_address: 192.168.1.2       # <-- Update; must be the IP that you want to use as DNS sever ( pihole IP)
    ports:
      - 443/tcp
      - 53/tcp
      - 53/udp
      - 67/udp
      - 80/tcp
    environment:
      ServerIP: 192.168.1.9             # <-- Update (match ipv4_address)
      VIRTUAL_HOST: pihole.yourdomain.org    # <-- Update (match hostname + domainname)
      WEBPASSWORD: "MyPassWord"         # <-- Add password (if required)
      DNS1: 8.8.8.8
      DNS2: 8.8.4.4                     # <-- Change by your prefered DNS service like 1.1.1.1
      TZ: Europe/Madrid                 # <-- You need to add in webGUI not here
      # IPv6: False                     # <-- You need to add in webGUI not here
    volumes:
      - /home/dockers/pihole:/etc/pihole  # <-- Update to match your real path ; your_nas_path:/etc/pihole
      - /home/dockers/pihole/dnsmasq.d:/etc/dnsmasq.d # same here
    restart: unless-stopped

networks:
  macvlan_NET:
    driver: macvlan
    driver_opts:
      parent: enp5s0                        # <- Update to match your NIC see your OMV WebGUI
    ipam:
      config:
        - subnet: 192.168.1.0/24            # <-- Update
          gateway: 192.168.1.1              # <-- Update
          ip_range: 192.168.1.2/28          # <-- Update

# Note: 192.168.1.xxx is an example network, you must update all these to match your own.
# Thanks to http://tonylawrence.com/posts/unix/synology/free-your-synology-ports/ for your reference post
# More info at https://github.com/pi-hole/docker-pi-hole/ and https://docs.pi-hole.net/
# version: "3"  Version is obsolete on latest compose
services:
  pihole:
    container_name: pihole
    image: pihole/pihole:latest
    hostname: pihole
    domainname: $URL                    # <-- Update on enviromen.env file
    networks:
      MyMacVlan:                        # <-- MACVlan Name You need to create first in Portainer WebGUI.
        ipv4_address: 192.168.1.2       # <-- Update to your desired Pihole IPv4
# https://www.youtube.com/watch?v=4741-YR31fM
# https://www.youtube.com/watch?v=o7nn6Tv-PAw
    cap_add:
      - NET_ADMIN # Recommended but not required (DHCP needs NET_ADMIN)  
    ports: 
      - "53:53/tcp"
      - "53:53/udp"
      - "67:67/udp" # Only required if you are using Pi-hole as your DHCP server
      - "80:80/tcp"
    environment:
      ADMIN_EMAIL: $email
      FTLCONF_LOCAL_IPV4: 192.168.1.2   # <-- Update (match ipv4_address of PiHole)
      VIRTUAL_HOST: pihole.$URL    # <-- Update (match hostname + domainname)
      WEBPASSWORD: $Password2           # <-- Add password (if required)
      PIHOLE_DNS_: 8.8.8.8;8.8.4.4      # <-- Change by your prefered DNS service like 1.1.1.1
      TZ: $TZ                 # <-- Your Time Zone here
      IPv6: "false"
# Volumes store your data between container upgrades
    volumes:
      - '$ConfigPath/pihole:/etc/pihole'
      - '$ConfigPath/pihole/dnsmasq.d:/etc/dnsmasq.d'    
#   https://github.com/pi-hole/docker-pi-hole#note-on-capabilities
    restart: unless-stopped

networks:
  MyMacVlan:
    external: true