akvatar
Akvatar es una aplicación web auto-alojada para gestionar fotos de perfil de usuarios integradas con Authentik vía OIDC. Permite recorte client-side, procesamiento server-side y sincronización opcional con LDAP o webhooks. Incluye limpieza automática de archivos huérfanos.
Ficha actualizada 24 sept 2026, 1:20 · upstream 24 sept 2026, 1:07 · release sin release detectada
Qué es akvatar
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Akvatar es una aplicación web auto-alojada diseñada para permitir a los usuarios actualizar su foto de perfil mediante una interfaz moderna en el navegador. Tras la autenticación vía OIDC con Authentik, los usuarios pueden subir o importar imágenes, aplicar un recorte cuadrado client-side y el backend procesa el archivo para generar múltiples tamaños y formatos (JPEG, PNG, WebP). La aplicación empuja las imágenes al servidor de identidad y opcionalmente a un directorio LDAP.
El sistema incluye una tarea programada para la limpieza automática de archivos huérfanos y gestión de retención. Ofrece características avanzadas como manejo seguro de metadatos (stripping EXIF), nombres de archivo únicos con alta entropía y negociación de contenido HTTP para optimizar el rendimiento en CDNs. Soporta despliegue mediante contenedores Docker o instalación manual en Python, con opciones de TLS nativo y protección contra ataques CSRF.
Es ideal para organizaciones que requieren un control total sobre la infraestructura de identidad y preferen soluciones open source sin dependencias externas de CDN para el procesamiento de imágenes. La arquitectura permite una separación clara entre la configuración, los datos persistentes y el código fuente.
- Gestión centralizada de avatares en entornos corporativos con Authentik
- Sincronización de fotos de perfil entre sistemas (LDAP/Active Directory)
- Automatización de limpieza de almacenamiento de usuarios eliminados
- Integración con sistemas externos mediante webhooks HTTP tras actualización
- Importación masiva de avatares desde Gravatar sin intervención manual
- Despliegue seguro en infraestructuras auto-alojadas con TLS nativo
- Procesamiento de imágenes completo (recorte, redimensionamiento, formatos) sin dependencias externas de CDN
- Integración nativa y segura con Authentik vía Admin API y soporte LDAP/Active Directory
- Gestión automática de metadatos EXIF y protección contra fugas de información geográfica
- Despliegue seguro con contenedores distroless, no-root y sistema de archivos en solo lectura
- Mecanismo de limpieza programada para evitar acumulación de datos huérfanos
- Soporte de negociación de contenido HTTP (Accept header) para optimización de CDNs
- Dependencia obligatoria de una instancia de Authentik configurada previamente para la autenticación OIDC y API
- Requiere almacenamiento persistente separado para los archivos de avatares gestionados por el backend
- La sincronización masiva con Gravatar requiere ejecución manual de un script por parte del operador
- El procesamiento de imágenes consume recursos de CPU durante la generación de múltiples formatos
- No soporta despliegue directo sin reverse proxy o configuración TLS nativa específica
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.
Se recomienda usar Docker Compose para una gestión simplificada. Es obligatorio montar el volumen /data/user-avatars como escribible y /data/config como lectura. El contenedor debe ejecutarse con UID 65532 y sistema de archivos en solo lectura. Configurar un reverse proxy (nginx, Caddy) es la única opción soportada para producción. Asegurar que el volumen de datos tenga permisos correctos para el usuario del contenedor antes de iniciar.
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.