Configuración
Notarium se configura con variables de entorno: la imagen no lleva incrustado ningún secreto ni ninguna ruta. Los valores por defecto están pensados para funcionar sin configuración alguna: una instancia recién creada arranca sin tocar un solo ajuste. Esta página es una visión general de las variables clave; la lista completa, con los valores exactos y los valores por defecto, está en la Referencia.
La configuración se define con flags -e en docker run o mediante un archivo .env (copiado de .env.example). El stack de Docker pasa el .env al contenedor tal cual.
Variables clave
| Variable | Propósito | Por defecto |
|---|---|---|
DATA_DIR | El único ajuste de datos: la raíz de la que se deriva todo lo demás — base de datos de metadatos, índices, notas, artefactos. Sin definir → se usa un valor por defecto operativo. | /data (Docker); ~/.local/share/notarium (host) |
PORT | El puerto en el que escucha el backend (/api, /mcp y la interfaz web). | 3000 |
AUTH_MODE | Modo de autenticación: password o none. | password |
META_DB_URL | Base de datos de metadatos: sqlite:<path> o postgres://…. Opcional — solo se define para un Postgres externo; por defecto es SQLite bajo DATA_DIR. | sqlite:<DATA_DIR>/meta.db |
SPACES_ROOT | La raíz donde cada espacio es una carpeta; permite crear espacios desde la interfaz. Opcional — solo si las notas viven fuera de DATA_DIR. | <DATA_DIR>/spaces |
VECTOR_SEARCH | on/off — búsqueda semántica (vectorial). | off en la imagen publicada (on en el código) |
Cada tema se cubre en su propia página: Autenticación (AUTH_MODE), Base de datos (META_DB_URL), Búsqueda semántica (VECTOR_SEARCH y los parámetros de los modelos).
Topología de espacios
Hay dos maneras de definir los espacios:
SPACES_ROOT— sin configuración: cada espacio es una carpeta bajo la raíz indicada. Los espacios se crean en el primer arranque y con el botón "New space…" de la interfaz. Es el valor por defecto del stack de Docker.SPACES_CONFIG— una topología explícita y fija (JSON en línea o la ruta a un archivo JSON). Encaja bien cuando el conjunto de espacios lo define el operador y no se crea desde la interfaz.
Para el modelo de espacios y proyectos, consulta Conceptos.
Autenticación de agentes (OAuth)
Además de los tokens personales (PAT), Notarium puede autorizar conectores MCP mediante OAuth: así el agente (el conector de Claude, por ejemplo) se autentica por su cuenta, sin ningún token que pegar a mano. Esto no requiere configuración aparte: los clientes se registran de forma dinámica. Detrás de un proxy inverso, define PUBLIC_BASE_URL (por ejemplo, https://notes.example.com) — una dirección externa estable para los metadatos de OAuth; sin ella, la dirección se deriva de las cabeceras reenviadas por el proxy. Detrás de un proxy también conviene definir TRUST_PROXY, para que los límites de inicio de sesión y de nuevos conectores se cuenten según la IP real del cliente y no según la dirección del proxy — consulta Producción. Para más detalles sobre cómo conectar agentes, consulta Conectar un agente.
Las variables de búsqueda (EMBED_MODEL, EMBED_DIMENSIONS, EMBED_CPU_MEM_ARENA y otras), los tiempos de sincronización y los demás ajustes de grano fino están reunidos en las tablas de la página Variables de entorno.
A continuación: configura la autenticación y, si hace falta, la búsqueda semántica.