Installation
Alles über die Installation von OnPrem AI: was genau passiert, welche Fragen gestellt werden und wie du Domain, Zertifikat und Branding gleich richtig einstellst.
2 Min. Lesezeit Kapitel 4
Vor der Installation#
Stelle sicher, dass:
- der Server die Systemanforderungen erfüllt,
- du deinen Lizenzschlüssel zur Hand hast,
- du weisst, unter welcher Domain die Plattform erreichbar sein soll, zum Beispiel
ki.firma.ch.
Die Domain ist optional. Ohne Domain ist die Plattform nur direkt auf dem Server erreichbar, was für einen ersten Test genügt.
Das Werkzeug installieren#
curl -fsSL https://ai.schaefersoft.ch/install | sh
Das Installationsskript lädt die aktuelle Version von aictl, prüft deren Echtheit und legt sie auf dem Server ab. Das Werkzeug selbst ist frei herunterladbar, die Lizenz wird erst bei der Aktivierung geprüft.
Die Plattform installieren#
sudo aictl install --license LIC-XXXX-XXXX-XXXX-XXXX
Die Installation ist interaktiv und fragt nach allem, was sie wissen muss. Du kannst die Antworten auch direkt als Optionen mitgeben, das ist praktisch für automatisierte Installationen.
Was bei der Installation passiert#
- Der Server wird geprüft: Betriebssystem, Prozessor, Grafikkarte und Speicher.
- Deine Lizenz wird aktiviert und fest an diesen Server gebunden.
- Fehlende Systembestandteile werden automatisch installiert.
- Die Plattform wird heruntergeladen, eingerichtet und gestartet.
- Firmen-Login, KI-Zentrale und Automationen werden miteinander verbunden.
- Bereits gekaufte Erweiterungen werden eingerichtet.
- Ein Hintergrunddienst sorgt dafür, dass die Plattform nach einem Neustart automatisch wieder läuft.
Beim ersten Mal dauert das einige Minuten. Am Ende siehst du eine Zusammenfassung mit allen Adressen und den nächsten Schritten.
Die wichtigsten Optionen#
| Option | Bedeutung |
|---|---|
--license |
Dein Lizenzschlüssel. Bei einer erneuten Installation wird der gespeicherte Schlüssel verwendet. |
--base-domain |
Die Domain für alle Dienste, zum Beispiel ki.firma.ch. |
--tls-mode |
auto für automatische Zertifikate oder provided für ein eigenes Firmenzertifikat. |
--acme-email |
E-Mail-Adresse für die automatischen Zertifikate. |
--dns-provider |
Dein DNS-Anbieter, zum Beispiel cloudflare, für automatische Zertifikate. |
--internal |
Die Plattform ist nur im internen Netz erreichbar. |
--auth-admin-email |
E-Mail-Adresse des ersten Administrators. |
--brand-name |
Dein Firmenname, der überall in der Plattform erscheint. |
--brand-logo-url, --brand-favicon-url |
Logo und Favicon als PNG oder JPEG. |
Alle Optionen findest du in der CLI-Referenz.
Domain und Zertifikate#
Mit einer Domain erhält jeder Dienst eine eigene Adresse, zum Beispiel chat.ki.firma.ch. Die Verbindung ist immer verschlüsselt. Für das Zertifikat gibt es zwei Wege:
- Automatisch: Die Plattform holt sich ein kostenloses Zertifikat bei Let's Encrypt und erneuert es selbstständig. Dazu braucht sie Zugriff auf deinen DNS-Anbieter.
- Eigenes Zertifikat: Du hinterlegst ein Zertifikat deiner Firma.
Details stehen unter Domain und Zertifikate.
Branding#
OnPrem AI zeigt deinen Firmennamen und dein Logo in Chat und Erweiterungen. Verwende ein Logo im Format PNG oder JPEG, das auf weissem Hintergrund gut lesbar ist. Ändern kannst du das Branding jederzeit mit aictl brand edit.
Erneut ausführen#
Die Installation kann beliebig oft wiederholt werden. Sie übernimmt deine bisherigen Einstellungen und bringt nur in Ordnung, was fehlt oder falsch ist. Das ist auch der einfachste Weg, wenn nach einer Störung etwas nicht mehr stimmt.
Wichtig: Deine Einstellungen werden in
/etc/aictl/spec.yamlgespeichert. Diese Datei solltest du nicht von Hand bearbeiten, sondern die entsprechenden Befehle verwenden.
Nicht gefunden, was du suchst?
Unser Support hilft dir gerne weiter.