Joplin: Sincronización autohospedada de notas
Introducción
Joplin Server es el componente de sincronización del ecosistema Joplin, responsable de centralizar notas y metadatos para su uso desde múltiples dispositivos. Implementa la API oficial de sincronización y gestiona autenticación, usuarios y almacenamiento estructurado mediante base de datos.
Dentro del stack se integra como servicio independiente, separado de los clientes de escritorio y móvil, proporcionando persistencia centralizada y soporte multiusuario sin depender de proveedores externos.
Enfoque general / Arquitectura
El despliegue se compone de dos contenedores:
- Aplicación Joplin Server.
- Base de datos PostgreSQL dedicada.
La aplicación gestiona autenticación, API de sincronización y lógica de negocio, mientras que PostgreSQL almacena usuarios, metadatos y contenido estructurado.
El servicio se expone públicamente para permitir sincronización remota desde clientes, evitando capas intermedias que puedan interferir con la API.
Requisitos previos
- Entorno Docker operativo.
- Base de datos PostgreSQL accesible desde el contenedor de aplicación.
- Dominio o IP pública configurada si se requiere acceso externo.
Desarrollo
Qué se hizo y por qué
Se desplegó Joplin Server en contenedor independiente con base de datos propia para mantener aislamiento lógico respecto a otros servicios del stack.
La exposición directa del servicio responde a la necesidad de preservar el funcionamiento completo de la API de sincronización. No se integra con sistemas de autenticación externa como Authentik, ya que podrían interferir con el flujo de autenticación de los clientes.
La configuración de correo permanece deshabilitada al no requerirse funcionalidades de notificación o recuperación mediante email.
Configuración utilizada
La configuración contempla:
- Contenedor PostgreSQL con volumen persistente.
- Contenedor Joplin Server configurado para backend
pg. - Definición explícita de
APP_BASE_URLpara coherencia con el dominio público. - Desactivación del sistema de correo (
MAILER_ENABLED=0).
Validación
Tras el despliegue se verificó:
- Acceso web al panel de administración.
- Conectividad correcta entre aplicación y base de datos.
- Registro y autenticación de usuarios.
- Sincronización funcional desde clientes Joplin en escritorio y móvil.
Decisiones importantes
- Base de datos dedicada. Evita dependencias cruzadas con otros servicios.
- Exposición directa controlada. Preserva compatibilidad con la API oficial.
- Correo deshabilitado. Reduce superficie de configuración innecesaria.
Resumen breve
Joplin Server proporciona sincronización centralizada y autohospedada para el ecosistema Joplin mediante una arquitectura basada en aplicación y base de datos PostgreSQL. Permite mantener control total sobre los datos y el acceso multiusuario sin depender de servicios externos.