docs(apps): expand configuration and integration guides

This commit is contained in:
Eduardo David Paredes Vara
2026-08-09 17:15:58 +00:00
parent 4563322851
commit 587495c195
22 changed files with 477 additions and 51 deletions
+15
View File
@@ -2,6 +2,21 @@
Gestor de tareas y proyectos con PostgreSQL, soporte CalDAV y envío de recordatorios por correo.
## Arquitectura y propósito
`vikunja` ofrece interfaz, API y CalDAV; `vikunja-db` guarda usuarios, proyectos y tareas. PostgreSQL sólo está en `vikunja_internal`; Vikunja se conecta además a `proxy` y `mail_internal`.
## Configuración
- `VIKUNJA_DOMAIN` forma `VIKUNJA_SERVICE_PUBLICURL`; incluye HTTPS y la barra final esperada.
- `VIKUNJA_JWT_SECRET` firma sesiones. Debe ser aleatorio, exclusivo y estable.
- `VIKUNJA_DB_*` debe coincidir en aplicación, healthcheck y PostgreSQL.
- Las variables `VIKUNJA_MAILER_*` configuran SMTP y recordatorios.
- El registro público está desactivado; crea usuarios de forma administrativa.
- `/opt/vikunja/files` guarda adjuntos y `/opt/vikunja/postgres` la base; ambos son necesarios para una restauración completa.
CalDAV está activado para clientes externos; publica siempre mediante HTTPS y revoca credenciales de clientes perdidos.
## Requisitos
- Docker Compose