12 min de lecture 22 juin 2026

Installation Docker d'Odysseus AI : 7 vérifications avant d'exposer le workspace

Guide pratique pour cloner Odysseus AI, créer .env, démarrer Compose, retrouver le premier mot de passe admin, connecter Ollama côté hôte, préserver les données et garder les services internes privés.

Odysseus AI Wiki

Notes éditoriales non officielles fondées sur le README public d'Odysseus, Docker Compose, le routage des modèles locaux et les problèmes fréquents de la communauté.

Schéma montrant dépôt, fichier d'environnement, Docker Compose et navigateur local pour installer Odysseus AI avec Docker — Une installation Docker fiable sépare les fichiers du dépôt, les valeurs d'environnement, les services Compose et le navigateur local.

Réponse courte: Pour un premier essai propre, Docker Compose est le chemin le plus lisible : clonez le dépôt officiel, copiez .env.example en .env, lancez docker compose up -d --build, ouvrez localhost:7000, puis consultez docker compose logs odysseus pour le premier mot de passe admin. N'exposez pas le stack avant d'avoir choisi l'authentification, HTTPS, les ports et les endpoints de modèles.

Le chemin Docker est pratique parce qu'il crée un stack local répétable sans installer toutes les dépendances sur l'hôte. Il ajoute toutefois des frontières : localhost dans un conteneur n'est pas l'hôte, les volumes contrôlent la persistance, et les services auxiliaires deviennent risqués si trop de ports sont publiés.

Pourquoi Docker

Gardez l'ordre de diagnostic : conteneur applicatif, endpoint de modèle, puis exposition réseau. Les commandes restent en anglais ; seules les explications sont localisées.

Pour un premier essai propre, Docker Compose est le chemin le plus lisible : clonez le dépôt officiel, copiez .env.example en .env, lancez docker compose up -d --build, ouvrez localhost:7000, puis consultez docker compose logs odysseus pour le premier mot de passe admin. N'exposez pas le stack avant d'avoir choisi l'authentification, HTTPS, les ports et les endpoints de modèles.

Réponse courte

Lancez Docker Compose dans un ordre propre et vérifiable

Partez du dépôt officiel plutôt que d'un extrait copié. Les branches, overlays GPU, ports et noms de services peuvent évoluer rapidement.

Sur Windows, vérifiez que Docker Desktop est lancé. Sur macOS ou Linux, confirmez que le daemon répond et que le dossier du dépôt ne crée pas de problème de droits.

1. Clonez le bon dépôt

Utilisez le dépôt officiel et choisissez la branche voulue avant de modifier les fichiers.

git clone https://github.com/pewdiepie-archdaemon/odysseus.git
cd odysseus

2. Créez le fichier d'environnement

Copiez l'exemple pour donner des valeurs explicites à Compose et à l'application. Ne partagez pas .env.

cp .env.example .env

3. Construisez et démarrez le stack

Le premier build peut être long car il télécharge images et dépendances.

docker compose up -d --build

4. Vérifiez l'état et les identifiants

N'ouvrez l'UI locale qu'après la santé des conteneurs. Le premier mot de passe apparaît dans les logs Odysseus.

docker compose ps
docker compose logs odysseus

Comprenez .env, le port 7000 et ce qui doit être joignable

L'UI web est généralement la seule partie nécessaire dans le navigateur. L'URL locale attendue est http://localhost:7000.

Les services auxiliaires d'un stack Compose ne doivent pas devenir publics simplement parce que l'UI fonctionne.

Réglage ou test	Ce que cela prouve	À éviter
.env copié depuis l'exemple	L'application lit des valeurs locales explicites.	Démarrer avec des variables héritées inconnues.
localhost:7000	Le navigateur atteint l'UI web sur le port local prévu.	Ouvrir un service auxiliaire en pensant que c'est l'application.
docker compose ps	Chaque service attendu est actif ou montre son échec.	Modifier les modèles avant que le conteneur soit sain.
logs odysseus	Le démarrage et les premiers identifiants sont visibles.	Partager des logs contenant mots de passe ou tokens.

Connectez Ollama côté hôte sans confondre le localhost du conteneur

Ollama est souvent un serveur de modèles séparé. Si Ollama tourne sur l'hôte et Odysseus AI dans un conteneur, localhost dans le conteneur ne vise pas l'hôte.

Testez par couches : Ollama sur l'hôte, accès depuis le conteneur, puis configuration dans Odysseus AI.

Schéma d'un conteneur Docker Odysseus AI se connectant à Ollama sur l'hôte — L'erreur fréquente consiste à utiliser le localhost du conteneur alors qu'Ollama se trouve sur l'hôte.

Endpoint Docker vers Ollama côté hôte

http://host.docker.internal:11434/v1

