Open WebUI pour débutants : installer avec Ollama

Par Emmanuel Sauvage · Publié le · Mis à jour le

Cette page peut contenir des liens partenaires Amazon : si vous achetez après un clic, le site peut percevoir une commission sans surcoût pour vous. Nos conseils restent indépendants. En savoir plus.

Docker seul : comptez 45 min ; +20 min si annexe pip (réseau foyer : voir encart après le premier chat).

Open WebUI est une interface web conviviale qui se branche sur Ollama (moteur qui exécute des LLM, large language models, modèles de langage sur votre PC). Au lieu de taper dans un terminal, chaque membre du foyer ouvre une page dans le navigateur. Ce guide suit un fil unique : Docker + Ollama sur la durée ci-dessus. Il suppose qu’Ollama est déjà installé (Windows, multi-OS ou 15 minutes).

Pour qui Parcours Durée Prérequis
Débutant, Docker déjà présent Sections 1 à 4 ci-dessous 45 min (Docker seul) Ollama actif, 16 Go RAM
Sans Docker Annexe pip après le tableau comparatif +20 min (≈ 65 min total) Python 3.10+
Famille sur tablettes Encart réseau après le premier chat réussi +10 min en plus Installation Docker ou pip validée

Sommaire

Prérequis

Élément Détail
Ollama Service actif, port par défaut 11434 — installer Ollama si besoin
RAM 16 Go minimum, 32 Go conseillés pour un modèle 7B–8B (RAM 32/64)
Droits Administrateur pour installer Docker ou Python
Réseau Internet pour télécharger Open WebUI une fois ; usage chat possible hors ligne ensuite
Modèle Au moins un modèle déjà téléchargé (choisir premier modèle)
Disque Espace pour images Docker ou venv (SSD modèles si vous cumulez les GGUF)

Docker ou pip : tableau comparatif

Critère Docker pip / binaire natif
Simplicité si Docker déjà là ★★★ ★★
Prérequis Docker Desktop ou moteur Linux Python 3.10+ ou paquet officiel
Mises à jour docker pull (voir annexe mise à jour) Commande ou installeur selon doc
Isolation réseau Peut causer erreurs CORS (Cross-Origin Resource Sharing, règles d’accès entre navigateur et API) si mal configuré Souvent plus simple en local pur
Famille Stack proche de Docker Ollama + Open WebUI Moins de conteneurs

Barème simplicité : ★ = parcours long ou dépendances nombreuses ; ★★ = quelques commandes supplémentaires ; ★★★ = peu d’étapes une fois l’outil de base installé.

Sans Docker, ouvrez l’annexe pip — ne mélangez pas les deux méthodes sur la même machine sans arrêter l’autre service.

Étapes d’installation (Docker — recommandé si Docker est installé)

  1. Vérifier Ollama — dans un terminal :
curl http://127.0.0.1:11434/api/tags

Vous devez obtenir du JSON (liste des modèles) ou une réponse vide {"models":[]} si aucun modèle n’est encore téléchargé.

  1. Télécharger un modèle si la liste est vide :
ollama pull llama3.2:3b
  1. Lancer Open WebUI — copiez-collez la commande complète telle quelle :

