spoke-immich
Módulo Spoke para autoalojar gestión de medios con Immich v3.1.0. Incluye servidor, ML, PostgreSQL 18 con pgvector y Valkey. Requiere Troxy y Traefik. Optimizado para GPU passthrough.
Ficha actualizada 28 sept 2026, 0:42 · upstream 28 sept 2026, 0:33 · release v1.0.0
Qué es spoke-immich
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este repositorio proporciona un módulo Spoke dedicado a la implementación de Immich, una solución autoalojada para gestión de fotos y vídeos. El despliegue integra cuatro servicios principales: servidor de aplicación, inferencia de aprendizaje automático, base de datos PostgreSQL 18 con soporte vectorial y caché de cola de trabajos mediante Valkey.
La configuración predeterminada apunta a la versión v3.1.0 de Immich, utilizando imágenes oficiales alojadas en ghcr.io para el servidor y la base de datos, mientras que el servicio de ML utiliza una imagen de docker.io. El sistema está diseñado para operar dentro de una red Troxy con Traefik como proxy inverso, asegurando la comunicación segura entre los componentes internos y la interfaz pública.
Los requisitos de hardware incluyen passthrough de GPU para transcodificación acelerada por hardware y asignación de recursos específicos (4 núcleos CPU, 8 GB RAM, 30 GB disco). La configuración de variables de entorno permite definir rutas de datos estáticas y direcciones IP fijas para cada servicio, facilitando la integración en redes empresariales o domésticas complejas.
- Autoalojar una instancia completa de gestión de medios con reconocimiento facial y objetos.
- Integrar almacenamiento local con interfaz web a través de Troxy/Traefik.
- Utilizar capacidades vectoriales para búsqueda semántica en metadatos multimedia.
- Desplegar en entornos con GPU dedicada para transcodificación eficiente.
- Uso de PostgreSQL 18 con extensiones pgvector y vectorchord integradas.
- Imágenes oficiales de Immich v3.1.0 desde repositorios ghcr.io y docker.io.
- Soporte nativo para passthrough de GPU en el despliegue.
- Configuración modular mediante archivo docker-compose.yml.
- Dependencia crítica de la red Troxy y Traefik previamente desplegados.
- Requiere passthrough de GPU físico para activar transcodificación hardware.
- Versión fija predeterminada de Immich (v3.1.0) en las variables de entorno.
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.
Copiar .env.example y editar rutas de datos antes de ejecutar docker compose up -d. Asegurar passthrough de GPU (/dev/dri). Configurar secretos para la contraseña de la base de datos. Verificar que Traefik esté disponible como servicio hub. Usar IPs estáticas recomendadas en las variables si el entorno lo requiere.
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.