Aide à l'installation
Installer OpenConstructionERP
Choisissez comment vous voulez le lancer, suivez les étapes numérotées et, si quelque chose cloche, retrouvez le message affiché dans la liste des problèmes plus bas. Aucun des avertissements pendant l'installation ne met vos projets en danger.
Vous ne savez pas laquelle choisir ?
- Vous utilisez Windows 10 ou 11Installeur Windows (.exe)
- Vous avez un Mac avec une puce M1, M2, M3 ou M4macOS (.dmg, Apple Silicon)
- Vous avez un Mac Intelpip ou Docker (il n'y a pas d'application pour Mac Intel)
- Vous utilisez Ubuntu, Debian ou Linux MintLinux .deb
- Vous utilisez Fedora, RHEL ou Rocky LinuxLinux .rpm
- Vous utilisez une autre distribution LinuxLinux AppImage
- Vous avez déjà Python 3.12 ou plus récent, ou vous le voulez sur un serveurpip
- Vous utilisez Docker, ou vous le mettez en place pour une équipeDocker
À regarder d'abord
Comment installer OpenConstructionERP
Tutoriel vidéo sous Windows, enregistré avec la version 17.7.1. Certains écrans diffèrent en 18.5, et l’attente pendant l’installation est raccourcie dans la vidéo.
Windows
- 1
Téléchargez
OpenConstructionERP_18.5.0_x64-setup.exedepuis la page de la version.Vous voyezUn fichier d'environ 800 Mo dans votre dossier Téléchargements.
- 2
Double-cliquez dessus. Si une fenêtre bleue affiche « Windows a protégé votre ordinateur », cliquez sur Informations complémentaires, vérifiez que le nom du fichier commence par OpenConstructionERP, puis cliquez sur Exécuter quand même.
Vous voyezWindows demande les droits d'administrateur. Cliquez sur Oui.
- 3
Choisissez la langue de l'installeur, acceptez la licence et gardez le dossier proposé
C:\Program Files\OpenConstructionERP.Vous voyezUne barre de progression, puis une page de fin.
- 4
Cliquez sur Terminer, ou lancez OpenConstructionERP depuis le menu Démarrer.
Vous voyezUn écran de chargement « Démarrage de l'application » avec une liste de contrôle : démarrage du backend, démarrage de la base de données locale, préparation de la base de données, démarrage du serveur applicatif, ouverture de l'application.
- 5
Patientez au tout premier démarrage. Ne fermez pas la fenêtre.
Vous voyez« Le premier démarrage met en place votre base de données locale. Cela peut prendre une ou deux minutes, merci de patienter. » Les démarrages suivants sont bien plus rapides.
- 6
Choisissez comment l'ouvrir : dans une fenêtre d'application (recommandé) ou dans votre navigateur habituel.
Vous voyez« Comment souhaitez-vous ouvrir OpenConstructionERP ? » puis la page de connexion.
- 7
Connectez-vous avec le compte de démonstration : e-mail demo@openconstructionerp.com, mot de passe DemoPass1234!. Vous pourrez ensuite créer votre propre compte et vos projets.
Vous voyezL'application. Les projets de démonstration sont créés en arrière-plan au premier démarrage, la liste des projets peut donc indiquer un court instant qu'ils arrivent.
- 8
Sur une installation neuve, l'administrateur doit indiquer une fois quels modules vous utiliserez. Cochez ce dont vous avez besoin et continuez. Vous pourrez le modifier plus tard avec le bouton Services d'arrière-plan de la barre du haut.
Vous voyezUne liste unique des modules avec la mémoire qu'ils demandent.
Si vous voyez un message
InstallationUne fenêtre bleue « Windows a protégé votre ordinateur ».
Cela signifie L'installeur n'est pas encore signé, donc Windows ne connaît pas l'éditeur. C'est un avertissement, pas la détection d'un virus.
À faire Cliquez sur Informations complémentaires, vérifiez que le nom du fichier commence par OpenConstructionERP, puis cliquez sur Exécuter quand même.
InstallationLe Contrôle intelligent des applications (Smart App Control) a bloqué l'application, sans bouton pour continuer.
Cela signifie Le Contrôle intelligent des applications de Windows 11 refuse les programmes non signés.
À faire Le Contrôle intelligent des applications ne peut pas autoriser une seule application. Pour le garder actif, lancez OpenConstructionERP avec Docker Desktop ou dans WSL (le Linux intégré à Windows), que le Contrôle intelligent des applications ne vérifie pas. Instructions pas à pas : docs/desktop/WINDOWS_BLOCKED.md dans le dépôt.
Installation"Please choose an installation folder whose path uses only Latin letters, digits and spaces. The built-in database cannot start from a folder with other characters in its path" (le message n'existe qu'en anglais)Signification : le chemin du dossier d'installation ne doit contenir que des lettres latines, des chiffres et des espaces, car la base de données intégrée ne peut démarrer depuis aucun autre chemin.
Cela signifie Le dossier choisi contient dans son chemin des lettres cyrilliques, chinoises, accentuées ou d'autres alphabets non latins.
À faire Gardez le dossier proposé C:\Program Files\OpenConstructionERP, ou choisissez un dossier comme C:\OpenConstructionERP. Une installation silencieuse (/S) se termine avec le code 3 et écrit la raison dans %TEMP%\OpenConstructionERP-install-error.log.
InstallationL'installeur s'arrête avec une erreur sur WebView2.
Cela signifie Windows a refusé d'installer Microsoft WebView2, le composant qui dessine la fenêtre de l'application. Il est inclus dans l'installeur, donc pas besoin d'internet ; l'échec vient de Windows lui-même (stratégie, mise à jour en attente ou ancien WebView2 endommagé).
À faire Redémarrez l'ordinateur et relancez l'installeur. Si cela échoue encore, installez « Microsoft Edge WebView2 Runtime » depuis le site de Microsoft, puis relancez notre installeur.
InstallationVotre antivirus supprime ou met en quarantaine un fichier pendant l'installation ou au premier démarrage.
Cela signifie Le programme est récent et non signé, et certains antivirus s'en méfient.
À faire Restaurez le fichier depuis la quarantaine et ajoutez ces deux dossiers aux exclusions : le dossier du programme C:\Program Files\OpenConstructionERP et votre dossier de données C:\Users\<your name>\.openestimate. Relancez ensuite l'installeur par-dessus l'installation existante. Si vous n'êtes pas sûr que le fichier soit authentique, écrivez-nous d'abord.
Mise à jourUn écran demande s'il faut écraser la version installée ou la supprimer d'abord, avec une ligne qui conseille de la supprimer.
À faire Gardez l'option déjà sélectionnée (écraser). Vos projets sont conservés. Le premier démarrage après une mise à jour peut être plus long, le temps que la base de données se mette à jour.
Mise à jourVous lancez aussi OpenConstructionERP avec pip ou dans un terminal sur le même ordinateur, et il s'arrête pendant la mise à jour.
Cela signifie Les deux utilisent le même dossier .openestimate et la même base de données. L'installeur arrête cette base pour remplacer le programme. Lors d'une mise à jour depuis la 18.4.0, l'ancien désinstalleur ferme aussi tout programme nommé openconstructionerp.exe.
À faire Arrêtez la version du terminal (Ctrl+C) avant d'installer ou de mettre à jour, puis relancez-la ensuite.
DémarrageL'écran de chargement reste affiché une minute ou plus au tout premier démarrage.
Cela signifie L'application crée sa base de données locale. Cela n'arrive qu'une fois.
À faire Patientez et ne fermez pas la fenêtre. Sur un disque lent ou presque plein, cela peut prendre plus de temps. Les démarrages suivants sont rapides.
DémarrageUne boîte « OpenConstructionERP failed to start » qui indique un fichier journal.
Cela signifie L'application n'a pas pu ouvrir sa fenêtre du tout.
À faire Relancez-la une fois. Si la boîte revient, envoyez-nous le fichier journal qu'elle indique.
Démarrage"The backend started, but the local database is not answering, so the app cannot open."Signification : la partie serveur a démarré, mais sa base de données locale ne répond pas, donc l'application ne peut pas s'ouvrir.
Cela signifie La base de données locale n'a pas démarré, souvent après une session qui ne s'est pas fermée proprement.
À faire Redémarrez l'ordinateur et relancez l'application. Si cela se répète, envoyez-nous desktop-launcher.log et le journal de la base de données (voir Journaux).
Démarrage"The backend started, but this installation is missing the application files it serves"Signification : la partie serveur a démarré, mais il manque à l'installation les fichiers de l'interface utilisateur.
Cela signifie Une partie du dossier du programme manque, en général supprimée par l'antivirus.
À faire Vérifiez la quarantaine de votre antivirus, puis relancez l'installeur par-dessus l'installation existante. Vos projets ne sont pas touchés.
Démarrage"The application backend did not start in time", ou "The application backend stopped responding while preparing the local database" (ou à une autre étape).
Cela signifie Le démarrage a pris plus de temps que l'application n'attend. Le message indique l'étape en cours.
À faire Fermez la fenêtre et relancez. Libérez d'abord de l'espace disque si le disque est presque plein. Si cela s'arrête de nouveau à la même étape, envoyez-nous desktop-launcher.log.
Démarrage"The drive ran out of space while the application was starting" ou "There is not enough free space to start the application".
Cela signifie C'est exactement cela. Le message indique le dossier et l'espace libre restant.
À faire Libérez de l'espace sur ce disque et relancez.
DémarrageUn message disant que le dossier de la base de données locale "sits too deep in the filesystem", avec deux nombres.
Cela signifie Windows limite la longueur des chemins et le chemin de votre dossier de données est trop long pour les fichiers de la base. Activer les chemins longs dans Windows n'aide pas.
À faire Définissez la variable d'environnement utilisateur OE_DATA_DIR sur un chemin court comme C:\OpenConstructionERP\data (Démarrer, tapez « variables d'environnement », Modifier les variables d'environnement pour votre compte, Nouvelle), puis relancez.
DémarrageVotre nom d'utilisateur Windows contient des lettres non latines (par exemple cyrilliques ou chinoises) et vous cherchez votre base de données.
Cela signifie La base de données intégrée ne peut pas tourner depuis un tel chemin, donc depuis la 18.5.0 l'application la garde dans C:\ProgramData\OpenConstructionERP\clusters\<id>\pgdata. Avant la 18.5.0, l'application ne démarrait pas du tout pour ces comptes.
À faire Rien à corriger. Le fichier pgdata.location dans votre dossier .openestimate indique le dossier exact de la base. Pour les sauvegardes, copiez les deux dossiers.
En cours d'utilisation"The application backend stopped, restarting" et la fenêtre se recharge.
Cela signifie La partie de l'application qui tourne en arrière-plan s'est arrêtée de façon inattendue et l'application l'a relancée. Le travail enregistré est conservé. Cela se produit au plus deux fois en 30 minutes.
À faire Continuez. Si cela se répète, ou si vous voyez "The application backend has stopped", envoyez-nous desktop-launcher.log et logs/backend-crash.log.
DémarrageÀ chaque démarrage de l'application, vous êtes déconnecté et la langue repasse en anglais.
Cela signifie Un autre programme utilise le port 8732, celui que l'application utilise normalement. La version 18.5.0 choisit alors un port libre au hasard à chaque démarrage, et la fenêtre traite chaque nouveau port comme un nouveau site, donc la connexion et la langue sont introuvables.
À faire Fermez ou reconfigurez l'autre programme qui utilise le port 8732 (sous Windows, lancez netstat -ano | findstr :8732 dans un terminal pour voir son identifiant de processus). Vos projets ne sont pas touchés, seulement la connexion et le choix de la langue.
DémarrageVous craignez que l'application entre en conflit avec un PostgreSQL déjà actif sur le port 5432.
Cela signifie Ce n'est pas le cas. Sous Windows, la base de données intégrée prend un port local libre au hasard, et sous macOS et Linux elle écoute uniquement sur un socket local, pas sur un port TCP.
À faire Rien à faire.
Où se trouvent les journaux
desktop-launcher.logC:\Users\<your name>\.openestimate\desktop-launcher.logTout ce que l'application de bureau a fait au démarrage. Toujours dans votre dossier personnel, même si vous avez déplacé le dossier de données.backend-crash.logC:\Users\<your name>\.openestimate\logs\backend-crash.logDétails d'un arrêt inattendu. Se trouve dans le dossier de données, donc il suitOE_DATA_DIR.database log folderC:\Users\<your name>\.openestimate\pgdata\log (or <folder frompgdata.location>\log)Pourquoi la base de données intégrée n'a pas démarré.OpenConstructionERP-install-error.log%TEMP%\OpenConstructionERP-install-error.log(tapez%TEMP%dans la barre d’adresse de l’Explorateur)Pourquoi l'installeur Windows a refusé le dossier d'installation.
Pour ouvrir le dossier, collez ceci dans la barre d'adresse de l'Explorateur de fichiers :
%USERPROFILE%\.openestimatemacOS
- 1
Téléchargez
OpenConstructionERP_18.5.0_aarch64.dmget ouvrez-le.Vous voyezUne fenêtre avec l'icône de l'application OpenConstructionERP.
- 2
Faites glisser OpenConstructionERP dans Applications.
Vous voyezL'application apparaît dans votre dossier Applications.
- 3
Ouvrez Terminal une fois et lancez.
xattr -dr com.apple.quarantine /Applications/OpenConstructionERP.appVous voyezAucun résultat. C'est normal. Cette commande retire la marque de téléchargement, car l'application n'est pas encore notariée par Apple.
- 4
Ouvrez OpenConstructionERP depuis Applications.
Vous voyezL'écran de chargement « Démarrage de l'application ». Le premier démarrage prépare la base de données locale et prend une ou deux minutes.
- 5
Choisissez fenêtre d'application ou navigateur.
Vous voyezLa page de connexion.
- 6
Connectez-vous avec le compte de démonstration : e-mail demo@openconstructionerp.com, mot de passe DemoPass1234!. Vous pourrez ensuite créer votre propre compte et vos projets.
Vous voyezL'application. Les projets de démonstration sont créés en arrière-plan au premier démarrage, la liste des projets peut donc indiquer un court instant qu'ils arrivent.
- 7
Sur une installation neuve, l'administrateur doit indiquer une fois quels modules vous utiliserez. Cochez ce dont vous avez besoin et continuez. Vous pourrez le modifier plus tard avec le bouton Services d'arrière-plan de la barre du haut.
Vous voyezUne liste unique des modules avec la mémoire qu'ils demandent.
Si vous voyez un message
DémarrageL'écran de chargement reste affiché une minute ou plus au tout premier démarrage.
Cela signifie L'application crée sa base de données locale. Cela n'arrive qu'une fois.
À faire Patientez et ne fermez pas la fenêtre. Sur un disque lent ou presque plein, cela peut prendre plus de temps. Les démarrages suivants sont rapides.
Démarrage"The backend started, but the local database is not answering, so the app cannot open."Signification : la partie serveur a démarré, mais sa base de données locale ne répond pas, donc l'application ne peut pas s'ouvrir.
Cela signifie La base de données locale n'a pas démarré, souvent après une session qui ne s'est pas fermée proprement.
À faire Redémarrez l'ordinateur et relancez l'application. Si cela se répète, envoyez-nous desktop-launcher.log et le journal de la base de données (voir Journaux).
Démarrage"The backend started, but this installation is missing the application files it serves"Signification : la partie serveur a démarré, mais il manque à l'installation les fichiers de l'interface utilisateur.
Cela signifie Une partie du dossier du programme manque, en général supprimée par l'antivirus.
À faire Vérifiez la quarantaine de votre antivirus, puis relancez l'installeur par-dessus l'installation existante. Vos projets ne sont pas touchés.
Démarrage"The application backend did not start in time", ou "The application backend stopped responding while preparing the local database" (ou à une autre étape).
Cela signifie Le démarrage a pris plus de temps que l'application n'attend. Le message indique l'étape en cours.
À faire Fermez la fenêtre et relancez. Libérez d'abord de l'espace disque si le disque est presque plein. Si cela s'arrête de nouveau à la même étape, envoyez-nous desktop-launcher.log.
Démarrage"The application never finished unpacking itself, so its backend never started." ou "The application could not unpack itself into the temporary folder it uses."
Cela signifie Sous macOS et Linux, l'application décompresse son backend à chaque démarrage. Un disque lent ou plein, ou un antivirus qui verrouille les fichiers, l'en empêche. (L'application Windows ne se décompresse plus depuis la 18.5.)
À faire Libérez de l'espace sur le disque qui contient votre dossier temporaire, ou autorisez l'application dans votre antivirus, puis relancez.
Démarrage"The drive ran out of space while the application was starting" ou "There is not enough free space to start the application".
Cela signifie C'est exactement cela. Le message indique le dossier et l'espace libre restant.
À faire Libérez de l'espace sur ce disque et relancez.
En cours d'utilisation"The application backend stopped, restarting" et la fenêtre se recharge.
Cela signifie La partie de l'application qui tourne en arrière-plan s'est arrêtée de façon inattendue et l'application l'a relancée. Le travail enregistré est conservé. Cela se produit au plus deux fois en 30 minutes.
À faire Continuez. Si cela se répète, ou si vous voyez "The application backend has stopped", envoyez-nous desktop-launcher.log et logs/backend-crash.log.
DémarrageÀ chaque démarrage de l'application, vous êtes déconnecté et la langue repasse en anglais.
Cela signifie Un autre programme utilise le port 8732, celui que l'application utilise normalement. La version 18.5.0 choisit alors un port libre au hasard à chaque démarrage, et la fenêtre traite chaque nouveau port comme un nouveau site, donc la connexion et la langue sont introuvables.
À faire Fermez ou reconfigurez l'autre programme qui utilise le port 8732 (sous Windows, lancez netstat -ano | findstr :8732 dans un terminal pour voir son identifiant de processus). Vos projets ne sont pas touchés, seulement la connexion et le choix de la langue.
DémarrageVous craignez que l'application entre en conflit avec un PostgreSQL déjà actif sur le port 5432.
Cela signifie Ce n'est pas le cas. Sous Windows, la base de données intégrée prend un port local libre au hasard, et sous macOS et Linux elle écoute uniquement sur un socket local, pas sur un port TCP.
À faire Rien à faire.
Installation« "OpenConstructionERP" est endommagé et ne peut pas être ouvert. »
Cela signifie L'application n'est pas encore notariée par Apple et porte toujours la marque de téléchargement. Elle n'est pas endommagée.
À faire Seule cette solution marche : dans Terminal, lancez une fois xattr -dr com.apple.quarantine /Applications/OpenConstructionERP.app, puis ouvrez l'application normalement.
Installation« "OpenConstructionERP" ne peut pas être ouvert car le développeur ne peut pas être vérifié » (ou Apple n'a pas pu vérifier l'absence de logiciels malveillants).
Cela signifie L'application est signée ad hoc mais pas encore notariée par Apple.
À faire Lancez la même commande xattr, ou ouvrez Réglages Système, Confidentialité & sécurité, faites défiler vers le bas et cliquez sur Ouvrir quand même. Vous ne le faites qu'une fois.
InstallationL'application ne se lance pas du tout sur votre Mac.
Cela signifie La version Mac est réservée à Apple Silicon (M1 et plus récent). Il n'y a pas de version Intel.
À faire Sur un Mac Intel, utilisez pip (Python 3.12 ou plus récent) ou Docker.
Où se trouvent les journaux
desktop-launcher.log~/.openestimate/desktop-launcher.logTout ce que l'application de bureau a fait au démarrage. Toujours dans votre dossier personnel, même si vous avez déplacé le dossier de données.backend-crash.log~/.openestimate/logs/backend-crash.logDétails d'un arrêt inattendu. Se trouve dans le dossier de données, donc il suitOE_DATA_DIR.database log folder~/.openestimate/pgdata/logPourquoi la base de données intégrée n'a pas démarré.
Pour ouvrir le dossier depuis un terminal :
open ~/.openestimateLinux
Linux: .deb (Ubuntu, Debian, Mint)
- 1
Téléchargez
OpenConstructionERP_18.5.0_amd64.deb.Vous voyezUn fichier d'environ 830 Mo.
- 2
Dans un terminal, dans le dossier de téléchargement, lancez.
sudo apt install ./OpenConstructionERP_18.5.0_amd64.debVous voyezapt liste le paquet et les bibliothèques nécessaires, puis les installe. Le ./ devant le nom du fichier est important.
- 3
Lancez OpenConstructionERP depuis le menu des applications.
Vous voyezL'écran de chargement. Le premier démarrage prend une ou deux minutes.
- 4
Connectez-vous avec le compte de démonstration : e-mail demo@openconstructionerp.com, mot de passe DemoPass1234!. Vous pourrez ensuite créer votre propre compte et vos projets.
Vous voyezL'application. Les projets de démonstration sont créés en arrière-plan au premier démarrage, la liste des projets peut donc indiquer un court instant qu'ils arrivent.
- 5
Sur une installation neuve, l'administrateur doit indiquer une fois quels modules vous utiliserez. Cochez ce dont vous avez besoin et continuez. Vous pourrez le modifier plus tard avec le bouton Services d'arrière-plan de la barre du haut.
Vous voyezUne liste unique des modules avec la mémoire qu'ils demandent.
Linux: .rpm (Fedora, RHEL, Rocky)
- 1
Téléchargez
OpenConstructionERP-18.5.0-1.x86_64.rpm.Vous voyezUn fichier d'environ 850 Mo.
- 2
Lancez.
sudo dnf install ./OpenConstructionERP-18.5.0-1.x86_64.rpmVous voyezdnf résout les dépendances et installe.
- 3
Lancez OpenConstructionERP depuis le menu des applications.
Vous voyezL'écran de chargement. Le premier démarrage prend une ou deux minutes.
- 4
Connectez-vous avec le compte de démonstration : e-mail demo@openconstructionerp.com, mot de passe DemoPass1234!. Vous pourrez ensuite créer votre propre compte et vos projets.
Vous voyezL'application. Les projets de démonstration sont créés en arrière-plan au premier démarrage, la liste des projets peut donc indiquer un court instant qu'ils arrivent.
- 5
Sur une installation neuve, l'administrateur doit indiquer une fois quels modules vous utiliserez. Cochez ce dont vous avez besoin et continuez. Vous pourrez le modifier plus tard avec le bouton Services d'arrière-plan de la barre du haut.
Vous voyezUne liste unique des modules avec la mémoire qu'ils demandent.
Linux: AppImage (any distribution)
- 1
Téléchargez
OpenConstructionERP_18.5.0_amd64.AppImage.Vous voyezUn fichier d'environ 910 Mo.
- 2
Rendez-le exécutable.
chmod +x OpenConstructionERP_18.5.0_amd64.AppImageVous voyezAucun résultat.
- 3
Lancez-le.
./OpenConstructionERP_18.5.0_amd64.AppImageVous voyezL'écran de chargement. Le premier démarrage prend une ou deux minutes.
- 4
Connectez-vous avec le compte de démonstration : e-mail demo@openconstructionerp.com, mot de passe DemoPass1234!. Vous pourrez ensuite créer votre propre compte et vos projets.
Vous voyezL'application. Les projets de démonstration sont créés en arrière-plan au premier démarrage, la liste des projets peut donc indiquer un court instant qu'ils arrivent.
- 5
Sur une installation neuve, l'administrateur doit indiquer une fois quels modules vous utiliserez. Cochez ce dont vous avez besoin et continuez. Vous pourrez le modifier plus tard avec le bouton Services d'arrière-plan de la barre du haut.
Vous voyezUne liste unique des modules avec la mémoire qu'ils demandent.
Si vous voyez un message
DémarrageL'écran de chargement reste affiché une minute ou plus au tout premier démarrage.
Cela signifie L'application crée sa base de données locale. Cela n'arrive qu'une fois.
À faire Patientez et ne fermez pas la fenêtre. Sur un disque lent ou presque plein, cela peut prendre plus de temps. Les démarrages suivants sont rapides.
Démarrage"The backend started, but the local database is not answering, so the app cannot open."Signification : la partie serveur a démarré, mais sa base de données locale ne répond pas, donc l'application ne peut pas s'ouvrir.
Cela signifie La base de données locale n'a pas démarré, souvent après une session qui ne s'est pas fermée proprement.
À faire Redémarrez l'ordinateur et relancez l'application. Si cela se répète, envoyez-nous desktop-launcher.log et le journal de la base de données (voir Journaux).
Démarrage"The backend started, but this installation is missing the application files it serves"Signification : la partie serveur a démarré, mais il manque à l'installation les fichiers de l'interface utilisateur.
Cela signifie Une partie du dossier du programme manque, en général supprimée par l'antivirus.
À faire Vérifiez la quarantaine de votre antivirus, puis relancez l'installeur par-dessus l'installation existante. Vos projets ne sont pas touchés.
Démarrage"The application backend did not start in time", ou "The application backend stopped responding while preparing the local database" (ou à une autre étape).
Cela signifie Le démarrage a pris plus de temps que l'application n'attend. Le message indique l'étape en cours.
À faire Fermez la fenêtre et relancez. Libérez d'abord de l'espace disque si le disque est presque plein. Si cela s'arrête de nouveau à la même étape, envoyez-nous desktop-launcher.log.
Démarrage"The application never finished unpacking itself, so its backend never started." ou "The application could not unpack itself into the temporary folder it uses."
Cela signifie Sous macOS et Linux, l'application décompresse son backend à chaque démarrage. Un disque lent ou plein, ou un antivirus qui verrouille les fichiers, l'en empêche. (L'application Windows ne se décompresse plus depuis la 18.5.)
À faire Libérez de l'espace sur le disque qui contient votre dossier temporaire, ou autorisez l'application dans votre antivirus, puis relancez.
Démarrage"The drive ran out of space while the application was starting" ou "There is not enough free space to start the application".
Cela signifie C'est exactement cela. Le message indique le dossier et l'espace libre restant.
À faire Libérez de l'espace sur ce disque et relancez.
En cours d'utilisation"The application backend stopped, restarting" et la fenêtre se recharge.
Cela signifie La partie de l'application qui tourne en arrière-plan s'est arrêtée de façon inattendue et l'application l'a relancée. Le travail enregistré est conservé. Cela se produit au plus deux fois en 30 minutes.
À faire Continuez. Si cela se répète, ou si vous voyez "The application backend has stopped", envoyez-nous desktop-launcher.log et logs/backend-crash.log.
DémarrageÀ chaque démarrage de l'application, vous êtes déconnecté et la langue repasse en anglais.
Cela signifie Un autre programme utilise le port 8732, celui que l'application utilise normalement. La version 18.5.0 choisit alors un port libre au hasard à chaque démarrage, et la fenêtre traite chaque nouveau port comme un nouveau site, donc la connexion et la langue sont introuvables.
À faire Fermez ou reconfigurez l'autre programme qui utilise le port 8732 (sous Windows, lancez netstat -ano | findstr :8732 dans un terminal pour voir son identifiant de processus). Vos projets ne sont pas touchés, seulement la connexion et le choix de la langue.
DémarrageVous craignez que l'application entre en conflit avec un PostgreSQL déjà actif sur le port 5432.
Cela signifie Ce n'est pas le cas. Sous Windows, la base de données intégrée prend un port local libre au hasard, et sous macOS et Linux elle écoute uniquement sur un socket local, pas sur un port TCP.
À faire Rien à faire.
InstallationLe .deb demande libwebkit2gtk-4.1-0, ou dpkg signale des dépendances non satisfaites.
Cela signifie L'application a besoin de WebKitGTK 4.1 pour dessiner sa fenêtre. dpkg -i n'installe pas les dépendances.
À faire Installez avec sudo apt install ./OpenConstructionERP_18.5.0_amd64.deb, qui ajoute la bibliothèque. Si votre distribution n'a pas libwebkit2gtk-4.1-0 (Ubuntu plus ancien que 22.04, Debian plus ancien que 12), utilisez pip.
InstallationL'AppImage ne fait rien quand vous double-cliquez dessus.
Cela signifie Le fichier n'est pas encore marqué comme programme.
À faire Lancez chmod +x OpenConstructionERP_18.5.0_amd64.AppImage puis relancez-le.
InstallationUne erreur AppImage qui mentionne FUSE ou libfuse.so.2.
Cela signifie Les distributions récentes n'installent plus la bibliothèque FUSE 2 dont les AppImage ont besoin.
À faire Installez-la (sudo apt install libfuse2, sur Ubuntu 24.04 sudo apt install libfuse2t64), ou utilisez le .deb, le .rpm ou pip.
Où se trouvent les journaux
desktop-launcher.log~/.openestimate/desktop-launcher.logTout ce que l'application de bureau a fait au démarrage. Toujours dans votre dossier personnel, même si vous avez déplacé le dossier de données.backend-crash.log~/.openestimate/logs/backend-crash.logDétails d'un arrêt inattendu. Se trouve dans le dossier de données, donc il suitOE_DATA_DIR.database log folder~/.openestimate/pgdata/logPourquoi la base de données intégrée n'a pas démarré.
Pour ouvrir le dossier depuis un terminal :
xdg-open ~/.openestimatepip
- 1
Lancez.
pip install --upgrade openconstructionerpVous voyezpip télécharge le paquet et ses dépendances.
- 2
Lancez.
openconstructionerpVous voyezUn court message de bienvenue. Au premier lancement, il demande s'il faut charger les projets de démonstration et ouvrir votre navigateur.
- 3
Patientez pendant la mise en place de la base de données locale.
Vous voyez"Database: embedded PostgreSQL 16 (no Docker)" puis le serveur démarre. Votre navigateur ouvre http://127.0.0.1:8080 (comme http://localhost:8080).
- 4
Connectez-vous. Avec les données de démonstration, utilisez demo@openconstructionerp.com / DemoPass1234!
Vous voyezLe tableau de bord.
- 5
Sur une installation neuve, l'administrateur doit indiquer une fois quels modules vous utiliserez. Cochez ce dont vous avez besoin et continuez. Vous pourrez le modifier plus tard avec le bouton Services d'arrière-plan de la barre du haut.
Vous voyezUne liste unique des modules avec la mémoire qu'ils demandent.
- 6
Pour arrêter, appuyez sur Ctrl+C dans le terminal. La fois suivante, relancez simplement openconstructionerp.
Vous voyezLe serveur s'arrête. Vos données restent dans le dossier
.openestimatede votre dossier personnel.
Commandes utiles
La commande openconstructionerp est introuvable
python -m openconstructionerpQuelque chose ne marche pas : vérifie Python, le port, le dossier de données et la base de données, et indique quoi faire
openconstructionerp doctorLe port 8080 est pris par un autre programme
openconstructionerp serve --port 8081Les autres ordinateurs de votre réseau doivent pouvoir y accéder
openconstructionerp serve --host 0.0.0.0 --port 8080Vous devez nous indiquer votre version
openconstructionerp --versionSi vous voyez un message
Installationpip dit qu'aucune distribution correspondante n'a été trouvée, ou qu'il faut une autre version de Python.
Cela signifie OpenConstructionERP a besoin de Python 3.12 ou plus récent.
À faire Installez Python 3.12 ou plus récent et lancez python3.12 -m pip install --upgrade openconstructionerp (sous Windows : py -3.12 -m pip install --upgrade openconstructionerp).
Installationerror: externally-managed-environment (Ubuntu 23.04+, Debian 12+).Signification : votre système Linux protège son propre Python et refuse d'y installer des paquets.
Cela signifie Le Python du système n'autorise pas pip à y installer quoi que ce soit.
À faire Utilisez pipx install openconstructionerp, ou créez d'abord un environnement virtuel : python3 -m venv ~/oe && ~/oe/bin/pip install openconstructionerp.
Démarrage"openconstructionerp" is not recognized, ou command not found.
Cela signifie Le dossier où pip place les commandes n'est pas dans votre PATH (fréquent sous Windows).
À faire Lancez plutôt python -m openconstructionerp. Cela marche sur tous les systèmes sans toucher au PATH.
Démarrage"Port 8080 is already in use. Try: openconstructionerp serve --port 8081"Signification : un autre programme utilise déjà le port 8080, lancez donc l'application sur un autre port, par exemple 8081.
Cela signifie Un autre programme utilise le port 8080.
À faire Lancez la commande suggérée et ouvrez l'adresse qu'elle affiche.
Démarrage"Embedded PostgreSQL could not start".Signification : la base de données PostgreSQL intégrée n'a pas pu démarrer.
Cela signifie La base de données intégrée n'a pas démarré. Le message affiche le chemin de son journal.
À faire Lancez openconstructionerp doctor. Si cela ne suffit pas, réinstallez avec pip install --upgrade --force-reinstall openconstructionerp et envoyez-nous le journal indiqué.
Où se trouvent les journaux
terminal outputthe terminal window (pip);docker compose logs app(Docker)Pour pip et Docker, copiez ce que le terminal a affiché et la sortie deopenconstructionerp doctor.
Docker
- 1
Dans un dossier vide, téléchargez les deux fichiers compose.
curl -fsSL https://raw.githubusercontent.com/datadrivenconstruction/OpenConstructionERP/main/docker-compose.quickstart.yml -o docker-compose.ymlcurl -fsSL https://raw.githubusercontent.com/datadrivenconstruction/OpenConstructionERP/main/docker-compose.quickstart.image.yml -o docker-compose.override.ymlVous voyezDeux fichiers dans le dossier.
- 2
Créez une fois le fichier des secrets.
echo "POSTGRES_PASSWORD=$(openssl rand -base64 24)" > .envecho "JWT_SECRET=$(openssl rand -hex 32)" >> .envVous voyezUn fichier
.env. Gardez-le : il contient le mot de passe de la base de données et le secret de connexion. - 3
Lancez-le.
docker compose pull app && docker compose up -dVous voyezDeux conteneurs démarrent : postgres et app.
- 4
Ouvrez http://localhost:8080 et connectez-vous avec demo@openconstructionerp.com / DemoPass1234!
Vous voyezLa page de connexion. Le premier démarrage peut prendre une minute, le temps de préparer la base de données.
- 5
Sur une installation neuve, l'administrateur doit indiquer une fois quels modules vous utiliserez. Cochez ce dont vous avez besoin et continuez. Vous pourrez le modifier plus tard avec le bouton Services d'arrière-plan de la barre du haut.
Vous voyezUne liste unique des modules avec la mémoire qu'ils demandent.
Commandes utiles
Vérifier que les deux conteneurs tournent et sont en bonne santé
docker compose psVoir pourquoi l'application ne démarre pas
docker compose logs appLe port 8080 de votre machine est pris
OE_PORT=8081 OE_ALLOWED_ORIGINS=http://localhost:8081 docker compose up -dCette configuration compose sert à l'évaluation et à un usage local. Pour un serveur de production, voir docs/INSTALL_LINUX.md et docker-compose.prod.yml dans le dépôt.
Si vous voyez un message
DémarrageCompose s'arrête avec "POSTGRES_PASSWORD must be set" ou "JWT_SECRET must be set".
Cela signifie Le fichier .env avec les deux secrets est absent ou n'est pas dans le même dossier.
À faire Créez le fichier .env comme à l'étape 2, dans le dossier qui contient docker-compose.yml.
Démarragehttp://localhost:8080 ne s'ouvre pas.
Cela signifie Le conteneur ne tourne pas encore, ou le port 8080 est pris.
À faire Lancez docker compose ps et docker compose logs app. Pour utiliser un autre port : OE_PORT=8081 OE_ALLOWED_ORIGINS=http://localhost:8081 docker compose up -d, puis ouvrez http://localhost:8081.
InstallationSur un Mac Apple Silicon ou une autre machine ARM, Docker avertit que la plateforme de l'image linux/amd64 ne correspond pas, ou l'application est très lente.
Cela signifie L'image publiée est construite uniquement pour x86-64.
À faire Construisez depuis les sources avec make quickstart, ou utilisez pip.
Où se trouvent les journaux
terminal outputthe terminal window (pip);docker compose logs app(Docker)Pour pip et Docker, copiez ce que le terminal a affiché et la sortie deopenconstructionerp doctor.
Vos données, mises à jour et désinstallation
- Windows
C:\Users\<your name>\.openestimatePlusC:\ProgramData\OpenConstructionERP\clusters\<id>\pgdatasi votre nom d'utilisateur contient des lettres non latines ;pgdata.locationl'indique. - macOS~/
.openestimate(caché ; appuyez sur Cmd+Maj+. dans le Finder) - Linux~/
.openestimate - pip~/
.openestimate, le même dossier que l'application de bureau, sauf si vous passez--data-dirou définissezOE_DATA_DIR - Dockerles volumes Docker <folder>_pg_data (base de données) et <folder>_app_data (fichiers), où <folder> est le nom du dossier qui contient
docker-compose.yml
Mise à jour
Installez la nouvelle version par-dessus l'ancienne. Votre dossier .openestimate ne fait pas partie du programme, donc projets, utilisateurs et réglages sont conservés. Le premier démarrage après une mise à jour peut être plus long, le temps que la base de données se mette à jour.
Désinstallation
Désinstaller retire le programme et conserve vos projets. Sous Windows, le désinstalleur propose "Delete the application data" (dans la langue de l'installeur) : cela supprime seulement la connexion et la langue enregistrées par la fenêtre de l'application (dans %APPDATA% et %LOCALAPPDATA%\io.openconstructionerp.desktop), pas vos projets. Pour repartir de zéro, désinstallez, copiez .openestimate en lieu sûr, puis supprimez-le.
Sauvegarde
Fermez l'application et copiez le dossier .openestimate (et le dossier ProgramData indiqué dans pgdata.location, s'il y en a un).
Toujours bloqué ? Nous vous aidons
Merci d'indiquer :
- la version (elle figure dans le nom du fichier téléchargé ; pip :
openconstructionerp --version; Docker : le tag de l'image) et comment vous avez installé (installeur Windows, .dmg, .deb, .rpm, AppImage, pip ou Docker) - votre système (Windows : Démarrer, tapez
winver; macOS : menu Pomme, À propos de ce Mac ; Linux : la distribution et la version) - le texte exact du message, ou une capture d'écran
- les fichiers journaux indiqués plus haut
Les fichiers journaux peuvent contenir votre nom d'utilisateur et des noms de dossiers. Relisez-les avant de les publier ; envoyez-les par e-mail si vous préférez.
Étapes suivantes après l’installation
Le texte complet est aussi sur GitHub en English, Deutsch et Русский.