---
title: "Быстрый старт"
description: "От нуля до первой заметки за пять минут: поднять инстанс одним контейнером, создать первую заметку и подключить ИИ-агента."
---

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

## Дальше

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

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

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