---
title: "Démarrage rapide"
description: "De zéro à votre première note en cinq minutes : lancez une instance dans un seul conteneur, créez votre première note et connectez un agent IA."
---

# Démarrage rapide

Notarium est une base de connaissances auto-hébergée, conçue comme de simples fichiers Markdown sur votre propre disque — une base sur laquelle **un humain et un agent IA** travaillent d'égal à égal. Pas de cloud, pas de format propriétaire : les notes vivent dans des dossiers, et git peut faire office de source de vérité.

Cette section est le chemin le plus court de zéro jusqu'à une instance opérationnelle : déployez Notarium dans un seul conteneur, créez votre première note dans l'éditeur web, puis connectez votre agent via MCP. L'ensemble prend environ cinq minutes.

> [!note] Ce qu'il vous faut
> Simplement **Docker** (ou Docker Desktop) et un port libre. Tout le reste — l'éditeur web, le moteur et le point d'accès MCP pour les agents — est déjà inclus dans l'image. Pas besoin d'installer Node, une base de données ou un index vectoriel séparément.

## Comment ça fonctionne

La même base de connaissances est ouverte à deux lecteurs à la fois. L'humain passe par l'éditeur web, l'agent par le point d'accès MCP ; tous deux voient le même graphe de notes, et sur le disque, ce n'est qu'une arborescence de fichiers `.md`.

```mermaid
flowchart LR
  human([Humain]) -->|éditeur web| core
  agent([Agent IA]) -->|MCP · start_session| core
  core[Moteur Notarium] --> files[(Fichiers Markdown<br/>sur le disque)]
  files -.->|git = source de vérité| git[(Dépôt)]
```

Le principe clé est **file-first** : une note est un fichier, pas une ligne dans la base de données de quelqu'un d'autre. Aucun export n'est nécessaire, car vous n'êtes jamais vraiment « à l'intérieur » — les données sont toujours les vôtres et toujours sur le disque.

## Lancer une instance

Le moyen le plus rapide est de lancer l'image préconstruite. Elle est autonome : elle démarre le moteur, l'interface web et le point d'accès MCP d'un seul coup.

```bash
# Récupérer l'image et démarrer le conteneur
docker run -d --name notarium \
  -p 3000:3000 \
  -v notarium-data:/data \
  docouno/notarium:latest
```

Un unique volume `/data` contient tout l'état : la base de métadonnées, les index, vos notes et les artefacts d'export. Il n'y a rien de plus à configurer — le port `3000` et le chemin des données `/data` sont déjà intégrés dans l'image. Le port à gauche de `3000` peut être remplacé par n'importe quel port libre.

Ouvrez `http://localhost:3000` — vous serez accueilli par l'**écran de configuration initiale**. Il crée le propriétaire de l'instance (le premier compte) et un espace de départ (personnel). Ensuite, vous voilà dans l'éditeur.

> [!tip] Port et données
> Vous pouvez changer le port `3000` en modifiant le nombre de gauche dans `-p <le vôtre>:3000`. L'image `docouno/notarium` est publique — c'est la voie d'installation principale (les détails et la compilation depuis les sources se trouvent sur la page [Installation](/docs/getting-started/installation/)). Le volume `/data` survit à la recréation du conteneur — mais protégez le volume lui-même : vos données partent avec lui.

Ce qui se passe en coulisses au premier lancement :

- le moteur démarre et sert l'interface web sur le port que vous avez indiqué ;
- l'arborescence de vos espaces est initialisée dans le volume `/data` ;
- l'écran de configuration crée le propriétaire — le compte auquel appartient l'instance.

## La suite

L'instance est opérationnelle — trois courtes étapes suivent. Chacune est détaillée sur sa propre page :

| Étape | Page | Ce que vous obtiendrez |
|---|---|---|
| 1 | [Installation et lancement](/docs/getting-started/installation/) | Un tour d'horizon de `docker` / `make up`, des volumes et de l'écran de configuration |
| 2 | [Votre première note](/docs/getting-started/first-note/) | L'arborescence de fichiers, l'éditeur web, l'enregistrement en `.md` |
| 3 | [Connecter un agent](/docs/getting-started/connect-agent/) | Un jeton, le point d'accès `POST /mcp`, l'appel de `start_session` |

Vous voulez d'abord saisir le modèle dans son ensemble ? Jetez un œil à la section [Concepts](/docs/concepts/) : espaces et projets, types de notes, graphe de connaissances et modèle d'accès pour les humains et les agents.