---
title: "Inicio rápido"
description: "De cero a tu primera nota en cinco minutos: levanta una instancia en un solo contenedor, crea tu primera nota y conecta un agente de IA."
---
# Inicio rápido
Notarium es una base de conocimiento autoalojada, construida como archivos Markdown planos en tu propio disco, sobre la que **una persona y un agente de IA** trabajan de igual a igual. Sin nube, sin formato propietario: las notas viven en carpetas, y git puede ser la fuente de verdad.
Esta sección es el camino más corto de cero a una instancia en marcha: despliega Notarium en un solo contenedor, crea tu primera nota en el editor web y conecta tu agente por MCP. Todo el recorrido lleva unos cinco minutos.
> [!note] Qué vas a necesitar
> Solo **Docker** (o Docker Desktop) y un puerto libre. Todo lo demás —el editor web, el motor y el endpoint MCP para agentes— ya está dentro de la imagen. No hace falta instalar Node, una base de datos ni un índice vectorial por separado.
## Cómo funciona
La misma base de conocimiento está abierta a dos lectores a la vez. La persona trabaja a través del editor web; el agente, a través del endpoint MCP; ambos ven el mismo grafo de notas, y en disco no es más que un árbol de archivos `.md`.
```mermaid
flowchart LR
human([Persona]) -->|editor web| core
agent([Agente de IA]) -->|MCP · start_session| core
core[Motor de Notarium] --> files[(Archivos Markdown
en disco)]
files -.->|git = fuente de verdad| git[(Repositorio)]
```
El principio clave es **file-first**: una nota es un archivo, no una fila en la base de datos de otro. No hace falta exportar, porque en realidad nunca estás "dentro": los datos son siempre tuyos y siempre están en disco.
## Levanta una instancia
La vía más rápida es ejecutar la imagen precompilada. Es autocontenida: levanta el motor, la interfaz web y el endpoint MCP de una sola vez.
```bash
# Descarga la imagen y arranca el contenedor
docker run -d --name notarium \
-p 3000:3000 \
-v notarium-data:/data \
docouno/notarium:latest
```
Un único volumen `/data` guarda todo el estado: la base de datos de metadatos, los índices, tus notas y los artefactos de exportación. No hay nada más que configurar: el puerto `3000` y la ruta de datos `/data` ya vienen fijados en la imagen. El puerto a la izquierda de `3000` puede cambiarse por cualquiera que esté libre.
Abre `http://localhost:3000`: te recibirá la **pantalla de configuración del primer arranque**. Crea al propietario de la instancia (la primera cuenta) y un espacio inicial (personal). Después de eso, ya estás en el editor.
> [!tip] Puerto y datos
> Puedes cambiar el puerto `3000` editando el número de la izquierda en `-p :3000`. La imagen `docouno/notarium` es pública: esta es la vía de instalación principal (los detalles y la compilación desde el código fuente están en la página de [Instalación](/docs/getting-started/installation/)). El volumen `/data` sobrevive cuando recreas el contenedor, pero cuida el volumen en sí: tus datos se van con él.
Lo que ocurre bajo el capó en el primer arranque:
- el motor arranca y sirve la interfaz web en el puerto que indicaste;
- dentro del volumen `/data` se inicializa el árbol de tus espacios;
- la pantalla de configuración crea al propietario, la cuenta a la que pertenece la instancia.
## Siguientes pasos
La instancia ya está en marcha; a continuación vienen tres pasos breves. Cada uno se cubre en su propia página:
| Paso | Página | Qué obtendrás |
|---|---|---|
| 1 | [Instalación y arranque](/docs/getting-started/installation/) | Un recorrido por `docker` / `make up`, los volúmenes y la pantalla de configuración |
| 2 | [Tu primera nota](/docs/getting-started/first-note/) | El árbol de archivos, el editor web, el guardado en `.md` |
| 3 | [Conecta un agente](/docs/getting-started/connect-agent/) | Un token, el endpoint `POST /mcp`, la llamada a `start_session` |
¿Prefieres captar primero el modelo completo? Echa un vistazo a la sección [Conceptos](/docs/concepts/): espacios y proyectos, tipos de nota, el grafo de conocimiento y el modelo de acceso para personas y agentes.