Cómo: OpenMediaVault: instale PhotoPrism a través de Docker en Raspberry Pi

PhotoPrism es un software muy bueno que puede usar para administrar su colección de fotos localmente.

Una vez configuradas, sus fotos se escanearán y clasificarán utilizando modelos de IA. Eso significa que no solo puede mirar las imágenes ordenadas por persona (gracias al reconocimiento facial). También es posible mostrar todas las fotos de la playa, todas las fotos que muestren autos, animales o incluso sombrillas.

Debido a que todas las fotos y los datos de usuario permanecen en su propio disco duro, no tiene que preocuparse por las preocupaciones habituales como la protección de datos o la nube.

Lo que personalmente encuentro muy útil es que PhotoPrism también se puede operar en modo de solo lectura. Si este modo está activado, PhotoPrism solo lee sus fotos. Esto asegura que ninguna foto se pueda cambiar o eliminar a través de la interfaz de PhotoPrism. Si desea lo último, por supuesto puede desactivar la protección contra escritura. Entonces las fotos no solo se pueden eliminar y editar. También es posible cargar nuevas fotos a través de la interfaz o WebDAV.

Si desea probar una demostración en vivo por adelantado. Los desarrolladores proporcionan una demostración en el siguiente enlace.

• Demostración en vivo de PhotoPrism: https://demo.photoprism.app/library/browse

A la izquierda puede ver la vista típica de la interfaz de PhotoPrism.

Gracias a la imagen Docker preparada, la instalación en RaspberryPi es rápida y segura. Aquí solo hay un pequeño inconveniente: PhotoPrism solo se ejecuta en un sistema operativo de 64 bits. Es posible que deba instalar un sistema operativo RaspberryPi de 64 bits en la tarjeta SD de su RaspberryPi.

Tan pronto como hayas hecho eso, puedes comenzar. He descrito todo lo que necesitas saber paso a paso en este artículo.

Instrucciones de seguridad

Sé que las siguientes notas siempre son un poco molestas y parecen innecesarias. Desafortunadamente, muchas personas que sabían "mejor" han perdido ojos, dedos u otras cosas debido a un descuido o se lesionaron. La pérdida de datos es casi insignificante en comparación, pero incluso estos pueden ser realmente molestos. Por lo tanto, tómese cinco minutos para leer las instrucciones de seguridad. Porque incluso el proyecto más genial no vale la pena lesionarse u otros problemas.
https://www.nerdiy.de/sicherheitshinweise/

Enlaces afiliados / enlaces publicitarios

Los enlaces a las tiendas en línea enumerados aquí son los llamados enlaces de afiliados. Si hace clic en dicho enlace de afiliado y realiza una compra a través de este enlace, Nerdiy.de recibirá una comisión de la tienda en línea o el proveedor correspondiente. El precio no cambia para usted. Si realiza sus compras a través de estos enlaces, ayuda a Nerdiy.de a poder ofrecer otros proyectos útiles en el futuro. 🙂 

Requisitos

Antes de comenzar con este artículo, debe haber preparado la Raspberry Pi para que se pueda acceder a ella a través de la red y controlarla a través de SSH.

Los siguientes artículos describen lo que se debe hacer para preparar su Raspberry Pi:

• RaspberryPi: ¡configuración para nerdiys!
• RaspberryPi – ¡La primera configuración!
• RaspberryPi: controle el RaspberryPi a través de SSH
• Raspberry Pi: construya NetworkAttachedStorage / NAS con un Raspberry Pi 4 usted mismo
• RaspberryPi: cree NetworkAttachedStorage / NAS desde una RaspberryPi 4 usted mismo
• RaspberryPi: instale OpenMediaVault / OMV en RaspberryPi

En las siguientes listas encontrará todas las piezas que necesita para implementar este artículo.

Herramienta requerida:

Material requerido:

Instalar ventana acoplable

PhotoPrism se instala como una imagen de Docker. Para esto, Docker y Portainer ya deben estar instalados.

Si aún no ha instalado estas dos herramientas: En el artículo Raspberry Pi: uso de contenedores Docker con OpenMediaVault OMV y Portainer He descrito la instalación.

Crear usuario del sistema OMV para ejecutar PhotoPrism

