Guida introduttiva
Dall'installazione a uno stack RAG funzionante
Tre passaggi portano un deployment appena creato a uno stack RAG self-hosted attivo: attiva la tua licenza, collega il gateway API integrato al tuo Ollama locale e configura un provider di modelli.
- Admin ▸ License
- Acquista → paga
- Attivazione automatica
- Sovnex API ▸ console
- Aggiungi canale Ollama
- Crea un token
- Settings ▸ Providers
- Aggiungi Sovnex API
- Usa in Chat / RAG
Attiva la tua licenza
Ogni deployment viene fornito non attivato. Lo attivi una volta dalla admin console. Quando acquisti dal lato admin, l'attivazione è automatica — non copi mai un codice a mano.
Accedi alla admin console
Apri http://<your-host>/admin ed effettua l'accesso. Un'installazione pulita utilizza l'account admin predefinito admin@sovnex.io.
Apri License — indica "Not activated"
La pagina License mostra lo stato del deployment e un Install ID univoco. Fai clic su "Purchase a plan": questo trasferisce l'Install ID nel checkout, così la licenza si vincola esattamente a questo deployment.
Scegli un piano
La pagina dei prezzi si apre nel browser. Scegli un piano — prova gratuita di 7 giorni, Monthly o Annual. Il tuo Install ID viene trasferito nel link.
Registrati e verifica la tua email
Crea un account sul portale e conferma l'email di verifica. Puoi quindi accedere per completare l'acquisto.
Paga con la tua carta
Completa il checkout Stripe. Stai testando il flusso? La modalità di test di Stripe accetta la carta 4242 4242 4242 4242 con qualsiasi data di scadenza futura e qualsiasi CVC.
L'abbonamento diventa attivo
Il tuo account sul portale ora mostra Paid · active, il numero di postazioni e il Bound install (il tuo Install ID).
Il tuo deployment si attiva automaticamente
Tornando alla pagina admin License, lo stato passa a Valid entro circa 30 secondi — piano, postazioni e scadenza appaiono tutti. Nulla da copiare.
Collega il gateway API a Ollama locale
Sovnex include un gateway API integrato e OpenAI-compatible. Puntalo al tuo Ollama locale una volta e le richieste di ogni utente vengono instradate attraverso di esso — nessun endpoint per singolo utente da gestire.
Apri la console del gateway
Nella admin console, apri Sovnex API. Uno stato "Connected" verde significa che il gateway è integro. Fai clic su "Open management console" — ti autentica automaticamente in una nuova scheda.
Aggiungi un canale Ollama
Nella console vai su Channel → New Channel e imposta Type = Ollama. Base URL è http://ollama:11434 su Linux o http://host.docker.internal:11434 su macOS (Docker Desktop), Key può essere qualsiasi valore non vuoto (ad es. ollama) e Models devono essere i nomi reali dei tuoi modelli Ollama.
Salva e verifica il canale
Il canale appare come Enabled. Usa "Test Enabled Channels" per confermare che il gateway possa raggiungere Ollama ed eseguire un modello.
Crea un token API
Vai su Token e aggiungi un token. La sua key (inizia con sk-) è la chiave API che i tuoi utenti sovnexAI incolleranno nel provider di modelli nella prossima sezione.
Configura un provider di modelli
Ora permetti a un utente sovnexAI di consumare quei modelli attraverso il gateway. "Sovnex API" è un provider integrato, quindi il base URL è precompilato per te — usando qui il gateway come esempio.
Apri Model providers
Accedi all'app come utente, poi apri Settings → Model providers. "Sovnex API" si trova in cima all'elenco dei provider.
Aggiungi un modello tramite il gateway
Fai clic su Sovnex API → Add. Scegli il tipo di modello Chat, inserisci il nome del modello esattamente come nel gateway (qwen2.5:14b) e incolla il token del gateway (sk-…) come API-Key. Imposta Max tokens (ad es. 8192).
Impostalo come predefinito e inizia a usarlo
Il modello ora appare sotto "Added models". Selezionalo come tuo LLM predefinito (aggiungi nomic-embed-text come modello Embedding nello stesso modo). Ora è disponibile in Chat, Search e Agents.
