Cómo usar PhotoPrism como galería privada con IA en local

¿Cómo usar PhotoPrism como galería privada con IA en local? Tener tu fototeca bajo control, sin depender de la nube pública, ya no es un sueño: con PhotoPrism puedes montar una galería privada con inteligencia artificial en tu propio equipo o servidor y navegar por años de recuerdos sin ceder tu privacidad. Aquí te cuento, con todo detalle y de forma práctica, cómo funciona, qué necesitas y cómo ponerlo en marcha en local con Docker.

Para muchos, Google Fotos es comodísimo, pero a cambio de esa comodidad hay dudas razonables sobre el uso de los datos. Si te inquieta la privacidad o debes cumplir normativa como el RGPD en contextos profesionales, PhotoPrism es una alternativa potente: organización automática, etiquetas con IA, búsqueda avanzada y un flujo de trabajo pensado para colecciones grandes, todo en tu infraestructura.

Qué es PhotoPrism y por qué usarlo en local

PhotoPrism es una aplicación web de gestión fotográfica con IA (apoya su clasificación en Google TensorFlow) que reconoce personas, objetos, colores y escenas para etiquetar y ordenar tu biblioteca. Nace como solución autoalojada para que tengas tus fotos y vídeos en casa o en tu propio servidor, preservando la privacidad y sin renunciar a funciones modernas.

En su ADN hay varias claves: compatibilidad con formatos RAW y clásicos como JPEG o PNG; indexación inteligente con detección de duplicados; navegación por línea temporal, lugares y etiquetas; y un buscador que permite combinar filtros por cámara, color, fecha, país, e incluso marcar elementos como favoritos. Todo corre en tu máquina, con cachés locales y sin depender de terceros para el análisis.

La interfaz es una PWA, así que se instala en la pantalla de inicio de ordenadores y móviles. Funciona especialmente bien en Chrome, Chromium, Safari, Firefox y Edge. Ten en cuenta que la reproducción de ciertos códecs de vídeo y audio (por ejemplo, AAC en H.264) puede variar por navegador, algo normal en la web moderna.

Otro punto diferencial es su integración con WebDAV y servicios externos: puedes sincronizar desde móviles con apps como PhotoSync, y también exponer la galería con enlaces protegidos por contraseña y caducidad. Además, si quieres mapas y datos de lugares, PhotoPrism emplea un servicio de geocodificación inversa y mapas de alta privacidad respaldado por MapTiler; estos recursos están pensados para minimizar la exposición y mejorar el rendimiento con caché. Para poder seguir aprendiendo te dejamos esta guía sobre cómo organizar tus fotos con IA sin nube: PhotoPrism y alternativas locales.

Requisitos, hardware y rendimiento

Para un uso fluido en local se recomiendan al menos 2 núcleos de CPU, 3 GB de RAM y un sistema de 64 bits. Más allá del mínimo, conviene igualar la RAM al número de núcleos y, para bibliotecas grandes, usar SSD local para base de datos y cachés. El indexado es intensivo; con SSD y buen intercambio mejora una barbaridad.

Si tu servidor tiene menos de 4 GB de swap, o le marcas límites de memoria/intercambio muy agresivos, podrías tener reinicios inesperados cuando el indexador necesite más recursos (en RAW pesados, panorámicas 360 o vídeos 4K esto es habitual). Activa o amplía el swap y paciencia: con muchas fotos, el primer indexado puede tardar días.

En cuanto a base de datos, PhotoPrism soporta SQLite 3 y MariaDB 10.5.12 en adelante. SQLite es sencillo para empezar, pero si buscas rendimiento y escalabilidad, mejor MariaDB. El soporte para MySQL 8 se ha dejado de lado por baja demanda y falta de funciones frente a MariaDB. Truco importante: evita usar la etiqueta latest de la imagen de MariaDB; fija versiones estables que ya se hayan probado bien.

Sobre plataformas, la app se despliega donde haya Docker: Linux, macOS y Windows con Docker Desktop, además de FreeBSD, Raspberry Pi y muchos NAS. Incluso existen opciones en la nube mediante PikaPods o DigitalOcean, aunque aquí nos centraremos en local por privacidad y control.

Instalación con Docker paso a paso

Si nunca has usado Docker, no te preocupes: el despliegue con docker compose es directo. El archivo YAML puede vivir en la carpeta que prefieras; por orden, crea un directorio para PhotoPrism y dentro guarda el fichero docker-compose.yml. Lo importante es definir bien los volúmenes para originales, almacenamiento y, si quieres, importación.

