domingo, 11 de enero de 2026

Pi-hole + OMV

    Antecedentes

    Estos son los pasos para el caso particular, instalar  Pi-hole como DNS para nuestra red local en nuestra Raspberry Pi 5 donde ya tenemos instalado OMV y tenemos compose, lo anterior refiere a la integración de OpenMediaVault (OMV), un sistema de almacenamiento en red (NAS), con Docker Compose, una herramienta para definir y ejecutar aplicaciones multicontenedor usando un archivo YAML, facilitado por un plugin específico en OMV que simplifica la gestión de servicios Docker, sus configuraciones y copias de seguridad, permitiendo instalar fácilmente aplicaciones como Plex o Nextcloud de manera organizada y

    Para instalar Pi-hole como un contenedor en OpenMediaVault (OMV), el método recomendado implica utilizando Docker y Portainer.

Prerrequisitos
  • OpenMediaVault instalado y funcionando.
  • El complemento OMV-Extras instalado.
  • Docker y Portainer instalados a través de OMV-Extras (esto es fácil de configurar).
  • Acceso a la interfaz web de OMV y potencialmente SSH para la configuración de la red. 
Guía paso a paso
1. Configurar el puerto de interfaz web OMV (opcional pero recomendado) 
Para evitar posibles conflictos con Pi-hole (que utiliza el puerto 80 de forma predeterminada para su interfaz web), se recomienda cambiar el puerto de la interfaz web OMV de antemano. 
  • Vaya a System > Workbench > Port* en la interfaz web de OMV.
  • Cambie el puerto de 80a otra cosa, como 8083.
  • Guarde los cambios y vuelva a iniciar sesión en el nuevo puerto.
2. Instalar Pihole desde interface OMV 

  • Vaya a Services > Compose > Files* en la interfaz web de OMV damos click en "+" y add from example, en la lista buscamos Pihole y elegimos add example compose file.


  • Editamos el archivo (opcional, muy recomendado) especificamos el puerto de administración web en este ejemplo lo mapeamos al 8082 para evitar conflictos con OMV y a futuro con aplicaciones que operen nativamente en el puerto 80, editamos TZ (zona horaria) Ejemplo para México: Si estás en la Ciudad de México, usarías:
    TZ="America/Mexico_City" y Webpassword
  • En este punto es necesario desactivar el servicio de resolución de nombres de red, con el comando sudo systemctl status systemd-resolved podemos verificar el estado actual del servicio systemd-resolved en sistemas Linux que usan systemd como gestor de servicios nativo de OpenMediaVault (OMV) el cual opera en el puerto 53 el mismo puerto que usa Pihole para operar, debemos desactivar este servicio previo al arranque de Pihole usamos sudo systemctl stop systemd-resolved  y sudo systemctl disable systemd-resolved
  • Editamos ahora resolv.conf as:

    #nano /etc/resolv.conf
    or
    #sudo nano /etc/resolv.conf

    Y editamos elname server a:

    # Generated by NetworkManager search home nameserver 127.0.0.1
    En este punto ya podemos iniciar el servicio pihole con exito, esto se comprueba desde la consola OMV compose



Para ingresar a Pi-hole, usa un navegador web y escribe la dirección IP de tu servidor Pi-hole seguida de /admin (ej. 192.168.1.100), luego ingresa el nombre de usuario y la contraseña que estableciste durante la instalación para acceder al panel de control. Si no la tienes, puedes obtener o cambiar la contraseña desde la consola de tu dispositivo (como una Raspberry Pi) ejecutando pihole -a -p



3. Cómo configurar una contraseña en un contenedor Docker de Pi-hole 

Puedes ejecutar comandos dentro de la imagen de Docker. El mismo problema: la variable webpassword no funciona.

correr

sudo docker ps -a

o

sudo docker container ls

Obtenga el ID del contenedor y luego ejecútelo

sudo docker exec -it "ContainerID" pihole setpassword



Pi-hole + OMV

     Antecedentes      Estos son los pasos para el caso particular, instalar   Pi-hole como DNS para nuestra red local en nuestra Raspberry ...