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.

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.

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.

# 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.

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:

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