update docs

Author: smutyala1at

mimir-docs/app/(home)/page.mdx

@@ -190,9 +190,9 @@ import { Separator } from "@/components/ui/separator";
             <Database className="size-5 text-primary" />
           </div>
           <div>
-            <h3 className="mb-1 font-semibold leading-snug">Supabase Vector Store</h3>
+            <h3 className="mb-1 font-semibold leading-snug">PostgreSQL Vector Store</h3>
             <div className="text-sm text-muted-foreground leading-relaxed">
-              Built on Supabase for reliable, scalable vector storage. Fast semantic search with configurable similarity thresholds and match counts.
+              Built on PostgreSQL with pgvector for reliable, scalable vector storage. Works with any Postgres provider (Supabase, Neon, self-hosted). Fast semantic search with configurable similarity thresholds and match counts.
             </div>
           </div>
         </div>
@@ -238,7 +238,7 @@ import { Separator } from "@/components/ui/separator";
           </div>
           <h3 className="mb-2 font-semibold text-lg leading-snug">Store</h3>
           <div className="text-sm text-muted-foreground leading-relaxed">
-            Embeddings are stored in Supabase with source URLs, metadata, and full context. Everything is indexed and ready for semantic search.
+            Embeddings are stored in PostgreSQL (pgvector) with source URLs, metadata, and full context. Everything is indexed and ready for semantic search.
           </div>
         </div>
 

mimir-docs/app/layout.tsx

@@ -14,7 +14,7 @@ export const metadata: Metadata = {
     default: 'Mimir - Contextual RAG for Code & Documentation',
     template: '%s | Mimir',
   },
