---
title: "Configuration"
description: "Aperçu des variables d'environnement essentielles : port, mode d'authentification, base de métadonnées, topologie des espaces, recherche."
---

# Configuration

Notarium se configure par des **variables d'environnement** — aucun secret ni chemin n'est figé dans l'image. Les valeurs par défaut sont pensées pour le zéro-config : une instance neuve démarre sans le moindre réglage. Cette page donne un aperçu des variables essentielles ; la liste complète, avec les valeurs exactes et les valeurs par défaut, se trouve dans la [Référence](/docs/reference/environment-variables/).

La configuration se définit via les options `-e` de `docker run` ou via un fichier `.env` (copié depuis `.env.example`). La stack Docker transmet `.env` au conteneur tel quel.

## Variables essentielles

| Variable | Rôle | Par défaut |
|---|---|---|
| `DATA_DIR` | L'unique réglage des données : la racine dont tout le reste découle — base de métadonnées, index, notes, artefacts. Non définie → une valeur par défaut fonctionnelle s'applique. | `/data` (Docker) ; `~/.local/share/notarium` (hôte) |
| `PORT` | Le port sur lequel écoute le backend (`/api`, `/mcp` et l'interface web). | `3000` |
| `AUTH_MODE` | Mode d'authentification : `password` ou `none`. | `password` |
| `META_DB_URL` | Base de métadonnées : `sqlite:<path>` ou `postgres://…`. Optionnelle — à définir uniquement pour un Postgres externe ; par défaut, il s'agit de SQLite sous `DATA_DIR`. | `sqlite:<DATA_DIR>/meta.db` |
| `SPACES_ROOT` | La racine où chaque espace est un dossier ; elle active la création d'espaces depuis l'interface. Optionnelle — seulement si les notes se trouvent hors de `DATA_DIR`. | `<DATA_DIR>/spaces` |
| `VECTOR_SEARCH` | `on`/`off` — recherche sémantique (vectorielle). | `off` dans l'image publiée (`on` dans le code) |

Chaque sujet est traité sur sa propre page : [Authentification](/docs/self-hosting/authentication/) (`AUTH_MODE`), [Base de données](/docs/self-hosting/database/) (`META_DB_URL`), [Recherche sémantique](/docs/self-hosting/search-setup/) (`VECTOR_SEARCH` et paramètres des modèles).

## Topologie des espaces

Il existe deux façons de définir les espaces :

- **`SPACES_ROOT`** — zéro-config : chaque espace est un dossier sous la racine indiquée. Les espaces sont créés au premier démarrage et via le bouton « New space… » de l'interface. C'est le comportement par défaut de la stack Docker.
- **`SPACES_CONFIG`** — une topologie explicite et figée (JSON en ligne ou chemin vers un fichier JSON). Bien adaptée lorsque l'ensemble des espaces est défini par l'opérateur et n'est pas créé depuis l'interface.

Pour le modèle des espaces et des projets, voir [Concepts](/docs/concepts/spaces-and-projects/).

## Authentification des agents (OAuth)

Au-delà des jetons personnels (PAT), Notarium sait autoriser les connecteurs MCP via **OAuth** — l'agent (le connecteur Claude, par exemple) s'authentifie alors de lui-même, sans jeton à coller à la main. Cela ne demande aucune configuration séparée : les clients s'enregistrent dynamiquement. Derrière un reverse proxy, définissez `PUBLIC_BASE_URL` (par exemple, `https://notes.example.com`) — une adresse externe stable pour les métadonnées OAuth ; sans elle, l'adresse est dérivée des en-têtes forwarded du proxy. Toujours derrière un proxy, il est également judicieux de définir `TRUST_PROXY` : les limites sur les tentatives de connexion et sur l'admission de nouveaux connecteurs seront alors appliquées à l'adresse IP réelle du client, et non à celle du proxy — voir [Production](/docs/self-hosting/production/). Pour en savoir plus sur la connexion des agents, voir [Connecter un agent](/docs/agents/connect/).

> [!tip] Référence complète
> Les variables de recherche (`EMBED_MODEL`, `EMBED_DIMENSIONS`, `EMBED_CPU_MEM_ARENA`, entre autres), les délais de synchronisation et les autres réglages fins sont rassemblés dans les tableaux de la page [Variables d'environnement](/docs/reference/environment-variables/).

Ensuite : configurez l'[authentification](/docs/self-hosting/authentication/) et, au besoin, la [recherche sémantique](/docs/self-hosting/search-setup/).