Installer et compiler Condui Community
Installez l’édition Community locale avec Docker Compose ou Podman, ou compilez-la et démarrez-la directement depuis le code source.
Condui Community est l’édition locale et auto-hébergée de Condui. Elle fonctionne sans compte, sans base de données et sans service Condui géré. Vous pouvez compiler vous-même le code source et exécuter l’application sur votre ordinateur ou votre serveur.
Community conserve les projets par défaut dans le navigateur de votre appareil, ou dans un dossier sur votre serveur si vous activez cette option. Les archives Condui téléchargées sont compatibles dans les deux sens avec la version hébergée.
Consultez le code source de Condui Community sur GitHub.
Quelle méthode d’installation choisir ?
| Méthode | Usage conseillé |
|---|---|
| Docker Compose | L’installation la plus simple et recommandée |
| Podman | Une solution compatible avec Docker, sans Docker Desktop |
| Node.js 24 | Consulter, modifier et compiler manuellement le code source |
Le Dockerfile fourni produit une image de conteneur OCI standard. D’autres outils compatibles OCI peuvent également construire cette image, mais Docker et Podman sont les méthodes testées.
Prérequis
Pour Docker Compose ou Podman, vous avez besoin :
- de Git, ou d’une copie téléchargée du dépôt ;
- de Docker avec le module Compose, ou d’une installation récente de Podman ;
- d’un port local libre,
8080par défaut ; et - d’un navigateur moderne.
Une compilation directe nécessite Node.js 24 et npm. Aucun projet Supabase, compte cloud ou base de données séparée n’est nécessaire.
Installer avec Docker Compose
- Récupérez le dépôt et ouvrez son dossier :
git clone https://github.com/Xoliul/condui-community.git
cd condui-community
- Récupérez l'image publiée et démarrez le conteneur :
docker compose up -d
- Ouvrez http://localhost:8080. La page d’accueil de Condui Community apparaît dès que le conteneur est prêt.
- Vérifiez au besoin l’état ou les journaux :
docker compose ps
docker compose logs -f
Arrêtez l’application avec :
docker compose down
Installer avec Podman
Construisez d’abord l’image OCI :
podman build -t condui-community:local .
Démarrez ensuite le conteneur :
podman run --name condui-community --rm -p 8080:8080 condui-community:local
Ouvrez http://localhost:8080. Appuyez sur Ctrl+C pour arrêter le conteneur. Vous pouvez également utiliser le fichier compose.yaml fourni avec Podman Compose.
Compiler et démarrer depuis le code source
Vérifiez d’abord que Node.js 24 est actif :
node --version
Installez les dépendances verrouillées, compilez l’application de production et démarrez le serveur local :
npm ci --ignore-scripts
npm run build
npm start
Ouvrez ensuite http://localhost:8080. Le serveur local fournit l’application web ainsi que les points de conversion locaux pour les fichiers de plan pris en charge.
Mettre l’installation à jour
Récupérez la nouvelle configuration Compose et l'image publiée :
git pull
docker compose up -d
Téléchargez les archives des projets importants avant la mise à jour. Les archives prises en charge sont migrées lors de leur ouverture, mais votre propre sauvegarde reste la solution de récupération la plus sûre.
Stockage optionnel sur votre serveur
Ajoutez ce montage de volume sous le service condui dans compose.yaml et redémarrez Compose :
volumes:
- ./condui-data:/data
Les projets, dossiers, votre profil d'installateur et vos préférences se trouvent alors dans condui-data. Les appareils qui ouvrent la même installation voient la même liste de projets. À la première ouverture, vous pouvez déplacer les projets du navigateur vers le serveur. Il s'agit d'une installation partagée sans comptes utilisateurs séparés ; sauvegardez vous-même le dossier complet.
Sans mot de passe, Community est accessible uniquement depuis son propre réseau, y compris un réseau privé comme Tailscale. Pour un accès extérieur, définissez CONDUI_PASSWORD sous le même service avec un mot de passe d'au moins huit caractères. Utilisez HTTPS via un proxy inverse pour l'accès par internet ; le mot de passe est alors aussi obligatoire sur votre réseau.
environment:
CONDUI_PASSWORD: "choose-your-own-password"
Stockage des projets et sauvegardes
Sans stockage sur serveur, les projets sont conservés dans le navigateur, pas dans le conteneur. Le remplacement ou la reconstruction du conteneur ne supprime normalement pas ce stockage. Le navigateur considère toutefois chaque combinaison de protocole, de nom d’hôte et de port comme une origine distincte. Le passage de localhost:8080 à un autre nom d’hôte ou port peut donc afficher une liste de projets vide.
Téléchargez régulièrement les projets importants sous forme d’archives de projet Condui et conservez-les dans un emplacement sauvegardé. Un PDF est un document final et ne contient pas de projet modifiable intégré dans l’édition Community.
Aucune sauvegarde ni assistance gérée
Une installation Community ne comprend ni stockage cloud géré, ni service de récupération, ni garantie d’assistance officielle. La personne qui l’exploite est responsable des mises à jour, de la disponibilité et des sauvegardes.
Problèmes fréquents
- Le port 8080 est déjà utilisé : remplacez par exemple
8080:8080par8081:8080danscompose.yaml, puis ouvrezhttp://localhost:8081. - La compilation du code source refuse de démarrer : vérifiez que
node --versionindique la version 24. - La liste des projets semble vide : ouvrez l’application avec exactement le même nom d’hôte et le même port, ou importez une archive de projet téléchargée auparavant.
- Le conteneur s’arrête pendant la construction : consultez
docker compose logset vérifiez que Docker dispose de suffisamment de mémoire et d’espace disque. - Le navigateur affiche une page blanche : ouvrez la console de développement du navigateur. Community s’exécute dans le navigateur ; les journaux Docker indiquent seulement si le serveur web local a démarré.