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



domingo, 4 de enero de 2026

RaspBerryPi5 + Open Media Vault + Dockers

Guía de instalación OMV 8

 Instalamos OMV (Open Media Vault ) ingresando GitHub podemos accesar al script para instalar openmediavault, omv-extras, y flashmemory.

OpenMediaVault-Plugin-Developers/installScript

No se admite la instalación de OMV en un entorno de escritorio.

Si usas el método wget el script es 

wget -O - https://github.com/OpenMediaVault-Plugin-Developers/installScript/raw/master/install | sudo bash https://github.com/OpenMediaVault-Plugin-Developers/installScript/raw/master/install

  • La omv-extrasextensión debe estar instalada primero. De lo contrario, siga las instrucciones del sitio web de OMV-Extras para instalarla mediante SSH. 
  • Puedes configurar OMV desde línea de comandos usando omv-firstaid
  1. Habilitar el repositorio de Docker
    • Inicie sesión en su interfaz web de OMV.
    • Vaya a Sistema > OMV-Extras .
    • Busque la sección Docker y haga clic en el botón Repositorio de Docker , luego haga clic en Guardar para activar el repositorio.
  2. Instalar el openmediavault-composecomplemento
    • Vaya a Sistema > Complementos .
    • Busque y resalte el openmediavault-composecomplemento (por ejemplo, openmediavault-compose 6.x7.x).
    • Haz clic en el botón Instalar . Esto instalará Docker Engine y el complemento Compose como dependencias.
  3. Configurar el almacenamiento de Docker
    • Una vez instalado el complemento, navegue a Servicios > Redactar > Configuración .
    • En el campo "Almacenamiento de Docker" , define la ruta absoluta de la carpeta compartida que quieras usar para los archivos internos de Docker (imágenes, etc.). Se recomienda usar una unidad dedicada, independiente de la unidad de tu sistema operativo OMV, para evitar problemas con el sistema de archivos raíz y la pérdida de datos durante la reinstalación, si has conectado una unidad nueva debes formatearla y crear el sistema de archivos en Almacenamiento > Sistemas de archivos, posteriormente ve a Almacenamiento > Carpetas compartidas y recomiendo las siguientes carpetas compartidas (El sistema de archivos en el que se creará la carpeta compartida debe ser el que has creado previamente)
      • Crear appdata
      • Crear compose
      • Crear appdata-backup
      • Crear docker
    • Ahora asiga las carpetas compartidas en Almacenamiento > Compose > Ajustes y edita la carpeta compartida de Configuración de Docker a la creada como docker/
    • Haga clic en Guardar y luego haga clic en el botón Reinstalar Docker si se le solicita que aplique los cambios de ruta. 

Uso de Docker Compose
Una vez instalado, el complemento proporciona una GUI para administrar sus archivos de Compose: 
  • Vaya a Servicios > Redactar > Archivos .
  • Haz clic en Crear para añadir un nuevo archivo YAML. Puedes pegar tu configuración de Docker Compose, asignarle un nombre y guardarla.
  • Seleccione el archivo recién creado y haga clic en el botón Arriba para implementar los contenedores definidos en el archivo. 

Pi-hole + OMV

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