---
title: "Schnellstart"
description: "Von null zur ersten Notiz in fünf Minuten: eine Instanz mit einem einzigen Container hochfahren, die erste Notiz anlegen und einen KI-Agenten anbinden."
---

# Schnellstart

Notarium ist eine selbst gehostete Wissensbasis, die als schlichte Markdown-Dateien auf deiner eigenen Festplatte lebt – eine, an der **Mensch und KI-Agent** gleichberechtigt arbeiten. Keine Cloud, kein proprietäres Format: Notizen liegen in Ordnern, und git kann die Quelle der Wahrheit sein.

Dieser Abschnitt ist der kürzeste Weg von null zur laufenden Instanz: Notarium mit einem einzigen Container ausrollen, die erste Notiz im Web-Editor anlegen und den eigenen Agenten über MCP anbinden. Das Ganze dauert etwa fünf Minuten.

> [!note] Was du brauchst
> Nur **Docker** (oder Docker Desktop) und einen freien Port. Alles Weitere – der Web-Editor, die Engine und der MCP-Endpunkt für Agenten – steckt bereits im Image. Node, eine Datenbank oder einen Vektorindex separat zu installieren, ist nicht nötig.

## Wie es funktioniert

Dieselbe Wissensbasis steht zwei Lesern zugleich offen. Der Mensch arbeitet über den Web-Editor, der Agent über den MCP-Endpunkt; beide sehen denselben Notizgraphen, und auf der Festplatte ist es schlicht ein Baum aus `.md`-Dateien.

```mermaid
flowchart LR
  human([Mensch]) -->|Web-Editor| core
  agent([KI-Agent]) -->|MCP · start_session| core
  core[Notarium-Engine] --> files[(Markdown-Dateien<br/>auf der Festplatte)]
  files -.->|git = Quelle der Wahrheit| git[(Repository)]
```

Das Leitprinzip ist **file-first**: Eine Notiz ist eine Datei, keine Zeile in der Datenbank eines anderen. Ein Export erübrigt sich, denn du bist nie wirklich „drinnen“ – die Daten gehören immer dir und liegen immer auf der Festplatte.

## Eine Instanz hochfahren

Am schnellsten geht es mit dem fertigen Image. Es ist in sich geschlossen: Es bringt Engine, Weboberfläche und MCP-Endpunkt in einem Rutsch hoch.

```bash
# Image ziehen und den Container starten
docker run -d --name notarium \
  -p 3000:3000 \
  -v notarium-data:/data \
  docouno/notarium:latest
```

Ein einziges Volume `/data` hält den gesamten Zustand: die Metadaten-Datenbank, die Indizes, deine Notizen und die Export-Artefakte. Mehr ist nicht zu konfigurieren – Port `3000` und der Datenpfad `/data` sind bereits im Image festgelegt. Den Port links von `3000` kannst du auf jeden freien ändern.

Öffne `http://localhost:3000` – es empfängt dich der **Setup-Bildschirm des Erststarts**. Er legt den Eigentümer der Instanz (das erste Konto) und einen Start-Space (persönlich) an. Danach bist du im Editor.

> [!tip] Port und Daten
> Port `3000` änderst du über die linke Zahl von `-p <dein-Port>:3000`. Das Image `docouno/notarium` ist öffentlich – das ist der Hauptweg der Installation (Details und der Bau aus dem Quellcode stehen auf der Seite [Installation](/docs/getting-started/installation/)). Das Volume `/data` überlebt das Neuaufsetzen des Containers – hüte aber das Volume selbst: Mit ihm gehen auch deine Daten.

Was beim ersten Start im Hintergrund passiert:

- die Engine startet und liefert die Weboberfläche auf dem angegebenen Port aus;
- innerhalb des Volumes `/data` wird der Baum deiner Spaces initialisiert;
- der Setup-Bildschirm erstellt den Eigentümer – diesem Konto gehört die Instanz.

## Wie es weitergeht

Die Instanz läuft – als Nächstes folgen drei kurze Schritte. Jeder ist auf einer eigenen Seite behandelt:

| Schritt | Seite | Was du bekommst |
|---|---|---|
| 1 | [Installation und Start](/docs/getting-started/installation/) | Ein Durchgang durch `docker` / `make up`, Volumes und den Setup-Bildschirm |
| 2 | [Deine erste Notiz](/docs/getting-started/first-note/) | Der Dateibaum, der Web-Editor, das Speichern nach `.md` |
| 3 | [Einen Agenten anbinden](/docs/getting-started/connect-agent/) | Ein Token, der Endpunkt `POST /mcp`, der Aufruf von `start_session` |

Möchtest du zuerst das ganze Modell erfassen? Wirf einen Blick in den Abschnitt [Konzepte](/docs/concepts/): Spaces und Projekte, Notiztypen, den Wissensgraphen und das Zugriffsmodell für Mensch und Agenten.