Estos son los tres montajes típicos: originals (solo lectura o lectura/escritura), storage (caché, DB y sidecars) e import (opcional). Puedes apuntar originals a la carpeta donde ya tengas tus fotos. Mi recomendación: mantén storage separado de tus fotos, así no mezclas base de datos y caché con tus originales.

Ejemplo básico de docker-compose con MariaDB y PhotoPrism (puedes adaptarlo a tu entorno):

version: '3.5'
services:
  mariadb:
    image: 'mariadb:11'
    restart: unless-stopped
    security_opt:
      - 'seccomp:unconfined'
      - 'apparmor:unconfined'
    command: >-
      --innodb-buffer-pool-size=512M
      --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
    environment:
      MARIADB_AUTO_UPGRADE: '1'
      MARIADB_INITDB_SKIP_TZINFO: '1'
      MARIADB_DATABASE: 'photoprism'
      MARIADB_USER: 'photoprism'
      MARIADB_PASSWORD: 'cambia-esto'
      MARIADB_ROOT_PASSWORD: 'cambia-esto'
    volumes:
      - './database:/var/lib/mysql'

  photoprism:
    image: 'photoprism/photoprism:latest'
    depends_on:
      - mariadb
    stop_grace_period: 10s
    security_opt:
      - 'seccomp:unconfined'
      - 'apparmor:unconfined'
    ports:
      - '2342:2342'
    environment:
      PHOTOPRISM_ADMIN_USER: 'admin'
      PHOTOPRISM_ADMIN_PASSWORD: 'cambia-esto'
      PHOTOPRISM_AUTH_MODE: 'password'
      PHOTOPRISM_SITE_URL: 'http://localhost:2342/'
      PHOTOPRISM_DEFAULT_TLS: 'true'
      PHOTOPRISM_DATABASE_DRIVER: 'mysql'
      PHOTOPRISM_DATABASE_SERVER: 'mariadb:3306'
      PHOTOPRISM_DATABASE_NAME: 'photoprism'
      PHOTOPRISM_DATABASE_USER: 'photoprism'
      PHOTOPRISM_DATABASE_PASSWORD: 'cambia-esto'
      PHOTOPRISM_ORIGINALS_LIMIT: 5000
      PHOTOPRISM_JPEG_QUALITY: 85
      PHOTOPRISM_DISABLE_WEBDAV: 'false'
      PHOTOPRISM_DISABLE_TENSORFLOW: 'false'
      PHOTOPRISM_DETECT_NSFW: 'false'
      PHOTOPRISM_SIDECAR_JSON: 'true'
      PHOTOPRISM_SIDECAR_YAML: 'true'
    working_dir: '/photoprism'
    volumes:
      - '~/Pictures:/photoprism/originals'
      - './storage:/photoprism/storage'
      - './import:/photoprism/import'

Con el archivo listo, abre una terminal en esa carpeta y ejecuta: docker compose up -d. La primera inicialización descarga imágenes y crea la base de datos; dale unos minutos. Después, lanza el indexado con docker compose exec photoprism photoprism index. Para actualizar en el futuro: docker compose pull photoprism, docker compose stop photoprism y docker compose up -d –no-deps photoprism.

Credenciales por defecto: usuario admin y la contraseña que definas en variables de entorno. Recuerda cambiar contraseñas inseguras en cuanto entres por primera vez. Si vas a importar una montaña de material, te compensa desactivar funciones ML durante el primer indexado y activarlas luego.

Acceso seguro, dominios locales y proxy inverso

Si vas a exponer el servicio fuera de tu red, ponlo siempre detrás de HTTPS con un proxy inverso como Traefik o Caddy. Sin TLS, todo viaja en claro y podría interceptarse. Mantener la privacidad es parte del plan: usa certificados válidos y redirige HTTP a HTTPS.

Para acceder en local con un dominio tipo photoprism.localhost sin puerto, tienes dos caminos: mapear un puerto estándar en el host (por ejemplo, 80:2342, solo para uso local) o configurar Traefik para que escuche en 80 y enrute al servicio en 2342. Asegúrate de que las etiquetas del contenedor incluyen el router, el entrypoint y el puerto interno del servicio. Un patrón típico con Traefik sería definir la regla Host, el entrypoint web y señalar el puerto del servicio a 2342.

