candlr
Candlr es una aplicación auto-alojada para gestionar cumpleaños y aniversarios. Utiliza Docker con SQLite integrado, eliminando la necesidad de bases de datos externas complejas. Soporta autenticación OIDC, 2FA y notificaciones vía email o mensajería instantánea sin infraestructura adicional pesada.
Ficha actualizada 26 sept 2026, 17:57 · upstream 26 sept 2026, 17:33 · release v1.3.2
Qué es candlr
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Candlr centraliza el seguimiento de fechas importantes en una interfaz unificada, permitiendo añadir fotos, notas con Markdown y tipos de eventos personalizados. La arquitectura combina frontend y backend en un único contenedor, facilitando la gestión mediante Docker Compose o comandos directos sin orquestación compleja.
Para la persistencia de datos y las migraciones, utiliza SQLite en un archivo local, lo que simplifica el despliegue pero requiere copias de seguridad manuales del volumen de datos. La aplicación soporta integración con calendarios externos mediante suscripciones iCal privadas y permite importar/exportar tarjetas como CSV o JSON para preservar la información entre instancias.
La configuración de seguridad incluye claves JWT firmadas, autenticación de dos factores (TOTP) y soporte para proveedores OpenID Connect como Authelia o Keycloak. Las notificaciones se gestionan por usuario con canales configurables individualmente, incluyendo web push, ntfy o Discord, mientras que el envío de correos electrónicos requiere configuración SMTP global en las variables de entorno del servidor.
- Gestión centralizada de cumpleaños familiares y personales en un solo lugar
- Integración automática con Google Calendar, Apple Calendar o Thunderbird vía iCal
- Autenticación segura mediante SSO (OpenID Connect) en entornos corporativos o domésticos
- Recordatorios personalizados por canal (Telegram, Discord, Email) configurados por usuario
- Exportación de datos para migrar a otra herramienta o realizar copias de seguridad manuales
- Arquitectura monolítica en un solo contenedor Docker simplifica el mantenimiento
- Base de datos SQLite integrada sin necesidad de contenedor de base de datos separado
- Soporte nativo para autenticación OIDC con proveedores como Authelia o Authentik
- Sistema de notificaciones multi-canal (Email, Telegram, Discord, Pushover, ntfy)
- Tema oscuro/claro que sigue preferencias del sistema operativo automáticamente
- La clave SECRET_KEY debe mantenerse estable; cambiarla invalida las credenciales de 2FA almacenadas
- Las fotos no se incluyen en los archivos de exportación CSV o JSON
- El canal de notificación por email requiere configuración SMTP global antes de usarlo
- La base de datos SQLite no soporta replicación ni alta disponibilidad nativa
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.
Configurar SECRET_KEY con openssl rand -hex 32 es obligatorio para seguridad y 2FA. Usar PUID/PGID=1000 por defecto para compatibilidad con Docker Desktop. Asegurar que TIMEZONE esté configurado correctamente para la lógica de recordatorios diarios.
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.