Para ejecutar PhotoPrism debe crear un usuario.

Por un lado, tengo cómo lo haces en el artículo. OpenMediaVault - Crear otro usuario descrito. Por otro lado, también se vuelve a mostrar en los siguientes pasos.

Para ello, haga clic en la sección

• Usuarios

en la entrada

• Usuarios

Luego haga clic en el símbolo más azul que se muestra y luego haga clic en "Crear".

Puede ingresar toda la información del usuario en el formulario que aparece.

En la mayoría de los casos es suficiente asignar un nombre de usuario y una contraseña. Por supuesto, también puede configurar otros ajustes (por ejemplo, pertenencia a un grupo) aquí.

Solo tengo el usuario aquí.

• fotoprisma_bot

creado.

Luego haga clic en "Guardar" para aplicar la configuración.

Ahora puede aplicar el cambio a la configuración haciendo clic en la marca de verificación que se muestra en la barra amarilla superior y luego confirmándolo haciendo clic en "Sí".

Descubra el ID de usuario del sistema

Posteriormente, durante la configuración de la imagen de Docker, necesitará, entre otras cosas, el ID de usuario del usuario creado anteriormente. Puede acceder a esto a través del acceso SSH a su Raspberry Pi (o cualquier otra máquina Linux).

El ID de usuario del usuario

• fotoprisma_bot

luego puede recuperarlo con el siguiente comando:

• id fotoprisma_bot

Luego escriba el valor de "uid". (En este ejemplo “1003”)

Crear carpetas para almacenar los archivos de PhotoPrism

Varios datos de usuario, como bases de datos o miniaturas, se generan durante el funcionamiento de PhotoPrism. Para que no se pierdan incluso después de un reinicio, ahora debe crear una carpeta para ellos en el disco duro conectado a su OMV.

ir a la categoría

• carpetas compartidas

Ahora haga clic en el símbolo más para crear un nuevo recurso compartido.

A continuación, será redirigido al formulario que se muestra.

Aquí puede dar un nombre a la versión, seleccionar en qué partición integrada debe crearse y también especificar los derechos de acceso.

Elegí "photoprism_files" como nombre. Por supuesto, también puedes nombrar la carpeta con otro nombre.

Una vez que haya configurado todo como desee, puede aceptar la configuración haciendo clic en "Guardar".

Luego, debe confirmar la configuración modificada nuevamente haciendo clic en la marca de verificación en el área amarilla y...

... esto confirmado de nuevo.

A continuación debe configurar los derechos de usuario para esta carpeta. Para hacer esto, marque la entrada de la carpeta que creó y haga clic en “Privilegiado”.

En la lista que se muestra a continuación, busque el usuario creado anteriormente (aquí “photoprism_bot”) y active los derechos de lectura y escritura (“Lectura/Escritura”).

Luego haga clic en “Guardar” para guardar los cambios.

Ahora repita lo mismo nuevamente para la configuración de ACL.

Marque la carpeta y haga clic en el icono "ACL" que se muestra.

Habilite el acceso de lectura y escritura aquí nuevamente.

Y establece las configuraciones restantes como se muestra.

Luego haga clic en "Guardar" nuevamente para aplicar los cambios.

Luego, debe confirmar la configuración modificada nuevamente haciendo clic en la marca de verificación en el área amarilla y...

... esto confirmado de nuevo.

En este punto, también debe copiar la ruta absoluta a la carpeta que acaba de crear. Lo necesitará más tarde para agregarlo al archivo de configuración de Docker Compose

Configure la configuración de PhotoPrism Docker Compose usando Portainer

Una vez que haya preparado todas las carpetas, ahora puede configurar PhotoPrism Docker Image utilizando la configuración de Docker Compose.

Para hacer esto, abra la interfaz de su instancia de Portainer y haga clic en el botón "loal" que se muestra.

Luego haga clic en "Pilas"

Y luego haga clic en el botón "+ Agregar pila".

Lo primero que debe hacer en la descripción general de "Crear pila" es darle un nombre. Por ejemplo

• fotoprisma

Ahora es el momento de adaptar la configuración de Docker Compose a tus necesidades. Para hacer esto, primero copie el texto completo a continuación y péguelo en el campo de texto grande de la interfaz "Crear pila".