Otro punto clave es el cortafuegos: permite conexiones entrantes a los puertos que uses (web y https) y salientes a la API de geocodificación y a Docker cuando toque. Si bloqueas esas salidas, los mapas y lugares no funcionarán bien.

Organización, IA y funciones que marcan la diferencia

PhotoPrism trabaja con un catálogo potente y sidecars; puede escribir metadatos en JSON y YAML junto a tus originales, y así no depende solo de la base de datos. La clasificación con TensorFlow (rostros, objetos, escenas y NSFW) acelera búsquedas, y decidir si marcas fotos sensibles como privadas es tan fácil como activar un valor en la configuración.

Para cuidar el rendimiento, puedes ajustar calidad y tamaño de miniaturas, códecs de vídeo, límites de bitrate y reescalado. FFmpeg se configura por variables y, si tu hardware lo soporta, puedes delegar en Intel QSV, Nvidia, Apple o VAAPI para transcodificación acelerada. Con pocos clics pasas de un flujo básico a uno adaptado a tu equipo.

La navegación es ágil: línea temporal, álbumes, etiquetas, favoritos y lugares. El panel avanzado de búsqueda te deja filtrar por cámara, fechas, países, colores o gente. Si vienes de bibliotecas caóticas, la detección de duplicados y la normalización de metadatos te ayudan a poner orden sin dolor.

En móviles, no hay app oficial, pero puedes usar la PWA o sincronizar con WebDAV mediante apps como PhotoSync. La PWA es muy práctica: se instala como si fuera nativa y te ahorra depender del navegador cada vez. Eso sí, la experiencia en Android TV o Google TV es limitada, como en la mayoría de soluciones del sector; lo más fiable sigue siendo tirar de navegador en un portátil conectado a la tele si quieres ver fotos en familia cómodamente.

Quién se beneficia especialmente de PhotoPrism

Fotógrafos profesionales con miles de RAW encontrarán un aliado potente: indexación, búsqueda por lentes o cámaras, detección de duplicados y sidecars para no tocar el original. Tener la colección controlada, etiquetada y consolidada ahorra horas de trabajo a medio plazo.

Para diseñadores gráficos y creativos, las etiquetas por colores y objetos sirven para localizar inspiración visual con rapidez. La vista por momentos y la línea temporal ayudan a rescatar ideas y materiales sin perder el hilo.

En el sector inmobiliario, agentes de bienes raíces pueden clasificar propiedades por ubicación, fecha o etiquetas, y compartir álbumes con enlaces protegidos que caducan. La privacidad aquí es clave, y tener el control del servidor suma puntos.

Equipos de marketing digital agradecen una biblioteca ordenada de activos, con filtros por campañas, fechas y países. El soporte multiusuario y el uso de sidecars facilita no romper los originales y compartir colecciones internas sin exponerlas fuera.

Para viajeros, archivistas digitales y desarrolladores, las ventajas van de los mapas interactivos a la posibilidad de integrar la galería con otros servicios mediante WebDAV. Si además te preocupa el cumplimiento, mantener los datos en tu infraestructura te ayuda con RGPD y políticas internas.

Alternativas populares y cómo encajan

Immich está pegando fuerte: recuerda mucho a Google Fotos, con línea temporal impecable, favoritas con tecla, sincronización móvil y búsqueda semántica por conceptos o colores. La importación desde Google Takeout es comodísima con herramientas como Immich-Go. Como punto flojo, la app para Android TV es limitada; para sesiones en la tele, mejor navegador desde portátil.

En el terreno de suites de productividad, Nextcloud Photos y el plugin Memories dan una opción sólida si ya usas Nextcloud. Con la app Recognize ganas reconocimiento de caras, y con Imaginary y Preview Generator aceleras vistas previas. La interfaz cumple, aunque las acciones rápidas como marcar favoritos no son tan inmediatas como en otras opciones.

PhotoStructure ofrece un enfoque diferente, con una portada que muestra una selección aleatoria de fotos para redescubrir tu archivo. Va rápido y es fresco, pero su modo Plus desbloquea funciones como favoritos y reconocimiento facial, lo que puede ahuyentar a quien busque todo gratis y local.

