112 lines
5.3 KiB
Markdown
112 lines
5.3 KiB
Markdown
|
# 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](Installation.md) - Schnellstart und erste Installation
|
||
|
|
- [Systemanforderungen](System-Requirements.md) - Voraussetzungen und Abhängigkeiten
|
||
|
|
- [Konfiguration](Configuration.md) - Konfigurationsoptionen
|
||
|
|
|
||
|
|
### Hauptfunktionen
|
||
|
|
- [Credentials-Management](Credentials-Management.md) - Verwaltung von Zugangsdaten
|
||
|
|
- [Workflow-Auto-Reload](Workflow-Auto-Reload.md) - Automatisches Workflow-Reload
|
||
|
|
- [Testing](Testing.md) - Test-Suites und Qualitätssicherung
|
||
|
|
|
||
|
|
### Komponenten
|
||
|
|
- [PostgreSQL & pgvector](PostgreSQL-pgvector.md) - Datenbank mit Vektor-Unterstützung
|
||
|
|
- [PostgREST](PostgREST.md) - REST API für PostgreSQL
|
||
|
|
- [n8n](n8n.md) - Workflow-Automation
|
||
|
|
- [Ollama Integration](Ollama-Integration.md) - KI-Modell-Integration
|
||
|
|
|
||
|
|
### Betrieb
|
||
|
|
- [Deployment](Deployment.md) - Produktiv-Deployment
|
||
|
|
- [Monitoring](Monitoring.md) - Überwachung und Logs
|
||
|
|
- [Backup & Recovery](Backup-Recovery.md) - Datensicherung
|
||
|
|
- [Troubleshooting](Troubleshooting.md) - Problemlösung
|
||
|
|
|
||
|
|
### Entwicklung
|
||
|
|
- [Architektur](Architecture.md) - System-Architektur
|
||
|
|
- [API-Referenz](API-Reference.md) - API-Dokumentation
|
||
|
|
- [Contributing](Contributing.md) - Beiträge zum Projekt
|
||
|
|
|
||
|
|
## 🚀 Schnellstart
|
||
|
|
|
||
|
|
```bash
|
||
|
|
# 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
|
||
|
|
|
||
|
|
- [GitHub Repository](https://backoffice.userman.de/MediaMetz/customer-installer)
|
||
|
|
- [Issue Tracker](https://backoffice.userman.de/MediaMetz/customer-installer/issues)
|
||
|
|
- [Changelog](../CHANGELOG_WORKFLOW_RELOAD.md)
|
||
|
|
|
||
|
|
## 📝 Lizenz
|
||
|
|
|
||
|
|
Dieses Projekt ist proprietär und für den internen Gebrauch bestimmt.
|
||
|
|
|
||
|
|
## 👥 Support
|
||
|
|
|
||
|
|
Bei Fragen oder Problemen:
|
||
|
|
1. Konsultieren Sie das [Troubleshooting](Troubleshooting.md)
|
||
|
|
2. Prüfen Sie die [FAQ](FAQ.md)
|
||
|
|
3. Erstellen Sie ein Issue im Repository
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
**Letzte Aktualisierung:** 2026-01-24
|
||
|
|
**Version:** 1.0.0
|