Skip to main content
Diese Anleitung beschreibt die Installation von VARIOS AI auf einem eigenen Linux-Server. VARIOS AI läuft als Docker-Compose-Installation; die Installationsdateien docker-compose.yml, .env, varios.sh und update_version erhalten Sie vom VARIOS-AI-Team. Prüfen Sie vorab die Systemvoraussetzungen.
Rechnen Sie für die technische Installation mit einem halben Arbeitstag. Die meiste Zeit entfällt auf Abstimmungen mit DNS-, Firewall- und Identitätsteam, planen Sie diese vorab ein.

Installation

1

Server vorbereiten

Spielen Sie die aktuellen Updates Ihrer Distribution ein, aktivieren Sie die Zeitsynchronisation und richten Sie die Firewall nach den Systemvoraussetzungen ein. Eine korrekte Uhrzeit ist für Anmeldung und Zertifikate zwingend.
2

Docker installieren

Installieren Sie Docker Engine und Docker Compose v2 nach der Anleitung Ihrer Distribution oder mit dem offiziellen Skript, und aktivieren Sie den Autostart.
3

Installationsverzeichnis anlegen

Legen Sie ein Verzeichnis an, zum Beispiel /docker/variosai, und kopieren Sie die vier Installationsdateien hinein. In diesem Verzeichnis entstehen später auch Datenbank, Dateien und Backups, sichern Sie es entsprechend.
4

.env anpassen

Die gelieferte .env enthält Vorgaben. Passen Sie mindestens diese Werte an:
Die .env enthält Passwörter und Geheimnisse. Geben Sie sie nicht weiter und nehmen Sie sie in jedes Backup auf.
5

HTTPS festlegen

Standardmäßig holt VARIOS AI das Zertifikat automatisch über Let’s Encrypt. Dafür müssen PROJECT_DOMAIN auf den Server zeigen und die Ports 80 und 443 aus dem Internet erreichbar sein. Weitere Vorbereitungen sind nicht nötig, die Zertifikatsdateien werden beim ersten Start automatisch angelegt.Soll stattdessen ein eigenes Zertifikat verwendet werden, folgen Sie Eigenes HTTPS-Zertifikat konfigurieren. Für einen vorgelagerten Reverse-Proxy Ihres Unternehmens sprechen Sie den Support an.
6

An der Container-Registry anmelden

Die Zugangsdaten erhalten Sie vom VARIOS-AI-Team. Die Anmeldung bleibt auf dem Server gespeichert und ist nach einem Serverwechsel zu wiederholen.
7

Dienste starten

Der erste Start lädt alle Images und dauert einige Minuten. Anschließend sollten alle Dienste als running oder healthy gelistet sein.
8

Datenbank einrichten

Das Skript legt die Datenbank an, lädt die Vorlagenbibliothek und bereitet die Anwendung vor. Beim ersten Lauf kann das 15 bis 60 Minuten dauern, brechen Sie es nicht ab. Es prüft dabei auch, ob der Prozessor AVX2 unterstützt.
Danach ist VARIOS AI unter https://<PROJECT_DOMAIN> erreichbar.
9

Anmelden und Lizenz eintragen

Melden Sie sich mit einem Konto an, das im Identitätsanbieter die Rolle aus SUPERADMIN_GROUP_NAME trägt. Tragen Sie den Lizenzschlüssel vom VARIOS-AI-Team unter Administration → Einstellungen → Systeminformationen ein.
10

Update-Helfer einrichten

varios.sh führt die Updates aus, die Sie in der Oberfläche anstoßen. Richten Sie ihn als systemd-Dienst ein, damit er nach einem Neustart weiterläuft, siehe systemd-Dienst.
Der Update-Helfer entfernt nach jedem Update ungenutzte Docker-Images und -Volumes des gesamten Servers. Betreiben Sie keine weiteren Docker-Anwendungen auf demselben Server.

Updates

Updates stoßen Sie unter Administration → Einstellungen → Systeminformationen an. Dort sehen Sie, ob eine neue Version verfügbar ist, und wählen die Zielversion; der Update-Helfer varios.sh führt das Update aus. Planen Sie dafür ein Wartungsfenster, während des Updates ist VARIOS AI einige Minuten nicht erreichbar. Erstellen Sie vor jedem Update einen Snapshot oder ein Backup, siehe Backup und Wiederherstellung.

Prüfung nach der Installation

  • https://<PROJECT_DOMAIN> öffnet ohne Zertifikatswarnung.
  • Anmeldung mit einem normalen Konto und mit einem Administratorkonto funktioniert, das Menü Administration ist sichtbar.
  • Lizenzschlüssel eingetragen, keine Lizenzmeldung.
  • Ein Testchat wird beantwortet.
  • Update-Helfer läuft als systemd-Dienst, tägliche Datenbank-Sicherungen erscheinen unter PostgresBackups.

Fehlersuche