Быстрый старт

Notarium — это self-hosted база знаний, устроенная как обычные Markdown-файлы на вашем диске, с которой на равных работают человек и ИИ-агент. Никакого облака, никакого проприетарного формата: заметки лежат в папках, а git может быть источником истины.

Этот раздел — кратчайший путь от нуля до работающего инстанса: развернуть Notarium одним контейнером, создать первую заметку в веб-редакторе и подключить своего агента через MCP. На весь путь уходит около пяти минут.

Что понадобится

Только Docker (или Docker Desktop) и свободный порт. Всё остальное — веб-редактор, движок и MCP-эндпоинт для агентов — уже внутри образа. Ставить Node, базу или векторный индекс отдельно не нужно.

Как это устроено

Одна и та же база одновременно открыта двум читателям. Человек работает через веб-редактор, агент — через MCP-эндпоинт; оба видят один и тот же граф заметок, а на диске это просто дерево .md-файлов.

flowchart LR
  human([Человек]) -->|веб-редактор| core
  agent([ИИ-агент]) -->|MCP · start_session| core
  core[Движок Notarium] --> files[(Markdown-файлы<br/>на диске)]
  files -.->|git = источник истины| git[(Репозиторий)]

Ключевой принцип — file-first: заметка — это файл, а не строка в чужой базе. Экспорт не нужен, потому что вы никогда и не «внутри» — данные всегда ваши и всегда на диске.

Поднять инстанс

Самый быстрый способ — запустить готовый образ. Он самодостаточен: поднимает движок, веб-интерфейс и MCP-эндпоинт разом.

# Забрать образ и поднять контейнер
docker run -d --name notarium \
  -p 3000:3000 \
  -v notarium-data:/data \
  docouno/notarium:latest

Один том /data держит всё состояние: служебную БД, индексы, ваши заметки и артефакты экспорта. Больше настраивать нечего — порт 3000 и путь данных /data уже заданы в образе. Порт слева от 3000 можно сменить на любой свободный.

Откройте http://localhost:3000 — вас встретит setup-экран первого запуска. Он заведёт владельца инстанса (первый аккаунт) и стартовое (личное) пространство. После этого вы уже в редакторе.

Порт и данные

Порт 3000 можно сменить левой частью -p <свой>:3000. Образ docouno/notarium публичный — это основной путь установки (подробности и сборка из исходников — на странице Установка). Том /data переживает пересоздание контейнера — но берегите сам том: вместе с ним уйдут и данные.

Что происходит под капотом на первом старте:

поднимается движок и отдаёт веб-интерфейс на указанном порту;
внутри тома /data инициализируется дерево ваших пространств;
setup-экран создаёт владельца — этому аккаунту принадлежит инстанс.

Дальше

Инстанс поднят — дальше три коротких шага. Каждый разобран на своей странице:

Шаг	Страница	Что получите
1	Установка и запуск	Разбор `docker` / `make up`, томов и setup-экрана
2	Первая заметка	Дерево файлов, веб-редактор, сохранение в `.md`
3	Подключить агента	Токен, эндпоинт `POST /mcp`, вызов `start_session`

Хочется сперва понять модель целиком — загляните в раздел Концепции: пространства и проекты, типы заметок, граф знаний и модель доступа человека и агентов.