Piwigo, Photoview, Lychee o Photonix cubren escenarios diversos: galerías simples, reconocimiento básico o organización por etiquetas. Si tu prioridad es la línea temporal y atajos ágiles, tal vez se queden cortas. LibrePhotos es muy prometedora en papel, pero su despliegue puede ser más artesanal y no siempre va fina en equipos modestos.

Hasta Plex ha lanzado Plex Photos en beta para iOS, Android y web; si ya eres usuario de Plex, asoma como opción curiosa, aunque por ahora carece de app nativa para Android TV con experiencia pulida. Por su parte, Ente abrió su código y presume de cifrado extremo a extremo; tiene muy buena pinta, incluso con clientes de escritorio, aunque su autohospedado requiere algo de maña.

Preguntas frecuentes para principiantes con Docker

Dónde pongo el archivo YAML: en la carpeta que quieras. Lo importante es ejecutar los comandos docker compose desde ese directorio para que lea el YAML correcto. Mantén juntos docker-compose.yml y subcarpetas como storage, database e import para tenerlo todo a mano.

¿Debo montar mi carpeta de fotos actual? Sí, mapea tu carpeta de fotos a /photoprism/originals. Si prefieres no dar permisos de escritura, puedes montarla en solo lectura, pero perderás funciones de edición de metadatos in situ; con sidecars, PhotoPrism evita tocar el original igualmente.

¿Dónde van la base de datos y la caché? Mejor fuera de tu carpeta de fotos, en una ruta separada que mapees a /photoprism/storage (y, si usas MariaDB, a ./database en el contenedor del SGBD). Así no mezclas cachés y DB con tus originales.

Cómo se monta una carpeta en Docker: en la clave volumes usas el formato ruta_host:ruta_contenedor. Por ejemplo, ~/Pictures:/photoprism/originals. Verifica permisos del usuario que corre el contenedor; si hace falta, usa variables PHOTOPRISM_UID y PHOTOPRISM_GID o la directiva user para alinear permisos.

¿Hace falta Traefik o Caddy? Solo si quieres TLS automático, dominios bonitos y rutas limpias, o si expones el servicio a Internet. En local, mapear el puerto 2342 es suficiente. Si usas Traefik, define el host, el entrypoint web y el puerto interno 2342 del servicio; así podrás entrar con photoprism.localhost sin añadir :2342.

Soporte, actualizaciones y comunidad

El proyecto aspira a ser la opción más amigable con la privacidad y tiene una hoja de ruta viva. Apuntan a política de cero errores y, por eso, no fijan fechas cerradas para nuevas funciones: el ritmo depende también de la financiación y de la ayuda de la comunidad. Si te encaja, hacerte miembro acelera el desarrollo de lo que más te interesa.

Para resolver dudas, tienes Discusiones en GitHub y chat comunitario. Los miembros Silver, Gold y Platinum pueden además escribir para soporte técnico. Antes de abrir un bug, revisa las listas de verificación de troubleshooting; muchas veces el problema es de configuración local y se soluciona rápido.

En actualizaciones, puedes automatizar con Watchtower si te sientes cómodo; si no, mejor tirar de pull, stop y up cuando salga una versión estable. En entornos serios, fija versiones y evita latest, tanto en PhotoPrism como en MariaDB, para actualizar de forma controlada.

Si te preocupan los mapas y la geocodificación inversa, PhotoPrism y MapTiler ofrecen estos servicios con un nivel de privacidad muy alto. Su uso está cubierto por el proyecto, con caché para mejorar rendimiento y evitar exponer más de la cuenta tus consultas.

Por último, recuerda lo obvio pero esencial: hacer copias de seguridad no es opcional. Si gestionas recuerdos familiares o material de clientes, la responsabilidad es tuya. Respaldos de la base de datos, del almacenamiento y, sobre todo, de tus originales en al menos dos ubicaciones distintas. Evita discos USB baratos o carpetas de red lentas para la DB.

A estas alturas, PhotoPrism se ha ganado el puesto como solución robusta para tener tu propio Google Fotos en local: IA para ordenar, velocidad con SSD, sidecars para preservar originales y una PWA cuidada. Si priorizas disfrutar frente a catalogar, quizá te seduzcan alternativas como Immich por su interfaz; si lo tuyo es tenerlo todo meticulosamente organizado, PhotoPrism brilla con luz propia. Sea cual sea tu perfil, con un buen docker-compose, swap suficiente, HTTPS si sales a Internet y copias de seguridad, tienes montado un sistema sólido para muchos años.