Open WebUI

Distribuisci Open WebUI e gestisci la connessione come amministratore.

Installazione e preparazione

Installa Docker e segui l’avvio rapido di Open WebUI oppure esegui il comando seguente. Conserva il volume dati per mantenere account e impostazioni. Apri http://localhost:3000 e crea il primo account amministratore. Crea la chiave in routerra.ai Keys e scegli un ID consentito dalla lista del gateway.

Configurare la connessione

Come amministratore apri Settings → Admin → Connections → Manage OpenAI API Connections → Add Connection. URL: https://routerra.ai/v1; API Key: YOUR_API_KEY. Abilita e salva il tipo compatibile OpenAI predefinito. I modelli arrivano normalmente da /models; altrimenti inserisci YOUR_MODEL_ID nella lista consentita Model IDs. Questa connessione server è condivisa secondo i permessi dell’istanza, a differenza delle Direct Connections personali del browser.

docker run -d --name open-webui -p 3000:8080 \
  -v open-webui:/app/backend/data \
  --restart always ghcr.io/open-webui/open-webui:main

Scegliere un modello e risolvere gli errori

Seleziona YOUR_MODEL_ID in una nuova chat. Se manca, controlla attivazione e lista consentita, poi salva per aggiornare. I valori nel database possono prevalere su OPENAI_API_BASE_URL e OPENAI_API_KEY al riavvio: modifica la connessione Admin. ENABLE_PERSISTENT_CONFIG=False impone l’ambiente ma rende temporanee le modifiche Admin. Per errori di rete controlla docker logs open-webui e l’HTTPS in uscita dal container.