Installation

Installieren Sie Full On-Prem mit dem E-Mail-Konfigurationspaket und einer NVIDIA-GPU (online oder Air-Gap).

Installation

Wählen Sie den Weg, den Sie von Open Ticket AI erhalten haben.

Diese Seite beschreibt Full On-Prem. Ein Paket unterstützt OTOBO, Zammad oder KIX.

Voraussetzungen (Full On-Prem)

• Docker Engine 24+, Docker Compose v2 und NVIDIA Container Toolkit
• NVIDIA-GPU mit ≥ 24 GB VRAM (nvidia-smi aktiv)
• Konfigurationspaket (otai.yml) aus Ihrer E-Mail
• Ticketsystem-API-Zugriff (oder Air-Gap-Release-Bundle)
• ≥ 32 GB Host-RAM

Konfigurationspaket (aus Ihrer E-Mail)

Für Piloten oder Lizenzen senden wir:

1. otai.yml — Version, Ticketsystem und Umgebungsvariablen-Schlüsselnamen für den Lizenz-JWT und einen optionalen gehosteten LLM-API-Schlüssel.
2. Das Installationsskript.

Der Installer generiert API-Tokens und Passwörter automatisch. Verwenden Sie die in otai.yml angegebene Version.

Beispiel für otai.yml (Standard-Umgebungsschlüssel):

version: 0.2.0
ticket_system: otobo # otobo | zammad | kix
license_env_key: OTAI_LICENSE_KEY
llm_api_key_env_key: OTAI_LLM_API_KEY

Setzen Sie die Umgebungsvariablen vor der Installation:

export OTAI_LICENSE_KEY='eyJ...'           # JWT aus Ihrer Open Ticket AI E-Mail
export OTAI_LLM_API_KEY='sk-or-...'        # nur bei Nutzung eines gehosteten LLMs

$env:OTAI_LICENSE_KEY = 'eyJ...'
$env:OTAI_LLM_API_KEY = 'sk-or-...'

Fügen Sie Schlüssel nicht direkt in otai.yml ein.

Online-Installation

Setzen Sie die Umgebungsvariablen und führen Sie die Befehle auf dem GPU-Host aus:

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

install.sh:

1. Verifiziert Host-RAM, freien Speicherplatz und die NVIDIA-GPU.
2. Generiert .env, lädt Container-Images und kopiert Integrationspakete.
3. Startet die Compose-Dienste.
4. Installiert den Befehl otai für die CLI.
5. Konfiguriert optionale tägliche Backups (standardmäßig aktiviert).

Nicht-interaktive Installation

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

Air-Gap-Installation

1. Laden Sie das Air-Gap-Bundle auf einem verbundenen Host herunter:

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

2. Kopieren Sie otai-<version>/ und otai.yml auf den GPU-Server.

3. Führen Sie den Installer lokal aus:

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

Container validieren Lizenzen lokal ohne Netzwerkanfragen.

Nach der Installation

1. Öffnen Sie Studio in Ihrem Browser über die angezeigte URL.

2. Installieren Sie das OpenTicketAI-Add-on in OTOBO / Znuny (optional: OTAICustomerChat) oder das Frontend-Plugin für KIX.

3. Überprüfen Sie die Einrichtung:

   otai verify
   otai version

Falls otai nicht gefunden wird, fügen Sie ~/.local/bin zu Ihrem PATH hinzu.

Host-Anforderungen (bei der Installation geprüft)

Full On-Prem erfordert eine NVIDIA-GPU. Warnungen zu RAM oder Speicherplatz blockieren die Installation nicht.

Empfohlene Hardware-Konfigurationen

Anforderungen an die Bereitstellung:

• GPU: NVIDIA-GPU mit ≥ 24 GB VRAM (z. B. RTX PRO 4000 Blackwell oder NVIDIA L4)
• RAM: ≥ 32 GB empfohlen
• CPU: x86-64-Prozessor mit 4+ Kernen
• Speicher: ≥ 250 GB SSD

2U-Rack-Bauformen, redundante Netzteile, ECC-RAM und RAID 1 sind optionale Ausfallsicherheitsmerkmale. Die passive NVIDIA L4 erfordert Server-Luftstrom; Workstation-GPUs erfordern eine geprüfte Gehäuse-Stromversorgung und -Kühlung.

Beispielhafte Hardware-Konfigurationen (ohne kommerzielle Verbindungen):

• Tower: MIFCOM Workstation mit RTX PRO 4000 Blackwell
• Rack mit RTX PRO 4000 Blackwell: AIME A4004
• Rack mit NVIDIA L4: Thomas-Krenn 2U AMD GPU-Server

Stellen Sie mindestens 24 GB VRAM sicher (z. B. ist eine RTX 4000 Ada mit 20 GB nicht ausreichend).

Persistente Daten

Die Konfiguration verbleibt in otai.yml, Secrets in .otai/secrets.env. Das Compose-.env wird automatisch generiert. Ticketdaten verbleiben in Ihrem Ticketsystem.

Nächste Schritte

• Backups und Wiederherstellung
• Updates
• Handbuch-Übersicht