~/ / Articles sur l'IA / LLM locaux sur un VPS / Open WebUI sur un VPS : le lancer dans Docker et le connecter à Ollama
Open WebUI sur un VPS : le lancer dans Docker et le connecter à Ollama
Une fenêtre de discussion dans le navigateur est le moyen le plus simple d'utiliser un modèle qui tourne sur votre propre serveur. Open WebUI est l'une de ces interfaces, et sa documentation montre comment la démarrer avec Docker et la connecter à Ollama. Cet article suit pas à pas le démarrage rapide officiel et les guides de connexion, et signale où les deux guides décrivent la connexion différemment.
Publié: · 5 min de lecture · Vérifié dans la documentation officielle d'Open WebUI le 2026-10-26. Les commandes, les étiquettes d'image et les réglages changent d'une version à l'autre : confirmez-les dans les documents actuels avant d'exécuter quoi que ce soit sur un serveur.
Vérifier d'abord la mémoire
Open WebUI est un programme supplémentaire sur le même serveur, et la documentation n'en donne aucun chiffre de mémoire. Selon le démarrage rapide, l'image standard, étiquetée main, inclut des modèles de reconnaissance vocale et d'embedding. Estimez d'abord la mémoire de votre modèle, et laissez de la place pour l'interface et le système d'exploitation.
Essayer: Local LLM Memory Estimator
Estimation
- Poids du modèle
- 4.84 GiB
- KV cache
- 0.56 GiB
- Réserve
- 1.00 GiB
- Total
- 6.41 GiB (6.88 GB)
- Plus petite taille de mémoire courante qui le contient
- 8 GiB
Il s'agit d'une estimation. Elle n'inclut pas les tampons de calcul du runtime et suppose que chaque couche a la même forme de KV. Mesurez une vraie exécution avant de choisir une offre.
Données du modèle vérifiées le 2026-10-26.
Sources : Ollama library · Configuration du modèle (config.json) · Ollama FAQ
Tout s'exécute dans votre navigateur. Rien n'est envoyé.
Le démarrer avec Docker
Le démarrage rapide sert Open WebUI à l'adresse http://localhost:3000 et le lance avec une seule commande docker run. Remplacez your-secret-key par une valeur que vous générez, par exemple avec la commande que donne le guide pour cela.
| Étape | Commande |
|---|---|
| Générer une clé secrète | openssl rand -hex 32 |
| Démarrer Open WebUI | docker run -d -p 3000:8080 --add-host=host.docker.internal:host-gateway -v open-webui:/app/backend/data -e WEBUI_SECRET_KEY=your-secret-key --name open-webui --restart always ghcr.io/open-webui/open-webui:main |
| Suivre les journaux | docker logs -f open-webui |
- -p 3000:8080 relie le port 3000 de l'hôte au port 8080 du conteneur.
- Le volume open-webui contient vos conversations, vos utilisateurs et vos réglages. Le guide indique qu'il survit aux mises à jour et qu'il ne faut jamais lancer le conteneur sans lui.
- WEBUI_SECRET_KEY : le guide dit de la définir une fois et de la conserver, car sans clé fixe chaque conteneur recréé déconnecte tout le monde, et une nouvelle clé déconnecte tout le monde.
- Les étiquettes d'image : main est l'image standard, cuda ajoute la prise en charge des GPU NVIDIA et nécessite --gpus all, et ollama intègre Ollama dans le même conteneur.
Le premier compte est l'administrateur
Le premier écran propose de créer un compte administrateur. D'après le guide, ce premier compte est l'administrateur, qui gère les utilisateurs et tous les réglages de l'instance, et l'inscription se désactive d'elle-même une fois le compte administrateur créé.
Notre recommandation, qui ne figure pas dans les documents : créez le compte administrateur dès que le conteneur démarre, avant de communiquer l'adresse à qui que ce soit, car la première personne qui atteint la page peut le créer.
Le connecter à Ollama : deux façons dans la documentation
Les pages d'Open WebUI que nous avons consultées décrivent la connexion de deux manières différentes. Utilisez la page qui correspond à la version que vous exécutez, et vérifiez quel type votre version propose dans Paramètres, Admin, Connexions.
| Connexion | Ce que dit la page |
|---|---|
| Protocole de l'API Ollama | Sous Paramètres > Admin > Connexions, Gérer les connexions à l'API Ollama. La page donne le port 11434 comme port habituel, et indique d'utiliser http://host.docker.internal:11434 lorsque Open WebUI tourne dans Docker et qu'Ollama tourne sur l'hôte. |
| Connexion de type OpenAI | Ajoutez une connexion de type OpenAI avec l'URL de base http://localhost:11434/v1 et un texte quelconque comme clé d'API. La page indique qu'Ollama ne vérifie pas la clé, mais que le champ ne peut pas être vide, et que saisir ollama fonctionne. |
- Les modèles téléchargés sont détectés automatiquement et apparaissent dans le sélecteur de modèles. Vous pouvez les limiter avec une liste séparée par des virgules.
- Vous pouvez ajouter plusieurs instances d'Ollama. La page indique que les requêtes sont réparties par sélection aléatoire, que les identifiants de modèle doivent correspondre exactement d'une instance à l'autre, et qu'un préfixe tel que remote/ permet de distinguer des instances dont les modèles portent le même nom.
- Pour un point d'accès lent ou injoignable, la page suggère de définir AIOHTTP_CLIENT_TIMEOUT_MODEL_LIST=3 (la valeur par défaut est de 10 secondes) pour un basculement plus rapide.
- Si la connexion échoue, la page désigne une mauvaise configuration réseau comme cause la plus fréquente et renvoie vers son guide de dépannage.
Les pages que nous avons consultées ne disent pas si un conteneur peut joindre un Ollama qui n'écoute que sur 127.0.0.1, et elles ne traitent pas de l'élargissement de l'adresse d'Ollama. D'après sa FAQ, Ollama se lie par défaut à 127.0.0.1. Notre recommandation : n'ouvrez pas Ollama à tout le réseau sans une règle de pare-feu qui le limite aux adresses que vous utilisez.
Mettre à jour et supprimer
| Tâche | Commandes du démarrage rapide |
|---|---|
| Mettre à jour à la main | docker rm -f open-webui, puis docker pull ghcr.io/open-webui/open-webui:main, puis la même commande docker run que précédemment |
| Mettre à jour avec Watchtower | docker run --rm --volume /var/run/docker.sock:/var/run/docker.sock nickfedor/watchtower --run-once open-webui |
| Désinstaller | docker rm -f open-webui, puis docker rmi ghcr.io/open-webui/open-webui:main, puis docker volume rm open-webui |
Supprimer le volume efface vos conversations, vos utilisateurs et vos réglages. Le guide indique que vos données se trouvent dans le volume : conservez-le donc lors d'une mise à jour.
Le garder privé
- Le démarrage rapide présente une variante avec WEBUI_AUTH=False. Notre recommandation, qui ne figure pas dans les documents : ne l'utilisez pas sur un serveur accessible à n'importe qui.
- Placez HTTPS et une règle de pare-feu devant le port 3000 avant de partager l'adresse, et ne mettez pas la clé secrète dans ce que vous versez dans un dépôt.
- Le démarrage rapide montre aussi comment pointer Open WebUI vers un autre serveur avec OLLAMA_BASE_URL. Dans ce cas, considérez cette connexion comme faisant elle aussi partie de votre réseau privé.
Sources
À lire ensuite
- Placer nginx devant Ollama : authentification basique, HTTPS et réglages pour le streamingAccéder à Ollama depuis l'extérieur en toute sécurité : nginx en proxy, authentification basique, HTTPS, réglages de streaming et de délais, et une règle de pare-feu, d'après la documentation officielle.
- Appeler un modèle local depuis votre code : sorties structurées et API compatible OpenAI dans OllamaContraindre la sortie d'un modèle local avec un JSON Schema et appeler Ollama depuis des clients de style OpenAI : ce que disent les documents officiels, et ce qui n'est pas pris en charge.
- Que peut faire un modèle local ? Tools, thinking, vision et embeddings dans Ollama, et ce qui tient sur un VPSTools, thinking, vision, embeddings : ce que signifient les libellés de la bibliothèque Ollama, quels modèles les portent et quelle est la taille des téléchargements.
- Installer Ollama sur un VPS et le garder en marche : installation, service systemd, réglages et mises à jourInstaller Ollama sur un VPS Linux et le garder en marche : la commande d'installation, le service systemd, les variables d'environnement, le stockage des modèles et les mises à jour, d'après la documentation officielle.