Erste Schritte
Von der Installation zu einem funktionierenden RAG-Stack
In drei Schritten wird aus einem frischen Deployment ein aktiver, selbst gehosteter RAG-Stack: Aktivieren Sie Ihre Lizenz, verbinden Sie das integrierte API-Gateway mit Ihrem lokalen Ollama und konfigurieren Sie einen Modellanbieter.
- Admin ▸ License
- Kaufen → bezahlen
- Aktiviert automatisch
- Sovnex API ▸ Konsole
- Ollama-Channel hinzufügen
- Token erstellen
- Settings ▸ Providers
- Sovnex API hinzufügen
- In Chat / RAG nutzen
Aktivieren Sie Ihre Lizenz
Jedes Deployment wird unaktiviert ausgeliefert. Sie aktivieren es einmal über die admin console. Wenn Sie auf der Admin-Seite kaufen, erfolgt die Aktivierung automatisch — Sie kopieren niemals einen Code von Hand.
Melden Sie sich an der admin console an
Öffnen Sie http://<your-host>/admin und melden Sie sich an. Eine frische Installation verwendet das Standard-Admin-Konto admin@sovnex.io.
Öffnen Sie License — es zeigt "Not activated" an
Die License-Seite zeigt den Deployment-Status und eine eindeutige Install ID an. Klicken Sie auf "Purchase a plan": Dadurch wird diese Install ID in den Checkout übernommen, sodass sich die Lizenz an genau dieses Deployment bindet.
Wählen Sie einen Plan
Die Preisseite öffnet sich in Ihrem Browser. Wählen Sie einen Plan — 7 Tage Free Trial, Monthly oder Annual. Ihre Install ID wird im Link mitgeführt.
Registrieren Sie sich und bestätigen Sie Ihre E-Mail
Erstellen Sie ein Portalkonto und bestätigen Sie die Verifizierungs-E-Mail. Anschließend können Sie sich anmelden, um den Kauf abzuschließen.
Bezahlen Sie mit Ihrer Karte
Schließen Sie den Stripe-Checkout ab. Möchten Sie den Ablauf testen? Der Stripe-Testmodus akzeptiert die Karte 4242 4242 4242 4242 mit einem beliebigen zukünftigen Ablaufdatum und einer beliebigen CVC.
Das Abonnement wird aktiv
Ihr Portalkonto zeigt jetzt Paid · active, die Anzahl der Sitze und den Bound install (Ihre Install ID) an.
Ihr Deployment aktiviert sich automatisch
Zurück auf der admin License-Seite wechselt der Status innerhalb von etwa 30 Sekunden auf Valid — Plan, Sitze und Ablaufdatum werden alle angezeigt. Es gibt nichts zu kopieren.
Verbinden Sie das API-Gateway mit dem lokalen Ollama
Sovnex liefert ein integriertes, OpenAI-compatible API-Gateway. Richten Sie es einmal auf Ihr lokales Ollama aus, und die Anfragen aller Benutzer werden darüber geleitet — keine benutzerspezifischen Endpunkte zu verwalten.
Öffnen Sie die Gateway-Konsole
Öffnen Sie in der admin console Sovnex API. Ein grüner "Connected"-Status bedeutet, dass das Gateway einwandfrei funktioniert. Klicken Sie auf "Open management console" — dadurch werden Sie automatisch in einem neuen Tab angemeldet.
Fügen Sie einen Ollama-Channel hinzu
Gehen Sie in der Konsole zu Channel → New Channel und setzen Sie Type = Ollama. Base URL ist http://ollama:11434 unter Linux oder http://host.docker.internal:11434 unter macOS (Docker Desktop), Key kann ein beliebiger nicht-leerer Wert sein (z. B. ollama), und Models müssen Ihre echten Ollama-Modellnamen sein.
Speichern und überprüfen Sie den Channel
Der Channel erscheint als Enabled. Verwenden Sie "Test Enabled Channels", um zu bestätigen, dass das Gateway Ollama erreichen und ein Modell ausführen kann.
Erstellen Sie einen API-Token
Gehen Sie zu Token und fügen Sie einen Token hinzu. Sein Schlüssel (beginnt mit sk-) ist der API-Schlüssel, den Ihre sovnexAI-Benutzer im nächsten Abschnitt in den Modellanbieter einfügen werden.
Konfigurieren Sie einen Modellanbieter
Lassen Sie nun einen sovnexAI-Benutzer diese Modelle über das Gateway nutzen. "Sovnex API" ist ein integrierter Anbieter, sodass die Base URL bereits für Sie vorausgefüllt ist — hier wird das Gateway als Beispiel verwendet.
Öffnen Sie Model providers
Melden Sie sich als Benutzer an der App an und öffnen Sie dann Settings → Model providers. "Sovnex API" steht ganz oben in der Anbieterliste.
Fügen Sie ein Modell über das Gateway hinzu
Klicken Sie auf Sovnex API → Add. Wählen Sie den Modelltyp Chat, geben Sie den Modellnamen genau wie im Gateway ein (qwen2.5:14b) und fügen Sie den Gateway-Token (sk-…) als API-Key ein. Legen Sie Max tokens fest (z. B. 8192).
Legen Sie es als Standard fest und beginnen Sie mit der Nutzung
Das Modell erscheint jetzt unter "Added models". Wählen Sie es als Ihr Standard-LLM (fügen Sie nomic-embed-text auf die gleiche Weise als Embedding-Modell hinzu). Es ist jetzt in Chat, Search und Agents verfügbar.
