Trilium Notes: Despliega tu base de conocimiento en Unraid

Trilium Notes: Despliega tu base de conocimiento personal en Unraid

En el artículo anterior escribí sobre el camino que recorrí de Org-mode a Obsidian, y finalmente a Trilium Notes. En este artículo intentare explicar qué es realmente esta herramienta y como levantarla en modo servidor sobre Unraid, para tenerla siempre disponible desde cualquier dispositivo.

¿Qué es TriliumNext Notes?

Trilium Notes es una aplicación de gestión de conocimiento personal, de código abierto y autoalojada. Su principal característica es su estructura de notas en árbol jerárquico, donde una misma nota puede aparecer en múltiples lugares del árbol simultáneamente gracias al sistema de clonado.​

A diferencia de Obsidian —que trabaja con archivos Markdown— Trilium almacena todo en una base de datos SQLite, lo que se traduce en una serie de ventajas como el rendimiento y la búsqueda., especialmente si tienes muchas notas.

El proyecto activo a día de hoy es TriliumNext, el fork comunitario del original desarrollado por @zadam.  

Tipos de clientes

• Aplicación desktop (Electron): disponible para Windows, macOS y Linux. Incluye la base de datos de forma local y no necesita servidor. Ideal para uso en un único equipo.
• Cliente web (navegador): cuando Trilium corre en modo servidor, el navegador actúa como cliente. Sin instalación en el dispositivo cliente, acceso desde PC, móvil o tablet.
• Aplicación móvil web: la interfaz del servidor está optimizada para pantallas pequeñas, funcionando como una Progressive Web App (PWA) que puedes añadir a la pantalla de inicio de tu teléfono.
• Web Clipper: extensión para Chrome y Firefox que permite capturar páginas web, selecciones de texto e imágenes directamente a tu árbol de notas.
• TriliumDroid (Android, alpha): cliente nativo para Android desarrollado por la comunidad, disponible en F-Droid/IzzyOnDroid. Se conecta directamente a la instancia del servidor.

Características principales

• Notas anidadas en árbol con profundidad ilimitada y clonación entre ramas
• Editor WYSIWYG con soporte de tablas, imágenes, fórmulas matemáticas y autoformato Markdown
• Scripting con JavaScript y API REST para automatización avanzada
• Cifrado por nota con granularidad individual
• Sincronización entre instancias (desktop ↔ servidor)
• Publicación de notas en internet mediante URLs compartidas
• Web Clipper para capturar contenido desde el navegador
• Diagramas Excalidraw integrados como tipo de nota “canvas”
• Frontend móvil optimizado para smartphones y tablets
• Escala bien hasta más de 100.000 notas

Modo desktop vs. modo servidor

Trilium puede ejecutarse de dos formas:

En modo servidor, por defecto Trilium expone una interfaz web en el puerto 8080 (aunque la plantilla de Unraid utiliza el 8888), se puede acceder desde el navegador del PC, teléfono, tablet… sin necesidad de instalar nada.

Instalación en Unraid

Unraid gestiona los contenedores Docker a través de plantillas, y Trilium tiene una plantilla oficial disponible como Community Application.

Como es obvio, has de tener instalado el plugin Community Applications instalado en Unraid.

• Ve a la pestaña Apps en tu panel de Unraid
• Busca Trilium en la barra de búsqueda

• Haz clic en Instalar en la plantilla de Trilium

• Configura los parámetros básicos:

  • Repositorio: cámbialo por triliumnext/trilium:latest o la etiqueta de la versión que prefieras
  • Tipo de red: selecciona Bridge o la interfaz que corresponda con tu configuración de red.
  • Puerto del host: por defecto 8888 (la plantilla Unraid usa este puerto)
  • Appdata: /mnt/user/appdata/trilium
  • Backups: el path donde vana residir las copias de seguridad de la base de datos

• Haz clic en Aplicar y espera a que descargue la imagen triliumnext/notes desde Docker Hub

Una vez iniciada la aplicación, accede a la url http://TU_IP_UNRAID:8888 desde el navegador.

Primer acceso y configuración inicial

Al acceder por primera vez a http://TU_IP_UNRAID:8888, Trilium te mostrará un asistente con tres opciones::

1. I’m a new user, and I want to create a new Trilium document for my notes — crea una base de datos nueva desde cero, con notas de ejemplo incluidas. Es la opción si es tu primera instalación.
2. I have a desktop instance already, and I want to set up sync with it — configura la instancia del servidor para sincronizarse con una instalación desktop existente en tu ordenador.
3. I have a server instance already, and I want to set up sync with it — conecta con otra instancia de servidor ya existente, útil si estás migrando o replicando.

Si eliges la primera opción, Trilium te pedirá que establezcas una contraseña para tu instancia — esta contraseña también cifra la base de datos, así que guárdala en un lugar seguro. 

Una vez configurada, te pide volver a introducir la nueva contraseña

De esta forma accederás directamente al árbol de notas con los ejemplos predefinidos.

Seguridad: activar MFA

Si vas a exponer tu instancia al exterior —por ejemplo mediante Cloudflare Tunnel— es muy recomendable activar la autenticación multifactor. Trilium soporta dos dos métodos, aunque no pueden ser usados juntos al mismo tiempo.

TOTP (Google Authenticator, Authy, etc.)

Es el método más sencillo.

• Ve a Menú → Options → MFA
• Activa el checkbox Enable Multi-Factor Authentication
• Selecciona Time-Based One-Time Password (TOTP) como método

• Haz clic en Generate TOTP Secret y copia el secreto generado en tu app de autenticación (Google Authenticator, Authy, 2FAS…)

• Haz clic en Generate Recovery Codes y guárdalos en un lugar seguro — son de un solo uso y te salvarán si pierdes acceso a tu app

• Recarga la página para que la nueva configuración tenga efecto en el siguiente login.

💡 Recomendación: si solo quieres una capa extra de seguridad rápida, usa TOTP. 

Siguientes pasos

Con Trilium corriendo en tu servidor Unraid ya tienes la base lista. En los próximos artículos de la serie exploraremos:

• La interfaz y estructura de notas: árboles, atributos, relaciones y clonado
• Gestión de tareas (TODO→DONE)
• Scripting con JavaScript: automatización
• Publicación de notas: cómo convertir Trilium en un blog o wiki pública