immich-folio
Un portafolio fotográfico autocontenido alojado en un servidor local, que convierte álbumes de Immich en una galería pública sin exponer el servidor a internet.
Ficha actualizada 23 sept 2026, 10:34 · upstream 23 sept 2026, 10:23 · release v0.17.0
Qué es immich-folio
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Immich Folio es una herramienta para transformar los álbumes de Immich en una galería web pública. Actúa como proxy seguro entre los visitantes y la instancia privada de Immich: el servidor de Immich permanece local, completamente invisible al mundo exterior, mientras se publica la galería bajo tu control.
La plataforma ofrece un panel administrativo visual donde puedes gestionar layouts, organizar álbumes en colecciones, crear páginas tipo revista con ensayos fotográficos, y personalizar cada página con plantillas. Incluye un editor de bloques para el blog, una vista previa en tiempo real del editor de revistas, y soporte para proteger subpáginas con contraseñas.
Se integra con la API de Immich a través de tokens de acceso, permitiendo que los álbumes se carguen dinámicamente sin necesidad de migrar manualmente las imágenes. Además, soporta generación automática de imágenes sociales (OG images), marcadores GPS en mapas y un panel de administración completo para gestionar temas, SEO, protección de imágenes y configuración general.
- Publicar una galería personal con fotos seleccionadas sin exponer el servidor de Immich a internet
- Organizar álbumes fotográficos en colecciones temáticas mediante un panel visual
- Crear páginas tipo revista o ensayo fotográfico con plantillas predefinidas
- Proteger subpáginas con contraseñas y controlar qué contenido es visible para cada visitante
- Actúa como proxy seguro: el servidor de Immich nunca se expone al internet, solo se comunica a través del dominio público.
- Panel administrativo visual que permite gestionar layouts, álbumes y páginas sin necesidad de conocimientos técnicos avanzados.
- Soporta generación automática de imágenes sociales (OG images) para redes como Instagram o Facebook.
- Requiere Immich versión 3.0 o superior; versiones anteriores no soportan la nueva API de álbumes.
- Las páginas sin subpáginas no tienen acceso a las imágenes del álbum principal por defecto.
- La protección con contraseñas es opcional y requiere configuración adicional en cada página.
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Instala el contenedor Docker o usa la imagen oficial. Configura variables de entorno: IMMICH_API_URL, IMMICH_API_KEY y CACHE_TTL. Usa npm run dev para iniciar y prueba la instalación desde http://localhost:3000/install. Para producción, despliega con docker-compose usando un archivo .env.example como base. Actualiza dependencias semanalmente con Dependabot.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.