Open WebUI

Déployer Open WebUI et gérer la connexion serveur en administrateur.

Installation et préparation

Installez Docker puis suivez le démarrage rapide Open WebUI ou exécutez la commande ci-dessous. Conservez le volume nommé pour préserver comptes et paramètres. Ouvrez http://localhost:3000 et créez le premier compte administrateur. Créez la clé de connexion sur routerra.ai Keys et relevez un ID autorisé dans la liste de la passerelle.

Configurer la connexion

En tant qu’administrateur, ouvrez Settings → Admin → Connections → Manage OpenAI API Connections → Add Connection. URL : https://routerra.ai/v1 ; API Key : YOUR_API_KEY. Activez et enregistrez le type compatible OpenAI par défaut. Les modèles proviennent normalement de /models ; sinon, ajoutez YOUR_MODEL_ID à la liste autorisée Model IDs. Cette connexion serveur est partagée selon les droits de l’instance, contrairement aux Direct Connections personnelles du navigateur.

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

Choisir un modèle et résoudre les erreurs

Sélectionnez YOUR_MODEL_ID dans un nouveau chat. S’il manque, vérifiez activation et liste autorisée, puis enregistrez pour actualiser. Les valeurs en base peuvent remplacer OPENAI_API_BASE_URL et OPENAI_API_KEY au redémarrage : modifiez la connexion Admin. ENABLE_PERSISTENT_CONFIG=False impose l’environnement mais empêche la persistance des modifications Admin. En cas d’erreur réseau, consultez docker logs open-webui et vérifiez le HTTPS sortant du conteneur.