Cómo Configurar una Galería de Fotos Autogestionada Usando Raspberry Pi

El almacenamiento en la nube ofrece una forma conveniente de almacenar fotos, pero a menudo viene con limitaciones de espacio y privacidad. ¿Y si pudieras crear un espacio hermoso y seguro para tus fotos, completamente bajo tu control? ¡No busques más allá de tu confiable Raspberry Pi! En este artículo, te guiaremos a través de la configuración de una galería de fotos autogestionada usando PhotoPrism, una poderosa y amigable aplicación de galería de fotos.
Tabla de Contenidos
- ¿Qué es PhotoPrism?
- Lo que Necesitarás
- Cómo Instalar PhotoPrism en una Raspberry Pi
- Usando PhotoPrism en Raspberry Pi
¿Qué es PhotoPrism?
PhotoPrism es un software de gestión de fotos de código abierto que utiliza tecnología de IA para etiquetar y organizar tus fotos. Es una solución autogestionada que te permite mantener tus fotos y videos completamente bajo tu control.

Aquí hay algunas de sus características:
- PhotoPrism maneja fotos RAW, videos y formatos de imagen comunes como JPEG y PNG.
- Puedes usar potentes filtros de búsqueda para ayudarte a encontrar exactamente lo que estás buscando, ya sea una foto de tus vacaciones recientes o un miembro específico de la familia.
- Localiza automáticamente la ubicación de tus fotos en mapas mundiales de alta resolución.
- Deja que el reconocimiento facial y la clasificación automática de imágenes categoricen tus fotos según el contenido.
- Tus fotos se almacenan en tu dispositivo de almacenamiento local y nunca se suben a ningún servicio en la nube, a menos que tú decidas hacerlo.
Aún mejor, instalar PhotoPrism en tu Raspberry Pi es notablemente sencillo.
Lo que Necesitarás
Antes de comenzar a configurar tu galería de fotos autogestionada con PhotoPrism, necesitarás tener el equipo y software adecuados. Necesitarás una Raspberry Pi 4 o 5 con al menos 4 GB de RAM. Es importante que tu Raspberry Pi ejecute un sistema operativo de 64 bits para manejar las demandas de PhotoPrism de manera efectiva.
Para aquellos que aún no han instalado un sistema operativo en su Raspberry Pi, recomendamos consultar nuestra guía detallada sobre cómo configurar Raspberry Pi OS. Esto te guiará a través del proceso de instalación y preparará tu dispositivo para su uso.
Además de la Raspberry Pi en sí, necesitarás una solución de almacenamiento confiable para tu colección de fotos. En esta configuración, estaré usando un disco duro externo de 3.5”, que ofrece un amplio espacio y un rendimiento confiable para almacenar grandes bibliotecas de fotos. Sin embargo, no estás limitado a esta opción; una unidad flash USB más grande o un NAS local (almacenamiento conectado a la red) también podrían servir como soluciones de almacenamiento efectivas, dependiendo de tu preferencia y disponibilidad.
Nota: Aunque los desarrolladores de PhotoPrism proporcionan una imagen de tarjeta microSD específicamente diseñada para la Raspberry Pi, es importante señalar que esta imagen está actualmente desactualizada. Por lo tanto, no recomiendo usarla para esta configuración.
Cómo Instalar PhotoPrism en una Raspberry Pi
El primer paso para hacer que PhotoPrism funcione en tu Raspberry Pi es instalar Docker Compose, una herramienta diseñada para definir y ejecutar aplicaciones Docker de múltiples contenedores.
Para comenzar, necesitas agregar la clave GPG oficial de Docker y el repositorio a las fuentes de software de tu Raspberry Pi:
# Actualiza tus listas de paquetes
sudo apt-get update
# Instala paquetes para permitir que apt use un repositorio a través de HTTPS
sudo apt-get install ca-certificates curl
# Crea un directorio para el llavero de Docker
sudo install -m 0755 -d /etc/apt/keyrings
# Descarga la clave GPG oficial de Docker
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
# Agrega el repositorio de Docker
echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian \
$(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
# Actualiza tus listas de paquetes nuevamente después de agregar el repositorio de Docker
sudo apt-get updateUna vez agregado el repositorio de Docker, puedes proceder a instalar Docker junto con otros componentes esenciales, incluyendo Docker Compose:
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-pluginDespués de instalar Docker, debes agregar tu usuario al grupo de Docker para que puedas ejecutar comandos de Docker sin usar sudo:
sudo usermod -aG docker $USERFinalmente, verifica que Docker se haya instalado correctamente y que puedes ejecutar contenedores como un usuario normal:
docker run hello-world
Ahora que has instalado Docker Compose, es hora de instalar PhotoPrism en sí. El proceso es sencillo y consiste en descargar el archivo docker-compose.yml, hacer algunos cambios en él y ejecutar un comando para iniciar la aplicación y los servicios de base de datos.
Descarga el archivo docker-compose.yml a cualquier carpeta que prefieras usando el siguiente comando:
wget https://dl.photoprism.app/docker/docker-compose.ymlAbre el archivo en tu editor de texto preferido (puedes usar nano si estás accediendo a tu Raspberry Pi de forma remota a través de SSH) y cambia todas las contraseñas predeterminadas de marcador de posición (“inseguro”) por unas seguras, especialmente la PHOTOPRISM_ADMIN_PASSWORD.

Ajusta las rutas de montaje de volumenes para que apunten a las ubicaciones donde deseas almacenar tus fotos y los datos de PhotoPrism. Por ejemplo, si tienes un disco externo montado en, por ejemplo, /media/david/extdrive, podrías configurarlo de la siguiente manera:
services:
photoprism:
volumes:
- "/media/david/extdrive/Photos:/photoprism/originals"# Donde PhotoPrism almacenará archivos originales
- "/media/david/extdrive/PhotoPrismStorage:/photoprism/storage"# Usado para la caché, base de datos y archivos secundarios de PhotoPrism
mariadb:
volumes:
- "/media/david/extdrive/PhotoPrismDatabase:/var/lib/mysql"# Almacenamiento de base de datos para MariaDBCon tu archivo docker-compose.yml configurado, estás listo para lanzar PhotoPrism. Navega hacia el directorio que contiene tu archivo docker-compose.yml y ejecuta el siguiente comando:
docker compose up -d
Usando PhotoPrism en Raspberry Pi
Una vez que Docker y PhotoPrism estén en funcionamiento en tu Raspberry Pi, puedes comenzar a gestionar y ver tus fotos a través de la interfaz web de PhotoPrism. Abre tu navegador web preferido y navega a http://
En la pantalla de inicio de sesión, ingresa el nombre de usuario admin y la contraseña que configuraste para PHOTOPRISM_ADMIN_PASSWORD durante el proceso de configuración. Después de iniciar sesión, serás recibido por el panel de control de PhotoPrism.

Para empezar a agregar fotos a tu galería, haz clic en el botón de subir que se encuentra en la esquina superior derecha de la interfaz. Esto te permitirá seleccionar fotos de tu computadora y subirlas directamente a la biblioteca de PhotoPrism en tu Raspberry Pi.

Dado que probablemente tengas muchas fotos para subir, deberías configurar una carpeta de importación en tu Raspberry Pi. Para hacer eso, necesitas detener tus contenedores de PhotoPrism en ejecución para modificar el archivo docker-compose.yml:
docker compose stopAhora, edita tu archivo docker-compose.yml para incluir un montaje de volumen para una carpeta de importación:
services:
photoprism:
volumes:
- "/media/david/extdrive/Import:/photoprism/import"Esta carpeta actuará como un área de preparación para las fotos antes de importarlas a tu galería principal. Después de hacer estos cambios, guarda el archivo y reinicia PhotoPrism:
docker compose up -dAhora puedes mover fotos a el directorio de importación, navegar a Biblioteca -> Importar en la interfaz web de PhotoPrism, y comenzar el proceso de importación.

Para proteger tus valiosas fotos, es esencial hacer copias de seguridad regularmente del dispositivo de almacenamiento de PhotoPrism. De esta manera, puedes restaurar fácilmente en caso de problemas inesperados o fallas de hardware. ¡Disfruta explorando y personalizando tu nueva galería de fotos!
Capturas de pantalla por David Morelo. Imagen de portada por DALL-E.