Quick Start

Prerequisites

• Docker & Docker Compose (or Podman Compose)
• Git

1. Clone and start

git clone https://codeberg.org/ftieben/rohrpost.io
cd rohrpost.io
./deploy/deploy.sh up

This builds all services, runs database migrations automatically, and brings up Postgres (with pgvector and AGE), Ollama (embedding sidecar), NATS JetStream, Garage (S3-compatible object store), the gateway, distiller, archiver, admin API, and the admin web UI. Wait ~1 minute on first run for Ollama to pull the embedding model.

Services once up:

• Gateway: http://localhost:7878
• Admin web: http://localhost:8080
• Admin API: http://localhost:9090

2. Create a tenant and API key

Open http://localhost:8080, register your admin account, then create a tenant (e.g. my-project) and generate an API key from the API Keys tab. The key starts with rp-.

3. Ingest your first capsule

curl -X POST http://localhost:7878/api/v1/capsules \
  -H "Authorization: Bearer rp-your-api-key" \
  -H "X-Rohrpost-Tenant: my-project" \
  -H "Content-Type: application/json" \
  -d '{\"kind\":\"note\",\"content\":\"Our auth uses JWT with RS256 signing.}'

4. Query the knowledge base

curl -X POST http://localhost:7878/api/v1/recall \
  -H "Authorization: Bearer rp-your-api-key" \
  -H "X-Rohrpost-Tenant: my-project" \
  -H "Content-Type: application/json" \
  -d '{"query":"how does auth work"}'

You should receive a packed markdown brief with the ingested knowledge.

5. Connect via MCP

Download rohrpost-mcp from the Downloads tab in your admin panel, then add it to your AI client. Full configuration and a reference for all 10 MCP tools is in theMCP Server docs.

{
  "mcpServers": {
    "rohrpost": {
      "command": "/path/to/rohrpost-mcp",
      "env": {
        "ROHRPOST_GATEWAY_URL": "http://localhost:7878",
        "ROHRPOST_API_KEY": "rp-your-api-key"
      }
    }
  }
}