Quick Start

Prerequisites

• Docker & Docker Compose
• Rust toolchain (for building from source)

1. Start the infrastructure

git clone https://github.com/rohrpost/rohrpost.git
cd rohrpost
docker compose -f deploy/docker-compose.yml up -d

This brings up Postgres (with pgvector), Ollama (embedding sidecar), NATS, and Garage. Wait for Ollama to finish pulling the embedding model (~1 minute on first run).

2. Run migrations

export DATABASE_URL="postgres://rohrpost:rohrpost@localhost:5432/rohrpost"
sqlx migrate run --source deploy/migrations

3. Start the gateway

cp deploy/rohrpost.toml .
cargo run --bin rohrpost

The gateway starts on http://localhost:7878.

4. Ingest your first capsule

echo "Our auth system uses JWT with RS256 signing" | \
  cargo run --bin rpctl -- ingest --tenant my-project --kind note

5. Query the knowledge base

cargo run --bin rpctl -- recall --tenant my-project "how does auth work"

You should see a markdown brief with the ingested knowledge.

6. Connect via MCP

Add to your MCP client config:

{
  "mcpServers": {
    "rohrpost": {
      "command": "path/to/rohrpost-mcp",
      "env": {
        "ROHRPOST_GATEWAY_URL": "http://localhost:7878"
      }
    }
  }
}

Your AI assistant can now use rohrpost_ingest and rohrpost_recall tools.