---
title: "Configuración"
description: "Una visión general de las variables de entorno clave: puerto, modo de autenticación, base de datos de metadatos, topología de espacios, búsqueda."
---

# 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](/docs/reference/environment-variables/).

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](/docs/self-hosting/authentication/) (`AUTH_MODE`), [Base de datos](/docs/self-hosting/database/) (`META_DB_URL`), [Búsqueda semántica](/docs/self-hosting/search-setup/) (`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](/docs/concepts/spaces-and-projects/).

## 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](/docs/self-hosting/production/). Para más detalles sobre cómo conectar agentes, consulta [Conectar un agente](/docs/agents/connect/).

> [!tip] Referencia completa
> 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](/docs/reference/environment-variables/).

A continuación: configura la [autenticación](/docs/self-hosting/authentication/) y, si hace falta, la [búsqueda semántica](/docs/self-hosting/search-setup/).