Customer Installer - Wiki

Willkommen zum Customer Installer Wiki! Dieses System automatisiert die Bereitstellung von LXC-Containern mit einem vollständigen RAG (Retrieval-Augmented Generation) Stack.

📚 Inhaltsverzeichnis

Erste Schritte

Installation - Schnellstart und erste Installation
Systemanforderungen - Voraussetzungen und Abhängigkeiten
Konfiguration - Konfigurationsoptionen

Hauptfunktionen

Credentials-Management - Verwaltung von Zugangsdaten
Workflow-Auto-Reload - Automatisches Workflow-Reload
Testing - Test-Suites und Qualitätssicherung

Komponenten

PostgreSQL & pgvector - Datenbank mit Vektor-Unterstützung
PostgREST - REST API für PostgreSQL
n8n - Workflow-Automation
Ollama Integration - KI-Modell-Integration

Betrieb

Deployment - Produktiv-Deployment
Monitoring - Überwachung und Logs
Backup & Recovery - Datensicherung
Troubleshooting - Problemlösung

Entwicklung

Architektur - System-Architektur
API-Referenz - API-Dokumentation
Contributing - Beiträge zum Projekt

🚀 Schnellstart

# Installation durchführen
./install.sh --storage local-zfs --bridge vmbr0 --ip dhcp --vlan 90

# Credentials werden automatisch gespeichert
cat credentials/sb-<timestamp>.json

# Tests ausführen
./test_complete_system.sh <ctid> <ip> <hostname>

🎯 Hauptmerkmale

✅ Automatische LXC-Container-Erstellung mit Debian 12
✅ Docker-basierter Stack (PostgreSQL, PostgREST, n8n)
✅ pgvector-Integration für Vektor-Embeddings
✅ Supabase-kompatible REST API via PostgREST
✅ n8n Workflow-Automation mit RAG-Workflow
✅ Ollama-Integration für KI-Modelle
✅ Credentials-Management mit automatischem Speichern
✅ Workflow Auto-Reload bei Container-Neustart
✅ Umfassende Test-Suites (40+ Tests)
✅ NGINX Reverse Proxy Integration

📊 System-Übersicht

┌─────────────────────────────────────────────────────────┐
│                    Proxmox Host                         │
│  ┌───────────────────────────────────────────────────┐  │
│  │              LXC Container (Debian 12)            │  │
│  │  ┌─────────────────────────────────────────────┐  │  │
│  │  │           Docker Compose Stack              │  │  │
│  │  │                                             │  │  │
│  │  │  ┌──────────────┐  ┌──────────────┐         │  │  │
│  │  │  │  PostgreSQL  │  │  PostgREST   │         │  │  │
│  │  │  │  + pgvector  │◄─┤  (REST API)  │         │  │  │
│  │  │  └──────────────┘  └──────────────┘         │  │  │
│  │  │         ▲                  ▲                │  │  │
│  │  │         │                  │                │  │  │
│  │  │  ┌──────┴──────────────────┘                │  │  │
│  │  │  │         n8n                              │  │  │
│  │  │  │  (Workflow Automation)                   │  │  │
│  │  │  └──────────────────────────────────────────┘  │  │
│  │  └─────────────────────────────────────────────┘  │  │
│  └───────────────────────────────────────────────────┘  │
└─────────────────────────────────────────────────────────┘
                         │
                         ▼
              ┌──────────────────┐
              │  Ollama Server   │
              │  (External)      │
              └──────────────────┘

🔗 Wichtige Links

📝 Lizenz

Dieses Projekt ist proprietär und für den internen Gebrauch bestimmt.

👥 Support

Bei Fragen oder Problemen:

Konsultieren Sie das Troubleshooting
Prüfen Sie die FAQ
Erstellen Sie ein Issue im Repository

Letzte Aktualisierung: 2026-01-24
Version: 1.0.0