Installation

Full On-Prem mit Config-Paket und NVIDIA-GPU installieren (online oder Air-Gap).

Installation

Wählen Sie den Weg, der zu dem passt, was Sie von Open Ticket AI erhalten haben.

Diese Seite beschreibt nur Full On-Prem. Ein Softwarepaket bedient alle Ticketsysteme; Ihre E-Mail-Konfiguration setzt bereits OTOBO, Zammad oder KIX.

Voraussetzungen (Full On-Prem)

• Docker Engine 24+, Docker Compose v2 und das NVIDIA Container Toolkit
• Eine NVIDIA-GPU mit ≥ 24 GB VRAM (nvidia-smi muss auf dem Host funktionieren)
• Das Config-Paket aus Ihrer Open-Ticket-AI-E-Mail (otai.yml)
• Netzwerkzugriff auf die API Ihres Ticketsystems (oder eine Offline-Kopie des Releases)
• Genügend Host-RAM für Runtime + lokales LLM (typisch ≥ 32 GB auf GPU-Hosts)

Config-Paket (aus Ihrer E-Mail)

Für Pilot oder Volllizenz senden wir:

1. otai.yml — Lizenzschlüssel, feste Version und Ticketsystem (Site-Config)
2. Den Installations-Einzeiler unten

Erfinden Sie keine API-Tokens oder Connector-Passwörter — der Installer erzeugt sie (siehe LD-043). Die Lizenz-JWT enthält außerdem erlaubte Softwareversionen (min_version / max_version). Nutzen Sie die Version in otai.yml — raten Sie nicht.

Beispiel otai.yml (Werte von uns ausgefüllt):

license_key: eyJ...
version: 0.2.0
ticket_system: otobo # otobo | zammad | kix

Online-Installation

Auf dem GPU-Host mit Internet otai.yml ins Arbeitsverzeichnis legen, dann:

curl -fsSL https://download.openticketai.com/download.sh | bash -s -- --bundle online
cd otai-*   # entpacktes Release-Verzeichnis
cp ../otai.yml ./otai.yml   # falls die Datei neben dem Download lag
./install.sh

install.sh:

1. Prüft Host-RAM, freien Speicherplatz und NVIDIA-GPU (GPU ist für Full On-Prem Pflicht).
2. Erzeugt Compose-.env aus otai.yml + generierten Geheimnissen, lädt Docker-Image-Tars, kopiert Ticketsystem-Pakete.
3. Startet Compose.
4. Installiert den Befehl otai in Ihrem PATH (kein ./otai nötig).
5. Fragt, ob tägliche Backups aktiviert werden sollen — Ja ist die Voreinstellung.

Nicht-interaktive Installation

export OTAI_INSTALL_ASSUME_YES=1
export OTAI_ENABLE_BACKUPS=1          # Standard; 0 zum Überspringen
export OTAI_BACKUP_SCHEDULE=daily     # daily | weekly
./install.sh

Air-Gap-Installation

1. Auf einem verbundenen Rechner das Air-Gap-Bundle herunterladen (Version aus otai.yml):

   export OTAI_VERSION=0.2.0   # wie version: in otai.yml
   export OTAI_LICENSE_KEY='eyJ...'
   curl -fsSL https://download.openticketai.com/download.sh | bash -s -- --bundle airgap

2. Das entpackte Verzeichnis otai-<version>/ und otai.yml auf den Offline-GPU-Server kopieren.

3. Auf dem Offline-Server:

   cd /path/to/otai-<version>
   cp /path/to/otai.yml ./otai.yml
   # optional: OTAI_OLLAMA_MODELS_DIR=/path/to/ollama/models
   ./install.sh

Air-Gap-Installationen rufen die Download-API nicht erneut auf. Die Container prüfen die Lizenz lokal beim Start.

Nach der Installation

1. Öffnen Sie Studio im Browser (URL vom Installer / Compose).

2. Installieren Sie die Ticketsystem-Add-on-Pakete aus install-packages/ in OTOBO / Zammad / KIX, soweit für Ihr System nötig (das Connector-Passwort wurde bereits für Studio/Runtime erzeugt).

3. Gesundheit prüfen (mit otai, nicht ./otai):

   otai verify
   otai version

Wenn otai nicht gefunden wird, fügen Sie ~/.local/bin zu Ihrem PATH hinzu (der Installer gibt die genaue Zeile aus, wenn er den User-Wrapper installiert).

Host-Anforderungen (bei der Installation geprüft)

Ohne passende NVIDIA-GPU wird Full On-Prem nicht unterstützt. Warnungen zu RAM oder Speicher blockieren die Installation nicht, es sei denn, Sie lehnen das Fortfahren ab.

Persistente Daten

Site-Werte liegen in otai.yml. Geheimnisse in .otai/secrets.env. Die Compose-.env wird daraus erzeugt — nicht von Hand bearbeiten. Ticketinhalte bleiben in der Datenbank Ihres Ticketsystems.

Nächste Schritte

• Backups und Wiederherstellung
• Updates
• Handbuch (Übersicht)