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.

L’édition Community conserve les projets dans le navigateur de l’appareil sur lequel vous travaillez. Les archives de projet Condui téléchargées sont compatibles dans les deux sens avec l’édition hébergée.

Consultez le code source de Condui Community sur GitHub.

Quelle méthode d’installation choisir ?

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, 8080 par 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

1. Récupérez le dépôt et ouvrez son dossier :

git clone https://github.com/Xoliul/condui-community.git
cd condui-community

1. Construisez et démarrez le conteneur :

docker compose up --build -d

1. Ouvrez http://localhost:8080. La page d’accueil de Condui Community apparaît dès que le conteneur est prêt.

1. 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 une nouvelle version Community et reconstruisez le conteneur :

git pull
docker compose up --build -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 des projets et sauvegardes

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:8080 par 8081:8080 dans compose.yaml, puis ouvrez http://localhost:8081.
• La compilation du code source refuse de démarrer : vérifiez que node --version indique 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 logs et vérifiez que Docker dispose de suffisamment de mémoire et d’espace disque.