En los siguientes pasos, se ajustan los puntos importantes.

versión: '3.5' # Ejemplo de archivo de configuración de Docker Compose para PhotoPrism (Raspberry Pi 3/4 y otros dispositivos basados en ARM64) # # Nota: #: debe iniciar su Raspberry Pi 3/4 con el parámetro "arm_64bit=1" en config.txt para usar nuestra imagen ARM64 (64 bits). # De lo contrario, se producirá un error de "formato exec". #: intente extraer explícitamente la versión ARM64 si ha iniciado su dispositivo con el indicador "arm_64bit = 1" y ve # el error "no hay coincidencia de manifiesto" en el sistema operativo Raspberry Pi (Raspbian). Consulte la documentación para obtener más información. #: utilice https://dl.photoprism.app/docker/armv7/docker-compose.yml para ejecutar PhotoPrism y MariaDB en dispositivos basados en ARMv7 #, así como en instalaciones de Raspberry Pi OS (Raspbian) sin compatibilidad con 64 bits. #: la transcodificación de hardware solo está disponible para los patrocinadores debido al alto esfuerzo de mantenimiento y soporte. #: ejecutar PhotoPrism en un servidor con menos de 4 GB de espacio de intercambio o establecer un límite de memoria/intercambio puede causar reinicios inesperados de # ("bloqueos"), por ejemplo, cuando el indexador necesita temporalmente más memoria para procesar archivos grandes. #: en caso de que vea errores de Docker relacionados con "cgroups", intente agregar los siguientes parámetros a /boot/firmware/cmdline.txt # o /boot/cmdline.txt (la ubicación del archivo depende del sistema operativo en uso): cgroup_enable=cpuset cgroup_enable=memory cgroup_memory=1 #: si instala PhotoPrism en un servidor público fuera de su red doméstica, ejecútelo siempre detrás de un proxy inverso seguro # HTTPS, como Traefik o Caddy. De lo contrario, sus archivos y contraseñas se transmitirán # en texto sin cifrar y cualquiera puede interceptarlos, incluidos su proveedor, piratas informáticos y gobiernos: # https://docs.photoprism.app/getting-started/proxies/traefik/ # # Configuración Guías: # - https://docs.photoprism.app/getting-started/docker-compose/ # - https://docs.photoprism.app/getting-started/raspberry-pi/ # # Listas de verificación de solución de problemas: # - https https://docs.photoprism.app/getting-started/troubleshooting/ # - https://docs.photoprism.app/getting-started/troubleshooting/docker/ # - https://docs.photoprism.app/getting- iniciado /solución de problemas/mariadb/ # # Comandos CLI: # - https://docs.photoprism.app/getting-started/docker-compose/#command-line-interface # # Es posible que todos los comandos deban tener el prefijo "sudo" cuando no se ejecuta como root. # Esto apuntará el acceso directo del directorio de inicio ~ a /root en los montajes de volumen. servicios: photoprism: ## Use photoprism/photoprism:preview-arm64 para probar compilaciones de vista previa: image: photoprism/photoprism:arm64 depende de: - mariadb ## ¡No habilite los reinicios automáticos hasta que PhotoPrism se haya configurado y probado correctamente! ## Si el servicio se atasca en un ciclo de reinicio, esto indica un problema de memoria, sistema de archivos, red o base de datos: ## https://docs.photoprism.app/getting-started/troubleshooting/#fatal-server-errors # restart: a menos que se detenga security_opt: - seccomp:unconfined - apparmor:unconfined puertos: - "2342:2342" Puerto HTTP # (host:contenedor) entorno: PHOTOPRISM_ADMIN_USER: "!ENTER_USERNAME_HERE!" # nombre de usuario de superadministrador PHOTOPRISM_ADMIN_PASSWORD: "!ENTER_PASSWORD_HERE!" # contraseña de superadministrador inicial (mínimo 8 caracteres) PHOTOPRISM_AUTH_MODE: "contraseña" # modo de autenticación (público, contraseña) PHOTOPRISM_SITE_URL: "http://!ENTER_HOSTNAME_OR_IP_HERE!:2342/" URL del servidor # en el formato "http(s):// domain.name(:port)/(path)" PHOTOPRISM_ORIGINALS_LIMIT: 50000 # límite de tamaño de archivo para originales en MB (aumento para video de alta resolución) PHOTOPRISM_HTTP_COMPRESSION: "gzip" # mejora la velocidad de transferencia y la utilización del ancho de banda (ninguno o gzip) PHOTOPRISM_WORKERS: 2 # limita el número de trabajadores de indexación para reducir la carga del sistema PHOTOPRISM_LOG_LEVEL: "info" # nivel de registro: rastreo, depuración, información, advertencia, error, fatal o pánico PHOTOPRISM_READONLY: "true" # no modifica el directorio original (funcionalidad reducida) PHOTOPRISM_EXPERIMENTAL: "falso" # activa funciones experimentales PHOTOPRISM_DISABLE_CHOWN: "falso" # desactiva la actualización de permisos de almacenamiento mediante chmod y chown al inicio PHOTOPRISM_DISABLE_WEBDAV: "falso" # desactiva WebD integrado Servidor AV PHOTOPRISM_DISABLE_SETTINGS: "falso" # deshabilita la configuración en la interfaz de usuario web PHOTOPRISM_DISABLE_TENSORFLOW: "falso" # deshabilita todas las funciones según TensorFlow PHOTOPRISM_DISABLE_FACES: "falso" # deshabilita la detección y el reconocimiento de rostros (requiere TensorFlow) PHOTOPRISM_DISABLE_CLASSIFICATION: "falso" # deshabilita la clasificación de imágenes ( requiere TensorFlow) PHOTOPRISM_DISABLE_RAW: "falso" # deshabilita la indexación y conversión de archivos RAW PHOTOPRISM_RAW_PRESETS: "falso" # permite aplicar ajustes preestablecidos del usuario al convertir archivos RAW (reduce el rendimiento) PHOTOPRISM_JPEG_QUALITY: 85 # un valor más alto aumenta la calidad y el tamaño de archivo de las imágenes JPEG y miniaturas (25-100) PHOTOPRISM_DETECT_NSFW: "falso" # marca automáticamente las fotos como privadas que PUEDEN ser ofensivas (requiere TensorFlow) PHOTOPRISM_UPLOAD_NSFW: "verdadero" # permite cargas que PUEDEN ser ofensivas # PHOTOPRISM_DATABASE_DRIVER: "sqlite" # SQLite es una base de datos integrada eso no requiere un servicio r PHOTOPRISM_DATABASE_DRIVER: "mysql" # use MariaDB 10.5+ o MySQL 8+ en lugar de SQLite para mejorar el rendimiento PHOTOPRISM_DATABASE_SERVER: "mariadb:3306" # Servidor de base de datos MariaDB o MySQL (nombre de host:puerto) PHOTOPRISM_DATABASE_NAME: "photoprism" # Esquema de base de datos MariaDB o MySQL nombre PHOTOPRISM_DATABASE_USER: "photoprism" # Nombre de usuario de la base de datos MariaDB o MySQL PHOTOPRISM_DATABASE_PASSWORD: "inseguro" # Contraseña de usuario de la base de datos MariaDB o MySQL PHOTOPRISM_SITE_CAPTION: "Aplicación de fotos con tecnología de IA" PHOTOPRISM_SITE_DESCRIPTION: "" # meta descripción del sitio PHOTOPRISM_SITE_AUTHOR: "" meta autor 1 ## Ejecutar/instalar en el primer inicio (opciones: actualizar, gpu, tensorflow, davfs, limpiar): #PHOTOPRISM_INIT: "update clean" ## Transcodificación de video por hardware: # PHOTOPRISM_FFMPEG_ENCODER: "frambuesa" # Codificador FFmpeg ("software", "intel", "nvidia", "apple", "frambuesa") # PHOTOPRISM_FFMPEG_BITRATE: "32" Límite de tasa de bits de codificación # FFmpeg en Mbit/s (predeterminado ult: 50) ## Ejecutar como usuario no raíz después de la inicialización (admitido: 0, 33, 50-99, 500-600 y 900-1200): PHOTOPRISM_UID: 10XX PHOTOPRISM_GID: 100 # PHOTOPRISM_UMASK: 0000 ## Compartir dispositivos de hardware con FFmpeg y TensorFlow (opcional): ## Consulte: https://www.raspberrypi.com/documentation/accessories/camera.html#driver-differences-when-using-libcamera-or-the-legacy-stack # devices: # - "/ dev/video11:/dev/video11" # Dispositivo de codificación de video Video4Linux (h264_v4l2m2m) working_dir: "/photoprism" # no cambie ni elimine ## Carpetas de almacenamiento: "~" es un atajo para su directorio de inicio, "." para los volúmenes de directorio actuales: # "/host/carpeta:/photoprism/carpeta" # Ejemplo - "!real_photoLocationFolder1_path!:/photoprism/originals/photoLocation1" # Archivos multimedia originales (NO ELIMINAR) - "!real_photoLocationFolder2_path!:/photoprism /originals/photoLocation2" # Archivos multimedia originales (NO ELIMINAR) - "!real_photoLocationFolderX_path!:/photoprism/originals/photoLocationX" # Archivos multimedia originales (NO ELIMINAR) # - "/example/family:/photoprism/originals/family " # *Se pueden montar carpetas multimedia *adicionales* como esta # - "~/Import:/photoprism/import" # *Opcional* carpeta base desde la que se pueden importar archivos a los originales - "!real_photoprism_folder_path!/storage:/photoprism/storage " # Carpeta de almacenamiento *escribible* para archivos de caché, base de datos y sidecar (NO ELIMINAR) ## Servidor de base de datos (recomendado) ## consulte https://docs.photoprism.app/getting-started/faq/#should-i-use- sqlite-mariadb-or-mysql mariadb: ## Si MariaDB obtiene stu ck en un ciclo de reinicio, esto apunta a un problema de memoria o sistema de archivos: ## https://docs.photoprism.app/getting-started/troubleshooting/#fatal-server-errors restart: a menos que se detenga la imagen: arm64v8/mariadb:10.10 # ARM64 SOLO IMAGEN, NO FUNCIONA EN ARMv7, AMD o Intel security_opt: - seccomp:unconfined - apparmor:unconfined command: mysqld --innodb-buffer-pool-size=256M --transaction-isolation=READ-COMMITTED --character - set-server=utf8mb4 --collation-server=utf8mb4_unicode_ci --max-connections=512 --innodb-rollback-on-timeout=OFF --innodb-lock-wait-timeout=120 ## Nunca almacene archivos de base de datos en un lugar no confiable dispositivo como una unidad flash USB, una tarjeta SD o una carpeta de red compartida: volúmenes: - "!real_photoprism_folder_path!/database:/var/lib/mysql" # NO ELIMINAR entorno: MARIADB_AUTO_UPGRADE: "1" MARIADB_INITDB_SKIP_TZINFO: "1 " MARIADB_DATABASE: "fotoprisma" MARIADB_USER: "fotoprisma" MARIADB_PASSWORD: "inseguro" MARIADB_ROOT_PASSWORD: "inseguro" ## Watcht ower actualiza los servicios automáticamente (opcional) ## consulte https://docs.photoprism.app/getting-started/updates/#watchtower # # torre de vigilancia: # reiniciar: a menos que se detenga # imagen: containerrr/watchtower # entorno: # WATCHTOWER_CLEANUP: "true " # WATCHTOWER_POLL_INTERVAL: 7200 # busca actualizaciones cada dos horas # volúmenes: # - "/var/run/docker.sock:/var/run/docker.sock" # - "~/.docker/config.json:/config .json" # opcional, para autenticación si tiene una cuenta de Docker Hub