Où tourne Odysseus	Où tourne Ollama	Endpoint à tester
Conteneur Docker	Machine hôte	http://host.docker.internal:11434/v1
Conteneur Docker	Même réseau Compose	Utilisez le nom du service et le port interne Compose.
Processus natif hôte	Même hôte	http://127.0.0.1:11434/v1
Serveur distant	Autre machine	Utilisez HTTPS ou un réseau privé, pas un port brut exposé.

Sachez ce qui survit aux rebuilds, mises à jour et redémarrages

Docker rend les rebuilds simples, mais un workspace contenant comptes, documents et paramètres n'est plus jetable.

Utilisez les commandes Compose avec intention. Redémarrer n'est pas supprimer les volumes.

Action	Quand l'utiliser	Risque
docker compose restart	Le stack est déjà construit et vous voulez redémarrer les services.	Faible; l'état reste normalement.
docker compose pull && docker compose up -d --build	Vous voulez rafraîchir les images et reconstruire.	Moyen; lisez le README avant.
docker compose down	Vous voulez arrêter les conteneurs tout en gardant les volumes.	Généralement sûr, mais vérifiez Compose.
docker compose down -v	Vous voulez supprimer les volumes pour repartir de zéro.	Élevé; peut supprimer l'état du workspace.

Matrice de dépannage du premier démarrage

Séparez build, santé des conteneurs, accès navigateur, identifiants et modèles. Corrigez la première couche en échec.

Symptôme	Cause probable	Premier correctif
La commande Docker est introuvable	Docker Desktop ou le daemon n'est pas installé, lancé ou disponible.	Lancez Docker puis vérifiez docker version.
Build réussi mais localhost:7000 ne charge pas	Conteneurs encore en démarrage, port différent ou service malsain.	Exécutez docker compose ps et logs odysseus.
Aucun mot de passe admin visible	Le log a défilé, un état existe déjà ou .env fixe les identifiants.	Relisez logs odysseus et .env.
Ollama marche sur l'hôte mais pas dans Odysseus	Le conteneur utilise localhost au lieu de la passerelle hôte.	Utilisez host.docker.internal:11434/v1 depuis la même couche.
Les données disparaissent après nettoyage	Des volumes ont été supprimés.	Restaurez la sauvegarde et évitez down -v sans reset voulu.

Checklist sécurité avant LAN, tunnel ou proxy inverse

Un workspace IA auto-hébergé peut toucher fichiers, prompts, documents, modèles et outils. Le contrôle local n'aide que si la frontière de déploiement est claire.

Le modèle sûr consiste à publier seulement l'UI nécessaire, garder les services internes privés, changer les identifiants et utiliser HTTPS à distance.

Changez ou définissez l'identifiant admin avant tout accès tiers.
Vérifiez docker compose ps et le fichier Compose pour chaque port publié.
Gardez ChromaDB, notifications, modèles et bases hors d'internet public.
Utilisez HTTPS et un proxy fiable avant l'accès distant.
Ne publiez pas .env, logs ou captures contenant tokens ou mots de passe.
Sauvegardez les volumes avant les migrations ou nettoyages destructifs.

Réglage sûr par défaut

Gardez Odysseus AI sur localhost jusqu'à vérification de l'authentification, des ports, de HTTPS, du firewall et de l'endpoint modèle.

FAQ

Pour une première installation propre, souvent oui. Docker Compose évite de mélanger les dépendances avec l'hôte.

L'URL attendue est http://localhost:7000 lorsque les conteneurs sont sains, sauf port modifié dans .env.

Consultez docker compose logs odysseus. L'état persistant ou .env peut modifier le comportement.

Les deux sont possibles. Odysseus dans Docker avec Ollama sur l'hôte utilise souvent host.docker.internal:11434/v1.

N'exposez pas le stack local brut. Vérifiez auth, HTTPS, firewall et services auxiliaires.

Sauvegardez les volumes, lisez le README actuel et évitez de supprimer les volumes sans intention.

Références

Official Odysseus AI GitHub repository - Current README, Docker quick start, feature list, and security notes.
Docker Compose documentation - Reference for Compose commands, services, networks, and volumes.
Docker Desktop networking documentation - Host-to-container and container-to-host networking behavior.
Ollama API documentation - Endpoint checks for local model server connectivity.

Guides liés

Configuration Odysseus AI avec Ollama - À lire si Docker fonctionne mais le routage des modèles reste flou.
Odysseus AI sur Windows - Notes Windows pour WSL2, Docker Desktop, firewall et endpoints hôte.
Odysseus AI sur macOS - Comparer Docker avec le chemin natif Apple Silicon.
README officiel Odysseus - Vérifiez les commandes actuelles avant exécution.

Dernière mise à jour : 22 juin 2026

Retour au wiki Odysseus AI