Eigen Mesh — Überblick & Schnellstart

Kurz gesagt: Diese Seite richtet sich an Betreiber:innen, die Eigen Mesh auf ihrem eigenen Server mit Docker betreiben möchten. Wenn du neu bei Eigen Mesh bist, starte mit Was ist Eigen Mesh?. Wenn Eigen deine Instanz betreibt, sieh dir Onboarding (Managed) an.

Für wen ist das gedacht

Für Managed Hosting (Eigen betreibt den Stack) sieh dir Onboarding (Managed) an.

Self-Hosting

Eigen Mesh ist eine selbst hostbare Speicherinfrastruktur: Sie erfasst Gedanken, reichert sie im Hintergrund an und macht sie über hybride Suche und MCP-Tools abrufbar, die dein Assistent direkt aufrufen kann.

Über diese Dokumentationsseite

Du liest Docs, die aus dem Repository eigenWebsite veröffentlicht werden. Deploy-Befehle, Docker Compose und Datenbankmigrationen laufen gegen das separate eigen-Produkt-Repository — nicht gegen dieses Marketing-/Docs-Repo.

Stack

Architektur

Beide Services sind in `docker-compose.yaml` im eigen-Repository definiert.

Voraussetzungen

• Docker mit dem docker compose-Plugin (Docker Desktop, OrbStack oder Linux)
• Git

Node.js oder npm werden zum Deploy-Zeitpunkt nicht benötigt, außer du führst die Erstmigrationen vom Host aus.

Schnellstart

git clone https://github.com/your-org/eigen.git && cd eigen
cp .env.example .env
# .env bearbeiten — mindestens BETTER_AUTH_SECRET, TENANT_MASTER_KEY und die LLM-Gateway-Variablen setzen (siehe Umgebungsvariablen)
docker compose up -d --build

Beim ersten Deploy das Datenbankschema initialisieren:

npm install
npm run db:push:force
npm run db:rls

Die App ist unter http://<dein-host>:3000 erreichbar.

Profi-Tipp: Für automatisiertes Ersteinrichtungs-Setup füge einen Init-Schritt hinzu, der node node_modules/drizzle-kit/bin.cjs push --force && node scripts/apply-rls.mjs ausführt, bevor der App-Server startet. Siehe Produktionshärtung weiter unten.

Erforderliche Umgebungsvariablen

Die vollständige Tabelle findest du in der maßgeblichen Referenz Umgebungsvariablen. Mindestens vor dem Live-Gang nötig:

Deployment auf Coolify

1. Verbinde das eigen-Repository in Coolify.
2. Wähle Docker Compose als Build Pack (Coolify erkennt compose.yaml).
3. Füge Umgebungsvariablen aus Umgebungsvariablen hinzu.
4. Deploye und warte, bis beide Container gestartet sind.
5. Erstmigration — nutze den Execute Command-Befehl von Coolify auf dem Container eigen-app:

   npx drizzle-kit push --force && node scripts/apply-rls.mjs
   

Warum Docker Compose?

Die App benötigt PostgreSQL mit pgvector und AGE. Das eigenständige Dockerfile baut nur das App-Image. Docker Compose ist der richtige Build Pack.

Port-Mapping

Standard-Mappings in Compose: 3000:3000 (App), 5432:5432 (Postgres). Ändere das in docker-compose.yaml, falls es auf deinem Host zu Konflikten kommt.

Ersteinrichtung

Der Compose-Stack wendet Migrationen nicht bei jedem Start automatisch an. Nach dem ersten docker compose up:

# Von einer Maschine mit Netzwerkzugriff auf die DB:
DATABASE_URL="postgres://eigen:eigen@<dein-host>:5432/eigen" npx drizzle-kit push --force
DATABASE_URL="postgres://eigen:eigen@<dein-host>:5432/eigen" node scripts/apply-rls.mjs

Oder aus dem App-Container heraus:

docker compose exec app npx drizzle-kit push --force
docker compose exec app node scripts/apply-rls.mjs

Produktionshärtung

Vor dem Live-Gang:

1. Ändere alle Standard-Secrets (BETTER_AUTH_SECRET, TENANT_MASTER_KEY, DB-Passwörter).
2. Setze ORIGIN auf deine tatsächliche Domain.
3. Postgres-Port einschränken — entferne 5432:5432 aus Compose, damit die Datenbank nur intern erreichbar ist.
4. Nutze ein echtes LLM-Gateway mit OpenAI-kompatiblen Endpunkten /api/v1/chat/completions und /api/v1/embeddings.
5. Füge einen App-Healthcheck in compose.yaml hinzu:

app:
  healthcheck:
    test: ["CMD", "node", "-e", "fetch('http://localhost:3000/api/health').then(r => process.exit(r.ok?0:1))"]
    interval: 30s
    retries: 3

1. Pinne bei Bedarf den Node.js-Image-Patch (node:22-bookworm-slim im eigen-Dockerfile).

Entwicklung (lokal, ohne Container)

Führe diese Befehle im eigen-Repository aus:

npm install
cp .env.example .env
npm run db:up      # nur den Postgres-Container starten
npm run dev        # SvelteKit-Dev-Server auf :5173

Datenbank-Lifecycle-Befehle

Alle folgenden Befehle werden im eigen-Repository ausgeführt:

Problembehandlung

Siehe Problembehandlung für Deployment-, LLM- und MCP-Probleme.

Nächste Schritte

• Onboarding (Managed) — für Managed-Nutzer:innen
• Self-Hosted-Setup — Betreiber-Provisionierung
• MCP-Überblick — verbinde deinen Assistenten
• Wie das Gedächtnis funktioniert — Erfassen, Abruf, Konsolidierung

Lizenz

Apache-2.0. Siehe LICENSE im eigen-Repository.