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

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.xo 7.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. 

Configurar Raspberry Pi Connect

rpi-connectEl token de configuración, también conocido como clave de autenticación o clave de autorización , es un token temporal de un solo uso que se utiliza para vincular de forma segura un nuevo dispositivo Raspberry Pi a su cuenta de Raspberry Pi Connect.

Cómo obtener y usar el token
Puedes generar y utilizar este token de dos formas principales:
1. Usar Raspberry Pi Imager (el método más sencillo)
El método más sencillo es utilizar las funciones integradas del software Raspberry Pi Imager al configurar su sistema operativo. 
• En Imager, elija su dispositivo y sistema operativo (debe ser Raspberry Pi OS Bookworm de 64 bits o posterior).
• Vaya a las opciones de “Personalización” o “Configuración”.
• Vaya a la pestaña "Raspberry Pi Connect" y seleccione "Abrir Raspberry Pi Connect" .
• Inicie sesión en su cuenta de ID de Raspberry Pi en el navegador que se abre.
• En la página "Nueva clave de autorización", seleccione "Crear clave de autorización e iniciar Raspberry Pi Imager" .
• El generador de imágenes completará automáticamente el campo de token con la clave recién generada, que luego podrá escribir en su tarjeta SD. 
2. Manualmente a través de la línea de comandos
Si tienes una Raspberry Pi en funcionamiento, puedes vincularla desde la terminal: 
• Asegúrese de que su Raspberry Pi esté ejecutando el sistema operativo correcto y rpi-connectesté instalado.
• Abra una terminal en la Raspberry Pi y ejecute:
  Use

  rpi-connect signin

• Este comando proporcionará una URL de verificación única. Abra esta URL en un navegador web desde cualquier dispositivo.
• Inicie sesión con su ID de Raspberry Pi, nombre el dispositivo y se completará el proceso de vinculación.