Primero debe ingresar un nombre de usuario y contraseña en las áreas marcadas en rojo. Esto será necesario más adelante para poder iniciar sesión en la interfaz web de PhotoPrism.

También debe ingresar el nombre de host o la dirección IP de su servidor OMV.

Como referencia, en mi servidor de prueba, el archivo se ve como se muestra. (Por supuesto, debe usar una contraseña mucho más complicada aquí).

También ajuste el valor de "PHOTOPRISM_UID" para que coincida con el valor de la identificación del usuario creado anteriormente (en este ejemplo, "1003").

Luego tienes que ajustar dos rutas de carpeta. Por un lado, el valor de “!real_photoLocationFolderX_path!” y para "!real_photoprism_folder_path!"

Para "!real_photoprism_folder_path!" debe utilizar la ruta de la carpeta creada previamente para los datos del usuario.

Para "!real_photoLocationFolderX_path!" tienes que ingresar la ruta a tu colección de fotos. Por ejemplo, si su colección de fotografías se encuentra en “/home/pi/pictures”, utilice exactamente esta ruta aquí. También puede especificar varias rutas aquí. Luego asegúrese de ajustar la “ubicación de foto1…X” en consecuencia.

Como referencia: en mi servidor de prueba, la parte del archivo de configuración se ve como se muestra.

