---
title: "Início rápido"
description: "Do zero à sua primeira nota em cinco minutos: suba uma instância em um único contêiner, crie sua primeira nota e conecte um agente de IA."
---

# Início rápido

O Notarium é uma base de conhecimento auto-hospedada (self-host) construída como arquivos Markdown simples no seu próprio disco — uma base em que **uma pessoa e um agente de IA** trabalham de igual para igual. Sem nuvem, sem formato proprietário: as notas ficam em pastas, e o git pode ser a fonte da verdade.

Esta seção é o caminho mais curto do zero até uma instância no ar: subir o Notarium em um único contêiner, criar sua primeira nota no editor web e conectar seu agente via MCP. Tudo isso leva cerca de cinco minutos.

> [!note] O que você vai precisar
> Só do **Docker** (ou Docker Desktop) e de uma porta livre. Todo o resto — o editor web, o motor e o endpoint MCP para agentes — já vem dentro da imagem. Não é preciso instalar Node, um banco de dados nem um índice vetorial à parte.

## Como funciona

A mesma base de conhecimento fica aberta a dois leitores ao mesmo tempo. A pessoa trabalha pelo editor web, o agente pelo endpoint MCP; os dois enxergam o mesmo grafo de notas, e no disco é apenas uma árvore de arquivos `.md`.

```mermaid
flowchart LR
  human([Pessoa]) -->|editor web| core
  agent([Agente de IA]) -->|MCP · start_session| core
  core[Motor do Notarium] --> files[(Arquivos Markdown<br/>no disco)]
  files -.->|git = fonte da verdade| git[(Repositório)]
```

O princípio-chave é o **file-first**: uma nota é um arquivo, não uma linha no banco de dados de outra pessoa. Não é preciso exportar, porque você nunca está de fato "lá dentro" — os dados são sempre seus e sempre ficam no disco.

## Suba uma instância

O jeito mais rápido é rodar a imagem pré-construída. Ela é autossuficiente: sobe o motor, a interface web e o endpoint MCP de uma só vez.

```bash
# Baixe a imagem e suba o contêiner
docker run -d --name notarium \
  -p 3000:3000 \
  -v notarium-data:/data \
  docouno/notarium:latest
```

Um único volume `/data` guarda todo o estado: o banco de metadados, os índices, suas notas e os artefatos de exportação. Não há mais nada a configurar — a porta `3000` e o caminho de dados `/data` já vêm definidos na imagem. A porta à esquerda de `3000` pode ser trocada por qualquer outra livre.

Abra `http://localhost:3000` — você será recebido pela **tela de configuração inicial**. Ela cria o dono da instância (a primeira conta) e um espaço inicial (pessoal). Depois disso, você já está no editor.

> [!tip] Porta e dados
> Você pode mudar a porta `3000` alterando o número à esquerda em `-p <a-sua>:3000`. A imagem `docouno/notarium` é pública — este é o caminho principal de instalação (detalhes e a compilação a partir do código-fonte estão na página [Instalação](/docs/getting-started/installation/)). O volume `/data` sobrevive à recriação do contêiner — mas cuide do volume em si: junto com ele vão embora os seus dados.

O que acontece nos bastidores no primeiro início:

- o motor sobe e serve a interface web na porta que você indicou;
- a árvore dos seus espaços é inicializada dentro do volume `/data`;
- a tela de configuração cria o dono — a conta a quem a instância pertence.

## Próximos passos

A instância está no ar — a seguir vêm três passos curtos. Cada um é detalhado em sua própria página:

| Passo | Página | O que você vai obter |
|---|---|---|
| 1 | [Instalação e início](/docs/getting-started/installation/) | Um passo a passo de `docker` / `make up`, volumes e da tela de configuração |
| 2 | [Sua primeira nota](/docs/getting-started/first-note/) | A árvore de arquivos, o editor web, salvar em `.md` |
| 3 | [Conectar um agente](/docs/getting-started/connect-agent/) | Um token, o endpoint `POST /mcp`, chamar `start_session` |

Quer entender o modelo inteiro primeiro? Dê uma olhada na seção [Conceitos](/docs/concepts/): espaços e projetos, tipos de nota, o grafo de conhecimento e o modelo de acesso para pessoas e agentes.