Aller au contenu
Cercle IA Tech · IA en local Un site du réseau Cercle IA Tech

Guide

Open WebUI avec Ollama : installer une interface locale

Donner une interface de discussion à votre LLM local : installer Open WebUI avec Docker ou pip, le relier à Ollama, gérer les comptes, lire la licence.

Mis à jour le

Open WebUI est une interface web de discussion qui se branche sur Ollama, ou sur tout serveur compatible avec l'interface d'OpenAI, et la met à disposition d'une équipe dans un navigateur, avec des comptes et des droits. La voie la plus courte d'après sa documentation : un conteneur Docker, ouvert ensuite sur http://localhost:3000, qui trouve Ollama sur la même machine. Ce qui suit vient de la documentation d'Open WebUI, lue le 15/11/2026.

Ce qu'Open WebUI apporte au-dessus d'Ollama

D'après la page des fonctions :

  • discussion avec Ollama ou tout fournisseur compatible avec l'interface d'OpenAI, depuis une seule interface ;
  • envoi de fichiers et bases de connaissances, que l'IA consulte pour répondre ;
  • rôles, groupes et droits par ressource ;
  • authentification fédérée par SSO, OIDC ou LDAP, pour utiliser les comptes de l'entreprise ;
  • recherche sur le Web avec citation des sources.

Cette dernière fonction envoie des requêtes à l'extérieur : à décider en fonction de vos règles de confidentialité (voir IA locale et confidentialité).

Installer avec Docker

La documentation décrit une commande docker run dont voici les éléments :

Élément Rôle
image ghcr.io/open-webui/open-webui:main l'application
-p 3000:8080 l'interface répond sur le port 3000 de la machine
volume monté sur /app/backend/data conserve comptes, conversations et réglages
--add-host=host.docker.internal:host-gateway permet au conteneur de joindre Ollama qui tourne sur la machine
variable WEBUI_SECRET_KEY clé secrète, générée par exemple avec openssl rand -hex 32

La commande complète est dans le guide de démarrage. Deux variantes d'image :

  • :cuda pour une carte NVIDIA (CUDA 12.8), en ajoutant --gpus all ;
  • :ollama, qui embarque Ollama dans le même conteneur.

Ouvrez ensuite http://localhost:3000.

Installer avec pip

pip install open-webui
open-webui serve

L'interface répond alors sur http://localhost:8080. Attention à la version de Python : la documentation indique Python 3.11 et 3.12, et précise que Python 3.13 n'est pas pris en charge.

Relier Open WebUI à Ollama

D'après la page de connexion à Ollama, Open WebUI tente de se connecter seul à votre instance Ollama au démarrage. Si cela échoue :

  1. ouvrez Settings > Connections dans la partie administration ;
  2. sous Manage Ollama API Connections, réglez l'adresse ; depuis Docker, avec Ollama sur la machine hôte, utilisez http://host.docker.internal:11434 ;
  3. pour télécharger un modèle sans passer par le terminal, cliquez sur Manage puis Pull a model from Ollama.com, ou tapez son nom dans le sélecteur de modèles.

Si Ollama tourne sur un autre serveur, il doit être joignable depuis la machine d'Open WebUI : voir Ollama sur un serveur.

Les comptes : le point à ne pas rater

D'après le guide de démarrage, le premier compte créé est l'administrateur : il gère les utilisateurs et tous les réglages de l'instance. L'inscription se ferme une fois ce compte créé. Créez-le vous-même juste après l'installation, avant d'ouvrir l'adresse aux collègues.

La référence des variables indique que ENABLE_SIGNUP active ou non la création de comptes (vrai par défaut) et que DEFAULT_USER_ROLE fixe le rôle des nouveaux utilisateurs, pending par défaut : un nouvel inscrit attend donc qu'un administrateur l'active.

La licence

La page de licence indique que depuis la version 0.6.6 (19/04/2025), Open WebUI est publié sous l'« Open WebUI License ». Vous ne pouvez pas modifier, retirer ou masquer la marque Open WebUI, sauf exceptions :

  • 50 utilisateurs ou moins sur une période de 30 jours ;
  • contributeur substantiel avec accord écrit préalable ;
  • licence entreprise qui autorise explicitement le changement de marque.

Le code jusqu'à la version 0.6.5 incluse reste sous licence BSD-3-Clause. Si vous comptez habiller l'interface aux couleurs de l'entreprise pour une grande équipe, lisez cette page avec la personne qui suit vos contrats.

Et les documents de l'entreprise ?

Open WebUI permet d'envoyer des fichiers et de constituer des bases de connaissances. Pour comprendre ce qui se passe derrière (découpage, plongements, base vectorielle) et monter une chaîne entièrement locale, voir la page RAG en local et open source du site consacré au RAG.

Questions fréquentes

Sur quelle adresse ouvrir Open WebUI ?

http://localhost:3000 avec l'installation Docker de la documentation, http://localhost:8080 avec l'installation par pip.

Quelle version de Python pour Open WebUI ?

La documentation indique Python 3.11 et 3.12, et précise que Python 3.13 n'est pas pris en charge.

Open WebUI est-il gratuit pour une entreprise ?

Depuis la version 0.6.6 du 19/04/2025, il est publié sous l'« Open WebUI License », qui interdit de retirer la marque Open WebUI, sauf exceptions dont celle d'avoir 50 utilisateurs ou moins sur 30 jours. Le code jusqu'à la 0.6.5 reste sous licence BSD-3-Clause.

Sources

Pages consultées pour écrire cet article :

  1. https://docs.openwebui.com/getting-started/quick-start/
  2. https://docs.openwebui.com/getting-started/quick-start/connect-a-provider/starting-with-ollama
  3. https://docs.openwebui.com/features/
  4. https://docs.openwebui.com/license/
  5. https://docs.openwebui.com/reference/env-configuration/

À lire aussi