Zum Hauptinhalt springen

Installation und Einrichtung

Diese Seite führt Sie vom Nullpunkt bis zu einem arbeitsfähigen Workspace. Sie beschreibt die beiden Bereitstellungsarten und den Einrichtungsassistenten beim ersten Start.

Bereitstellungsart wählen​

ArtBedeutungGeeignet für
Cloud (verwaltet)Wir betreiben das AI Kit für Sie. Sie erhalten eine URL und eine Einladungs-E-Mail.Teams, die keinerlei Aufwand mit Infrastruktur haben möchten.
On-Premise (selbst betrieben)Sie betreiben das AI Kit auf Ihren eigenen Servern – in der Regel als einzelnen Docker-Container.Organisationen mit strengen Vorgaben zu Datenhaltung oder Compliance.

Für Endanwender ist die Bedienung identisch. Der einzige Unterschied ist, wo die Daten liegen und wer den Betrieb sicherstellt.

Wenn Sie die Cloud-Version nutzen, springen Sie direkt zu Der Einrichtungsassistent beim ersten Start.

Installation On-Premise​

Voraussetzungen​

  • Ein Linux-Server (oder ein beliebiger Host, auf dem Docker läuft). Für einen Pilotbetrieb genügt eine kleine virtuelle Maschine mit 4 CPU-Kernen und 8 GB RAM.
  • Ein dauerhafter Speicherort für die Daten des AI Kit – Konfiguration, Läufe, Inhalte der Wissensbasen. Planen Sie zu Beginn einige Gigabyte ein und erweitern Sie mit wachsender Nutzung.
  • Ausgehender Internetzugang, wenn Sie externe KI-Anbieter nutzen möchten (OpenAI, Anthropic, Mistral). Ist Ihre Umgebung vom Internet getrennt, können Sie stattdessen ein selbst betriebenes Ollama verwenden – siehe Modelle → Ollama (selbst betrieben).
  • Ein erreichbarer Hostname oder eine erreichbare IP-Adresse. Sollen Endanwender die Plattform von außerhalb des Netzwerks nutzen, schalten Sie einen TLS-fähigen Reverse Proxy davor.

Container starten​

Das AI Kit wird als einzelnes Docker-Image ausgeliefert, das die Anwendung und die Weboberfläche auf Port 3000 bereitstellt. Binden Sie ein Verzeichnis des Hosts als Datenvolume ein:

docker run -d \
  --name aikit \
  -p 3000:3000 \
  -v /opt/aikit/data:/data \
  -e AIKIT_CONFIG_DIR=/data/config \
  -e AIKIT_JOB_DIR=/data/job \
  schnelldigital/aikit:latest

Das Host-Verzeichnis (im Beispiel /opt/aikit/data) enthält den gesamten dauerhaften Zustand. Sichern Sie es genauso wie jeden anderen geschäftskritischen Datenbestand.

📷 SCREENSHOT: Ausgabe eines erfolgreichen docker run, gefolgt von der Startmeldung des AI Kit, dass es auf Port 3000 lauscht.

Oberfläche aufrufen​

Öffnen Sie http://<your-host>:3000/ im Browser. Beim allerersten Aufruf landen Sie im Einrichtungsassistenten.

Details zu Netzwerk und Ports – etwa welche Ports erreichbar sein müssen und welche ausgehenden Verbindungen das AI Kit benötigt – finden Sie unter Sicherheit → Netzwerkzugriff.

Sollen sich Personen mit ihrem Firmenkonto anmelden (Microsoft Entra ID, Google Workspace und andere OpenID-Connect-Anbieter) oder einen zweiten Faktor eingeben, lesen Sie Sicherheit → Single Sign-On und zweiter Faktor.

Der Einrichtungsassistent beim ersten Start​

Der Einrichtungsassistent startet beim ersten Aufruf und führt Sie durch alles, was die Installation braucht, bevor sie genutzt werden kann. Die Schritte stehen als Liste links; Sie können jederzeit zu einem Schritt zurückspringen, den Sie bereits gesehen haben – der Assistent führt Sie nie in eine Sackgasse.

Nicht jeder Schritt erscheint jedes Mal. Der Assistent zeigt nur die Schritte, die Ihre Situation tatsächlich erfordert, sowie die, die Sie in diesem Durchgang bereits besucht haben. Bei einer neuen Installation sehen Sie in der Regel alle; wer einer laufenden Installation einen weiteren Workspace hinzufügt, sieht nur die letzten drei.

📷 SCREENSHOT: Startseite des Einrichtungsassistenten mit der Liste der Schritte links.

Lizenz-Einrichtung​

Sie haben zwei Möglichkeiten:

  • Testphase starten – keine Lizenzdatei nötig, voller Funktionsumfang während des Testzeitraums.
  • Lizenzdatei hochladen – für produktive Installationen. Ihre Lizenzdatei haben Sie beim Kauf der Plattform erhalten.