Para "!real_photoprism_folder_path!" Luego debes ingresar la ruta de la carpeta creada previamente para los datos del usuario un poco más abajo.

Como referencia: en mi servidor de prueba, la parte del archivo de configuración se ve como se muestra.

Debe usar la parte que se muestra más adelante...

… cambiar como se muestra.

Esto hace que el contenedor de PhotoPrism se inicie automáticamente tan pronto como se inicie el servidor. ¡Los desarrolladores de PhotoPrism recomiendan expresamente hacer esto solo cuando PhotoPrism se ejecuta de manera estable!

Una vez que hayas configurado todo como desees, puedes activar la configuración haciendo clic en “Implementar la pila”.

Puede comprobar si PhotoPrism se iniciará haciendo clic en la entrada que se muestra...

... y comprobó el estado de los dos contenedores.

Aquí ambos deberían tener el estado "en ejecución".

En la segunda columna también puede ver el puerto a través del cual se puede acceder a la interfaz web de PhotoPrism.

Inicie sesión en la interfaz de PhotoPrism y comience a indexar las imágenes

Después de iniciar el contenedor Docker, ahora puede abrir la interfaz web de PhotoPrism y comenzar a indexar las imágenes. La indexación es importante para escanear y, si es necesario, categorizar las imágenes. Según el tamaño de su colección de fotos, este proceso puede llevar mucho tiempo (por ejemplo, varios días).