-  description: 'Mimir is a comprehensive contextual RAG (Retrieval Augmented Generation) system with MCP integration. Ingest code and documentation from multiple GitHub repositories into Supabase vector store. Supports TypeScript, Python, and more. OpenAI-compatible API and MCP protocol for AI assistants.',
+  description: 'Mimir is a comprehensive contextual RAG (Retrieval Augmented Generation) system with MCP integration. Ingest code and documentation from multiple GitHub repositories into PostgreSQL (pgvector). Supports TypeScript, Python, and more. OpenAI-compatible API and MCP protocol for AI assistants.',
   keywords: [
     'RAG',
     'Retrieval Augmented Generation',
@@ -24,7 +24,8 @@ export const metadata: Metadata = {
     'Documentation Search',
     'Codebase Search',
     'Vector Database',
-    'Supabase',
+    'PostgreSQL',
+    'pgvector',
     'TypeScript',
     'Python',
     'AI Documentation',

mimir-docs/content/docs/configuration.mdx

@@ -61,6 +61,10 @@ MIMIR_DATABASE_URL=postgresql://user:password@host:5432/database
 
 Your PostgreSQL connection string. Mimir uses it to connect directly to your database and store/query vector embeddings.
 
+<InfoCard>
+**Docker and managed Postgres (Supabase, Neon, etc.):** If the container cannot reach your database, run with **host network**: `docker run --rm --network host -v $(pwd)/.env:/app/.env:ro mimir-rag:local`. That uses the host's network and usually clears connection issues. Alternatively, for Supabase use the **Session Pooler** connection string (port 6543) from Dashboard → Settings → Database → Connection Pooling → Session mode.
+</InfoCard>
+
 #### Embedding Dimension
 
 The default schema uses `vector(3072)` for embeddings. If your embedding model uses a different dimension, update the database schema:

mimir-docs/content/docs/deployment.mdx

@@ -34,6 +34,19 @@ docker run --rm \
   mimir-rag:latest
 ```
 
+### Database connection from Docker
+
+If the container cannot reach your database (e.g. connection timeouts or "Not IPv4 compatible" with Supabase/Neon), run the image with **host network mode**. The app then uses the host’s network and can connect to the DB without changing your connection string:
+
+```bash
+docker run --rm \
+  --network host \
+  --env-file .env \
+  mimir-rag:latest
+```
+
+With host network, the app listens on port 3000 on the host; omit `-p 3000:3000`. On Linux this usually resolves DB connection issues. On macOS/Windows, host network behaves differently—prefer the Session Pooler (port 6543) for Supabase or a connection string that works from inside the container.
+
 <div className="my-6">
   <Separator />
 </div>
@@ -79,11 +92,12 @@ Hetzner is a popular choice for deploying Mimir due to its simplicity and cost-e
    ```bash
    docker run -d \
      --name mimir-rag \
-     -p 3000:3000 \
+     --network host \
      --env-file .env \
      --restart unless-stopped \
      mimir-rag:latest
    ```
+   Using `--network host` avoids database connection issues with managed Postgres (Supabase, Neon, etc.). The server listens on port 3000 on the host; do not use `-p 3000:3000` when using host network.
 
 That's it! Your Mimir instance is now running on Hetzner.
 

mimir-docs/content/docs/getting-started.mdx

@@ -14,11 +14,15 @@ Before you begin, make sure you have:
 - **LLM Provider**: API key for OpenAI, Anthropic, Google, or Mistral
 - **GitHub** (optional): Repository with documentation (MDX) and/or code to ingest
 
-## Step 1: Set up Supabase
+## Step 1: Set up PostgreSQL Database
 
-1. Go to [supabase.com](https://supabase.com) and create a new project
-2. Note your project URL (e.g., `https://your-project.supabase.co`)
-3. Get your database password from Project Settings → Database
+You need a PostgreSQL database with the [pgvector](https://github.com/pgvector/pgvector) extension. You can use any provider:
+
+- **[Supabase](https://supabase.com)** – Create a project, then use Settings → Database for your connection string. With Docker, use the **Session Pooler** (port 6543) if your database shows "Not IPv4 compatible".
+- **[Neon](https://neon.tech)** – Create a project and copy the connection string from the dashboard.
+- **Self-hosted** – Install PostgreSQL and the pgvector extension, then use a connection string like `postgresql://user:password@host:5432/database`.
+
+Save your connection string; you'll add it as `MIMIR_DATABASE_URL` in the next step.
 
 ## Step 2: Configure mimir-rag
 
@@ -48,7 +52,7 @@ make server
 
 The server will:
 - Load your `.env` configuration
-- Automatically set up the database schema (if `DATABASE_URL` is configured)
+- Run Prisma migrations to set up the database schema (if `MIMIR_DATABASE_URL` is set)
 - Start the API on port 3000
 
 ## Step 5: Trigger ingestion

mimir-rag/README.md

@@ -120,6 +120,19 @@ docker run --rm \
   mimir-rag:local
 ```
 
+**Run with host network (fixes DB connection issues):**
+
+If the container cannot reach your database (e.g. timeouts or "Not IPv4 compatible" with Supabase/Neon), use host network mode. The app then uses the host's network and can connect without changing your connection string:
+
+```bash
+docker run --rm \
+  --network host \
+  -v $(pwd)/.env:/app/.env:ro \
+  mimir-rag:local
+```
+
+With `--network host`, the server listens on port 3000 on the host; omit `-p 3000:3000`. On Linux this usually clears database connection problems.
+
 ### How It Works
 
 The Docker container:
@@ -154,7 +167,7 @@ Key configuration variables include:
   - **Multiple Repositories**: Use numbered variables for multiple repos:
     - `MIMIR_GITHUB_CODE_REPO_1_URL`, `MIMIR_GITHUB_CODE_REPO_1_DIRECTORY`, etc.
     - `MIMIR_GITHUB_DOCS_REPO_1_URL`, `MIMIR_GITHUB_DOCS_REPO_1_BASE_URL`, etc.
-  - See [Configuration Documentation](../mimir-docs/app/configuration) for complete details
+  - See [Configuration Documentation](../mimir-docs/content/docs/configuration.mdx) for complete details
 - **Parser**: 
   - `MIMIR_EXTRACT_VARIABLES` - Extract top-level variables (default: false)
   - `MIMIR_EXTRACT_METHODS` - Extract class methods (default: true)