Copiez le bloc entier ; sous Windows PowerShell, une seule ligne avec des backticks ` en fin de ligne pour les continuations, ou collez le bloc multi-lignes tel quel dans cmd / Linux / macOS.

docker run -d \
  -p 8080:8080 \
  --add-host=host.docker.internal:host-gateway \
  -v open-webui:/app/backend/data \
  --name open-webui \
  ghcr.io/open-webui/open-webui:main

Décomposition optionnelle (même commande, pour comprendre chaque morceau — inutile si le bloc ci-dessus fonctionne) :

Fragment Rôle
-d Conteneur en arrière-plan
-p 8080:8080 Port navigateur → conteneur
--add-host=host.docker.internal:host-gateway Joindre Ollama sur l’hôte depuis Docker
-v open-webui:... Conserver comptes et historique
ghcr.io/... Image officielle (recouper avec la doc si tag change)
  1. Ouvrir le navigateur sur http://localhost:8080 (adresse locale de votre machine).

  2. Créer le compte administrateur : le premier compte inscrit devient admin (personne qui gère utilisateurs et réglages).

  3. Choisir le modèle par défaut dans les paramètres : sélectionnez llama3.2:3b ou le modèle que vous avez téléchargé.

  4. Envoyer un message test : « Résume en trois phrases pourquoi l’IA locale peut aider à la maison. »

Si vous recevez une réponse en français, l’installation est validée.

Après votre premier chat réussi

Réseau, foyer et données (encart unique) — Tant que vous testez seul sur le PC, restez sur localhost. Pour une tablette sur le même Wi‑Fi, ouvrez http://IP-DU-PC:8080 (LAN, local area network, réseau local Ethernet/Wi‑Fi) : IP via ipconfig (Windows), ip a (Linux) ou Préférences Réseau (macOS). Ne redirigiez pas les ports 8080 ni 11434 de la box vers Internet sans VPN (virtual private network, tunnel chifré) et authentification forte. Le premier compte inscrit reste admin : choisissez un mot de passe robuste. Avant pièces jointes ou données de tiers, lisez RGPD IA 100 % locale ; pour comptes et habitudes multi-utilisateurs, assistant familial privé. Sauvegardez le volume Docker open-webui si l’historique compte — voir SSD modèles.

Dépannage

Port 8080 occupé ou conteneur absent

Symptôme : le conteneur ne démarre pas ou le navigateur affiche un autre site.

Solution Action
Changer le port -p 8081:8080 dans docker run, puis ouvrir http://localhost:8081
Libérer 8080 docker ps, identifier le conteneur, puis docker stop nom
Vérifier pare-feu Autoriser le port choisi en réseau privé uniquement (voir encart réseau ci-dessus)

Symptômes et correctifs

Symptôme Cause probable Correctif
Liste modèles vide Pas de ollama pull ollama pull llama3.2:3b puis rafraîchir la page
502 / backend Ollama arrêté Relancer Ollama ; curl http://127.0.0.1:11434/api/tags
Aucun modèle (Docker) URL Ollama ou CORS (Cross-Origin Resource Sharing, règles navigateur ↔ API) Variable OLLAMA_BASE_URL=http://host.docker.internal:11434 (Docker Desktop) ou IP hôte Linux ; redémarrer le conteneur
Page blanche Conteneur arrêté docker ps ; docker start open-webui
Port 8080 occupé Autre service Changer le port ou libérer 8080 (voir ci-dessus)
Interface lente Modèle trop lourd Modèle 3B ou Q4 — choisir premier modèle
Lent sur LAN Wi‑Fi saturé Brancher le PC serveur en Ethernet ; vérifier l’encart réseau
Mot de passe oublié Compte local Procédure reset dans la doc Open WebUI ou réinstall en conservant le volume
PC allumé 24 h/24 Conso électrique Budget kWh

Résultat attendu

  • Page web locale avec historique de chat.
  • Compte admin créé, modèle par défaut sélectionné.
  • Réponse en français en moins d’une minute sur un PC récent.

Erreurs fréquentes (avant d’acheter du matériel)

Erreur Pourquoi ça bloque Correctif
Lancer Open WebUI sans Ollama Backend vide, erreurs 502 curl http://127.0.0.1:11434/api/tags puis démarrer Ollama
Modèle 70B sur 16 Go RAM Swap disque, PC figé Repasser sur llama3.2:3b ou Q4 7B — choisir premier modèle
LM Studio + Ollama + jeu GPU VRAM saturée Fermer les autres apps GPU ; LM Studio reste optionnel
Historique perdu après docker pull Nouveau conteneur sans volume Conserver -v open-webui:/app/backend/data à chaque docker run

Open WebUI partage le même PC qu’Ollama : un upgrade matériel n’est pas requis pour terminer ce tutoriel. Si, après avoir allégé le modèle (3B puis 7B), la latence gêne encore au quotidien, croisez VRAM et modèles et le sélecteur matériel pour cadrer RAM et GPU avant un achat. Pour comparer des mini-PC 32 Go côté fiche technique, une recherche Amazon.fr « minisforum 32gb » peut servir de point de départ — lien partenaire : commission possible sans surcoût pour vous ; vérifiez le prix et la disponibilité sur la fiche marchande (transparence affiliation, oct. 2026). Le comparatif mini-PC reste la lecture neutre pour trancher.

Annexe — installation pip (sans Docker)

Si Docker n’est pas installé, la doc Open WebUI recommande souvent pip (gestionnaire de paquets Python) :

  1. Vérifiez Python 3.10+ :
python3 --version
  1. Créez un environnement virtuel (recommandé) puis installez le paquet officiel — recoupez la version sur docs.openwebui.com au moment de l’install :
python3 -m venv ~/.open-webui-venv
source ~/.open-webui-venv/bin/activate
pip install open-webui
  1. Lancez le serveur en pointant vers Ollama local :
export OLLAMA_BASE_URL=http://127.0.0.1:11434
open-webui serve
  1. Ouvrez l’URL affichée dans le terminal (souvent http://localhost:8080), créez l’admin et choisissez un modèle déjà téléchargé via ollama pull.

En cas d’erreur de dépendances, revenez au tableau Docker/pip. Binaire natif sans pip : installation manuelle (doc officielle) ou paquet « Desktop » sur docs.openwebui.com — même enchaînement (serveur web → compte admin → backend Ollama sur http://127.0.0.1:11434).

Annexe — mettre à jour Open WebUI (Docker)

Sauvegardez le volume open-webui si l’historique est sensible, puis :

docker stop open-webui
docker rm open-webui
docker pull ghcr.io/open-webui/open-webui:main
docker run -d \
  -p 8080:8080 \
  --add-host=host.docker.internal:host-gateway \
  -v open-webui:/app/backend/data \
  --name open-webui \
  ghcr.io/open-webui/open-webui:main

Recoupez la commande avec docs.openwebui.com si le tag d’image change. Stack multi-conteneurs documentée : Docker Ollama + Open WebUI.

FAQ Open WebUI (spécifique à ce guide)

Pourquoi mon navigateur affiche une erreur CORS avec Docker ?

CORS (Cross-Origin Resource Sharing, règles d’accès entre le navigateur et l’API Ollama) bloque parfois Docker si l’URL backend est incorrecte. Définissez OLLAMA_BASE_URL=http://host.docker.internal:11434 (Docker Desktop) ou l’IP LAN du PC hôte sous Linux, puis redémarrez le conteneur — détail dans le tableau dépannage.

Puis-je remplacer Open WebUI par LM Studio pour la famille ?

LM Studio offre une interface graphique pour tester des GGUF ; Ollama reste souvent le backend API pour Home Assistant ou Continue. Pour un foyer qui discute surtout dans le navigateur, Open WebUI + Ollama suffit — voir LM Studio GPU offload en parallèle, pas en doublon sur le même GPU.

Les conversations partent-elles sur Internet ?

Non tant que vous n’exposez pas les ports 8080 / 11434 sur Internet et que vous ne configurez pas de sync cloud. LAN, admin, sauvegarde et renvoi juridique : encart réseau et données. Comparez coût local vs ChatGPT si vous hésitez entre matériel et abonnement.

Pour aller plus loin (quatre lectures prioritaires)

Une fois localhost:8080 stable, enchaînez sans empiler trop de services :

  1. Assistant familial privé — comptes et usage multi-utilisateurs sur la même instance Open WebUI (complète l’encart réseau).
  2. Docker Ollama + Open WebUI — stack reproductible (plusieurs PC ou sauvegardes identiques).
  3. Premiers pas Whisper — transcription vocale offline après le chat texte.
  4. SSD pour modèles — volumes Docker et dossiers ollama pull avant d’accumuler les GGUF.

Chronométrez la même question en 3B puis en 7B : si le délai reste acceptable, reportez un mini-PC dédié et ajustez RAM 32 vs 64 Go en priorité.

Guides liés

Questions fréquentes

Docker ou installation Python (pip) ?

Voir le tableau comparatif Docker/pip dans ce guide ; en résumé : Docker si déjà installé, sinon pip ou binaire natif (annexe repliable en bas de page).

Puis-je utiliser Open WebUI depuis le téléphone ?

Oui sur le réseau local (LAN) si le pare-feu autorise le port et que vous n’exposez pas le service sur Internet sans authentification renforcée — voir l’encart réseau après l’installation Docker.

Le modèle n’apparaît pas dans la liste : que faire ?

Exécutez ollama pull nom-du-modele dans un terminal, puis rafraîchissez Open WebUI — voir le tableau Dépannage.

Open WebUI remplace-t-il Ollama ?

Non : Open WebUI est une interface web ; Ollama reste le moteur qui exécute les LLM en arrière-plan.

Sources

Affiner avec le sélecteur matériel