Para abrir la interfaz de PhotoPrism, simplemente ingrese la dirección IP de su servidor OMV seguido del puerto configurado.

Si la dirección IP de su servidor OMV es “192.168.0.3” y ha utilizado el puerto (2342) preconfigurado anteriormente, debe ingresar “192.168.0.3:2342” en la línea de dirección de su navegador para abrir la interfaz de PhotoPrism.

Después de abrir la interfaz de PhotoPrism, verá la vista que se muestra.

Introduzca aquí los datos de acceso previamente configurados para verificarse.

Dado que no se ha realizado ninguna indexación antes, ahora no se mostrará ninguna imagen.

Entonces haga clic en “Biblioteca”…

... para llegar a la vista que se muestra.

Aquí debe marcar "Reescaneo completo" y luego hacer clic en "Iniciar".

Esto comenzará a indexar su colección de fotos.

También puede monitorear el progreso de la indexación en la pestaña "Registros" en la misma página.

El proceso de indexación ahora toma un tiempo dependiendo del tamaño de la colección de fotos.

Mientras tanto, puedes ver las primeras fotos indexadas en el área “Buscar”.

Más artículos relacionados con OpenMediaVault

He descrito las muchas otras funciones de OpenMediaVault en otros artículos. Todos estos artículos están agrupados en la siguiente categoría.

• https://nerdiy.de/category/raspberry-pi/open-media-vault/

Diviértete con el proyecto.

Espero que todo te haya funcionado como se describe. Si no es así, o si tiene alguna pregunta o sugerencia, hágamelo saber en los comentarios. Si es necesario, lo añadiré al artículo.
Las ideas para nuevos proyectos siempre son bienvenidas. 🙂

PS Muchos de estos proyectos, especialmente los proyectos de hardware, cuestan mucho tiempo y dinero. Por supuesto que hago esto porque lo disfruto, pero si crees que es genial que comparta la información contigo, me encantaría hacer una pequeña donación al fondo del café. 🙂