Wird die hochgeladene Datei abgelehnt, nennt der Assistent den Grund – eine abgelaufene Datei oder eine, die für eine andere Installation ausgestellt wurde, wird als solche gemeldet und nicht stillschweigend übergangen.

Passt keine der beiden Möglichkeiten zu Ihrer Situation, wenden Sie sich direkt aus dem Assistenten an den Support.

Testmodus​

Erscheint, wenn die Installation mit einer Testlizenz läuft. Der Schritt erklärt die Einschränkungen und zeigt den Weg zum Upgrade. Nichts hier hält Sie auf; Sie können einfach weitergehen.

Erstellen Sie Ihr Admin-Konto​

Der erste Benutzer, der diese Installation verwaltet und alle anderen einladen kann.

  • E-Mail-Adresse – dient zugleich als Anmeldename.
  • Vollständiger Name und Bevorzugte Sprache.

Klicken Sie auf Konto erstellen. Danach wird ein Einmalpasswort an die Adresse geschickt; geben Sie es ein und klicken Sie auf Einmalpasswort bestätigen. Das Konto ist sofort angemeldet.

Nutzt die Installation Single Sign-On, wird kein Code verschickt: Der Assistent leitet Sie stattdessen zu Ihrem Anmeldeanbieter weiter. Verwenden Sie die E-Mail-Adresse, die Ihr Firmenkonto dort hat – nach der Anmeldung geht es im Assistenten weiter.

Sobald dieses Konto existiert, schließen sich die Einrichtungsschritte: Niemand kann ohne Anmeldung ein Konto anlegen oder die Lizenz ändern. Weitere Benutzer kommen per Einladung dazu, und spätere Lizenzänderungen erfordern einen Administrator.

Erstellen Sie Ihren Workspace​

  • Eine Workspace-URL – eine kurze, URL-taugliche Kennung (zum Beispiel acme). Das Feld normalisiert Ihre Eingabe: Leerzeichen und Sonderzeichen werden zu Bindestrichen, Großbuchstaben zu Kleinbuchstaben. Die Verfügbarkeit wird schon während der Eingabe geprüft, und der Hinweis unter dem Feld zeigt, welcher der drei Zustände gilt: wird geprüft, verfügbar oder bereits vergeben. Mindestens drei Zeichen.
  • Ein Workspace-Name – das, was Benutzer in der Workspace-Auswahl sehen (zum Beispiel „Acme Industries“).

Die Workspace-URL lässt sich später nicht mehr ändern – wählen Sie also etwas Dauerhaftes.

📷 SCREENSHOT: Der Workspace-Schritt des Einrichtungsassistenten; unter dem Feld „Workspace-URL“ steht „Dieser Key ist verfügbar“.

Modelle & Wissen einrichten​

Ein geführter Durchgang, in dem Sie Ihr erstes KI-Modell und optional Ihre erste Wissensbasis anbinden. Beides können Sie auch später in den jeweiligen Reitern erledigen – dieser Schritt ist ein Angebot, keine Hürde.

Erstellen Sie Ihren ersten Workflow​

Der letzte Schritt bietet an, eine erste Automation zu bauen oder direkt zum Dashboard zu wechseln. In beiden Fällen ist die Einrichtung danach abgeschlossen.

Empfehlungen​

  • ✅ Betreiben Sie das AI Kit hinter einem Reverse Proxy mit TLS. Browser und Webhooks funktionieren über HTTPS zuverlässiger.
  • ✅ Sichern Sie das Datenvolume im selben Rhythmus wie Ihre übrigen Geschäftsdaten.
  • ✅ Dokumentieren Sie die Workspace-URL und die E-Mail-Adresse des Admins außerhalb des AI Kit – sie sind der Schlüssel zur Wiederherstellung, falls Sie migrieren oder ein Backup einspielen müssen.
  • ⚠️ Wählen Sie die Workspace-URL mit Bedacht. Viele Dinge enthalten sie – URLs, Dateipfade, Webhook-Adressen –, und sie lässt sich nachträglich nicht ändern.
  • ⚠️ Der Testzeitraum ist großzügig, aber begrenzt. Laden Sie rechtzeitig vor Ablauf eine Lizenzdatei hoch; ohne gültige Lizenz wechselt der Workspace in einen schreibgeschützten Zustand.
  • ❌ Speichern Sie keine Geheimnisse in Umgebungsvariablen, die protokolliert oder eingecheckt werden. Verwenden Sie für Zugangsdaten in Automationen die eingebauten geschützten Felder der Plattform.
  • ❌ Löschen Sie keine Dateien direkt im Datenvolume. Entfernen Sie Automationen, Läufe oder Benutzer über die Administrationswerkzeuge der Plattform.

Nächste Schritte​