Open WebUI pour débutants : installer avec Ollama
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é)
- 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é.
- Télécharger un modèle si la liste est vide :
ollama pull llama3.2:3b
- 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) |
-
Ouvrir le navigateur sur http://localhost:8080 (adresse locale de votre machine).
-
Créer le compte administrateur : le premier compte inscrit devient admin (personne qui gère utilisateurs et réglages).
-
Choisir le modèle par défaut dans les paramètres : sélectionnez
llama3.2:3bou le modèle que vous avez téléchargé. -
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 viaipconfig(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 Dockeropen-webuisi 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) :
- Vérifiez Python 3.10+ :
python3 --version
- 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
- Lancez le serveur en pointant vers Ollama local :
export OLLAMA_BASE_URL=http://127.0.0.1:11434
open-webui serve
- 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 :
- Assistant familial privé — comptes et usage multi-utilisateurs sur la même instance Open WebUI (complète l’encart réseau).
- Docker Ollama + Open WebUI — stack reproductible (plusieurs PC ou sauvegardes identiques).
- Premiers pas Whisper — transcription vocale offline après le chat texte.
- SSD pour modèles — volumes Docker et dossiers
ollama pullavant 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
- Assistant familial privéComptes et habitudes pour discuter en famille sans cloud.
- Home Assistant + OllamaAppels HTTP locaux depuis votre domotique.
- Coût local vs ChatGPTComparer matériel et kWh sur 3 ans.
- SSD pour modèlesDimensionner le stockage GGUF et Docker.
- Whisper — premiers pasTranscription vocale offline après le chat.
- Docker Ollama + Open WebUIStack reproductible sur plusieurs machines.
- Ollama sur WindowsInstallateur natif si Open WebUI est votre prochaine étape.
- LM Studio et GPUTester un GGUF avant de le servir via Ollama.
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.