Помощ при инсталиране
Инсталиране на OpenConstructionERP
Изберете как искате да го стартирате, следвайте номерираните стъпки и ако нещо изглежда нередно, намерете съобщението, което виждате, в списъка с проблеми по-долу. Нито едно от предупрежденията по време на инсталирането не застрашава проектите ви.
Не сте сигурни кое ви трябва?
- Ползвате Windows 10 или 11Инсталатор за Windows (.exe)
- Имате Mac с чип M1, M2, M3 или M4macOS (.dmg, Apple Silicon)
- Имате Mac с Intelpip или Docker (за Mac с Intel няма приложение)
- Ползвате Ubuntu, Debian или Linux MintLinux .deb
- Ползвате Fedora, RHEL или Rocky LinuxLinux .rpm
- Ползвате друга дистрибуция на LinuxLinux AppImage
- Вече имате Python 3.12 или по-нов, или го искате на сървърpip
- Ползвате Docker или го настройвате за екипDocker
Гледайте първо
Как да инсталирате OpenConstructionERP
Видеоинструкция за Windows, записана с версия 17.7.1. Някои екрани в 18.5 изглеждат различно, а чакането по време на инсталацията във видеото е съкратено.
Windows
- 1
Изтеглете
OpenConstructionERP_18.5.0_x64-setup.exeот страницата на изданието.ВиждатеФайл от около 800 MB в папката Downloads.
- 2
Щракнете два пъти върху него. Ако син прозорец казва "Windows защити вашия компютър" ("Windows protected your PC"), натиснете Повече информация ("More info"), проверете дали името на файла започва с OpenConstructionERP и натиснете Изпълни въпреки това ("Run anyway").
ВиждатеWindows иска администраторски права. Натиснете Да.
- 3
Изберете езика на инсталатора, приемете лиценза и запазете предложената папка
C:\Program Files\OpenConstructionERP.ВиждатеЛента за напредък, после страница за завършване.
- 4
Натиснете Готово или стартирайте OpenConstructionERP от менюто Старт.
ВиждатеЕкран за зареждане "Приложението се стартира" със списък: стартиране на бекенда, стартиране на локалната база данни, подготовка на базата данни, стартиране на сървъра на приложението, отваряне на приложението.
- 5
Изчакайте при най-първото стартиране. Не затваряйте прозореца.
Виждате"При първото стартиране се създава локалната ви база данни. Това може да отнеме минута или две, моля изчакайте." Следващите стартирания са много по-бързи.
- 6
Изберете как да се отвори: като прозорец на приложението (препоръчително) или във вашия обикновен браузър.
Виждате"Как искате да отворите OpenConstructionERP?" и после страницата за вход.
- 7
Влезте с демо акаунта: имейл demo@openconstructionerp.com, парола DemoPass1234!. След това можете да създадете собствен акаунт и проекти.
ВиждатеПриложението. Демо проектите се създават на заден план при първото стартиране, затова списъкът с проекти може за кратко да показва, че са на път.
- 8
При нова инсталация администраторът бива попитан веднъж кои модули ще ползвате. Отбележете нужните и продължете. По-късно можете да го промените с бутона Фонови услуги в горната лента.
ВиждатеЕднократен списък с модули и паметта, която им е нужна.
Ако видите съобщение
ИнсталиранеСин прозорец "Windows защити вашия компютър" ("Windows protected your PC").
Какво означава Инсталаторът още не е подписан с код, затова Windows не познава издателя. Това е предупреждение, а не откриване на вирус.
Какво да направите Натиснете Повече информация ("More info"), проверете дали името на файла започва с OpenConstructionERP и натиснете Изпълни въпреки това ("Run anyway").
ИнсталиранеSmart App Control блокира приложението, без бутон за продължаване.
Какво означава Smart App Control на Windows 11 отхвърля неподписани програми.
Какво да направите Smart App Control не може да разреши едно-единствено приложение. За да остане включен, стартирайте OpenConstructionERP с Docker Desktop или в WSL (вградения в Windows Linux), които Smart App Control не проверява. Инструкции стъпка по стъпка: docs/desktop/WINDOWS_BLOCKED.md в хранилището.
Инсталиране"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" (съобщението има само на английски)Значение: пътят до папката за инсталиране може да съдържа само латински букви, цифри и интервали, защото вградената база данни не може да стартира от друг път.
Какво означава Избраната папка има в пътя си кирилица, китайски, букви с ударения или други нелатински знаци.
Какво да направите Запазете предложената C:\Program Files\OpenConstructionERP или изберете папка като C:\OpenConstructionERP. Тихо инсталиране (/S) завършва с код 3 и записва причината в %TEMP%\OpenConstructionERP-install-error.log.
ИнсталиранеИнсталаторът спира с грешка за WebView2.
Какво означава Windows отказа да инсталира Microsoft WebView2, компонента, който чертае прозореца на приложението. Той е в инсталатора, така че не е нужен интернет; грешката идва от самия Windows (политика, чакаща актуализация или повреден по-стар WebView2).
Какво да направите Рестартирайте компютъра и пуснете инсталатора отново. Ако пак не успее, инсталирайте "Microsoft Edge WebView2 Runtime" от Microsoft и после пуснете нашия инсталатор още веднъж.
ИнсталиранеАнтивирусната ви програма изтрива файл или го поставя под карантина по време на инсталирането или при първото стартиране.
Какво означава Програмата е нова и неподписана и някои антивирусни програми я гледат подозрително.
Какво да направите Възстановете файла от карантината и добавете тези две папки към изключенията: папката на програмата C:\Program Files\OpenConstructionERP и вашата папка с данни C:\Users\<your name>\.openestimate. После пуснете инсталатора отново върху съществуващата инсталация. Ако не сте сигурни дали файлът е автентичен, първо ни пишете.
НадгражданеЕкран, който пита дали да презапише инсталираната версия, или първо да я премахне, с ред, който предлага премахване.
Какво да направите Оставете вече избраната опция (презаписване). Проектите ви се запазват. Първото стартиране след надграждане може да отнеме повече време, докато базата данни се обновява сама.
НадгражданеСтартирате OpenConstructionERP и през pip или от терминал на същия компютър, и той спира по време на надграждането.
Какво означава И двата използват една и съща папка .openestimate и една и съща база данни. Инсталаторът спира тази база, за да смени програмата. При надграждане от 18.4.0 старият деинсталатор затваря и всяка програма с име openconstructionerp.exe.
Какво да направите Спрете терминалната версия (Ctrl+C) преди инсталиране или надграждане и я стартирайте отново след това.
СтартиранеЕкранът за зареждане стои минута или повече при най-първото стартиране.
Какво означава Приложението създава своята локална база данни. Това се случва само веднъж.
Какво да направите Изчакайте и не затваряйте прозореца. На бавен или почти пълен диск може да отнеме повече време. Следващите стартирания са бързи.
СтартиранеПрозорец "OpenConstructionERP failed to start", който посочва лог файл.
Какво означава Приложението изобщо не успя да отвори прозореца си.
Какво да направите Стартирайте го още веднъж. Ако прозорецът се върне, изпратете ни лог файла, който посочва.
Стартиране"The backend started, but the local database is not answering, so the app cannot open."Значение: сървърната част е стартирала, но локалната ѝ база данни не отговаря, затова приложението не може да се отвори.
Какво означава Локалната база данни не стартира, често след работа, която не е била затворена правилно.
Какво да направите Рестартирайте компютъра и стартирайте приложението отново. Ако се повтори, изпратете ни desktop-launcher.log и лога на базата данни (вижте Логове).
Стартиране"The backend started, but this installation is missing the application files it serves"Значение: сървърната част е стартирала, но в инсталацията липсват файловете на потребителския интерфейс.
Какво означава Липсва част от папката на програмата, обикновено изтрита от антивируса.
Какво да направите Проверете карантината на антивируса и после пуснете инсталатора отново върху съществуващата инсталация. Проектите ви не се докосват.
Стартиране"The application backend did not start in time" или "The application backend stopped responding while preparing the local database" (или на друга стъпка).
Какво означава Стартирането отне повече, отколкото приложението чака. Съобщението посочва стъпката, на която е било.
Какво да направите Затворете прозореца и стартирайте отново. Първо освободете място на диска, ако е почти пълен. Ако спре пак на същата стъпка, изпратете ни desktop-launcher.log.
Стартиране"The drive ran out of space while the application was starting" или "There is not enough free space to start the application".
Какво означава Точно това. Съобщението посочва папката и оставащото свободно място.
Какво да направите Освободете място на това устройство и стартирайте отново.
СтартиранеСъобщение, че папката на локалната база данни "sits too deep in the filesystem", с две числа.
Какво означава Windows ограничава дължината на пътя, а пътят до папката ви с данни е твърде дълъг за файловете на базата. Включването на дългите пътища в Windows не помага.
Какво да направите Задайте потребителската променлива на средата OE_DATA_DIR на къс път като C:\OpenConstructionERP\data (Старт, напишете "променливи на средата", Редактиране на променливите на средата за вашия акаунт, Нова) и после стартирайте отново.
СтартиранеПотребителското ви име в Windows има нелатински знаци (например кирилица или китайски) и търсите базата си данни.
Какво означава Вградената база данни не може да работи от такъв път, затова от 18.5.0 насам приложението я държи в C:\ProgramData\OpenConstructionERP\clusters\<id>\pgdata. Преди 18.5.0 приложението изобщо не можеше да стартира за такива акаунти.
Какво да направите Няма какво да се поправя. Файлът pgdata.location във вашата папка .openestimate посочва точната папка на базата данни. За резервни копия копирайте двете папки.
По време на работа"The application backend stopped, restarting" и прозорецът се презарежда.
Какво означава Фоновата част на приложението спря неочаквано и приложението я рестартира. Запазената работа се пази. Това се случва най-много два пъти за 30 минути.
Какво да направите Продължете. Ако се повтори или видите "The application backend has stopped", изпратете ни desktop-launcher.log и logs/backend-crash.log.
СтартиранеВсеки път, когато стартирате приложението, излизате от акаунта си, а езикът се връща на английски.
Какво означава Друга програма използва порт 8732, който приложението обикновено ползва. Тогава версия 18.5.0 избира случаен свободен порт при всяко стартиране, а прозорецът третира всеки нов порт като нов сайт, затова входът и езикът не се намират.
Какво да направите Затворете или конфигурирайте наново другата програма, която използва порт 8732 (в Windows изпълнете netstat -ano | findstr :8732 в терминал, за да видите идентификатора ѝ на процес). Проектите ви не са засегнати, само входът и изборът на език.
СтартиранеПритеснявате се, че приложението е в конфликт с PostgreSQL, който вече ползвате на порт 5432.
Какво означава Не е. Вградената база данни в Windows взима случаен свободен локален порт, а в macOS и Linux слуша само на локален сокет, не на TCP порт.
Какво да направите Няма какво да се прави.
Къде са логовете
desktop-launcher.logC:\Users\<your name>\.openestimate\desktop-launcher.logВсичко, което настолното приложение е направило при стартиране. Винаги в началната ви папка, дори да сте преместили папката с данни.backend-crash.logC:\Users\<your name>\.openestimate\logs\backend-crash.logПодробности за неочаквано спиране. Стои в папката с данни, затова се мести заедно сOE_DATA_DIR.database log folderC:\Users\<your name>\.openestimate\pgdata\log (or <folder frompgdata.location>\log)Защо вградената база данни не е стартирала.OpenConstructionERP-install-error.log%TEMP%\OpenConstructionERP-install-error.log(въведете%TEMP%в адресната лента на Explorer)Защо инсталаторът на Windows е отказал папката за инсталиране.
За да отворите папката, поставете това в адресната лента на Explorer:
%USERPROFILE%\.openestimatemacOS
- 1
Изтеглете
OpenConstructionERP_18.5.0_aarch64.dmgи го отворете.ВиждатеПрозорец с иконата на приложението OpenConstructionERP.
- 2
Плъзнете OpenConstructionERP в Applications.
ВиждатеПриложението се появява в папката Applications.
- 3
Отворете Terminal веднъж и изпълнете.
xattr -dr com.apple.quarantine /Applications/OpenConstructionERP.appВиждатеНяма изход. Това е правилно. Командата маха маркера за изтеглено, защото приложението още не е нотаризирано от Apple.
- 4
Отворете OpenConstructionERP от Applications.
ВиждатеЕкранът за зареждане "Приложението се стартира". Първото стартиране подготвя локалната база данни и отнема минута или две.
- 5
Изберете прозорец на приложението или браузър.
ВиждатеСтраницата за вход.
- 6
Влезте с демо акаунта: имейл demo@openconstructionerp.com, парола DemoPass1234!. След това можете да създадете собствен акаунт и проекти.
ВиждатеПриложението. Демо проектите се създават на заден план при първото стартиране, затова списъкът с проекти може за кратко да показва, че са на път.
- 7
При нова инсталация администраторът бива попитан веднъж кои модули ще ползвате. Отбележете нужните и продължете. По-късно можете да го промените с бутона Фонови услуги в горната лента.
ВиждатеЕднократен списък с модули и паметта, която им е нужна.
Ако видите съобщение
СтартиранеЕкранът за зареждане стои минута или повече при най-първото стартиране.
Какво означава Приложението създава своята локална база данни. Това се случва само веднъж.
Какво да направите Изчакайте и не затваряйте прозореца. На бавен или почти пълен диск може да отнеме повече време. Следващите стартирания са бързи.
Стартиране"The backend started, but the local database is not answering, so the app cannot open."Значение: сървърната част е стартирала, но локалната ѝ база данни не отговаря, затова приложението не може да се отвори.
Какво означава Локалната база данни не стартира, често след работа, която не е била затворена правилно.
Какво да направите Рестартирайте компютъра и стартирайте приложението отново. Ако се повтори, изпратете ни desktop-launcher.log и лога на базата данни (вижте Логове).
Стартиране"The backend started, but this installation is missing the application files it serves"Значение: сървърната част е стартирала, но в инсталацията липсват файловете на потребителския интерфейс.
Какво означава Липсва част от папката на програмата, обикновено изтрита от антивируса.
Какво да направите Проверете карантината на антивируса и после пуснете инсталатора отново върху съществуващата инсталация. Проектите ви не се докосват.
Стартиране"The application backend did not start in time" или "The application backend stopped responding while preparing the local database" (или на друга стъпка).
Какво означава Стартирането отне повече, отколкото приложението чака. Съобщението посочва стъпката, на която е било.
Какво да направите Затворете прозореца и стартирайте отново. Първо освободете място на диска, ако е почти пълен. Ако спре пак на същата стъпка, изпратете ни desktop-launcher.log.
Стартиране"The application never finished unpacking itself, so its backend never started." или "The application could not unpack itself into the temporary folder it uses."
Какво означава В macOS и Linux приложението разархивира бекенда си при всяко стартиране. Бавен или пълен диск, или антивирус, който заключва файловете, го спира. (Приложението за Windows вече не се разархивира от 18.5.)
Какво да направите Освободете място на устройството с временната ви папка или разрешете приложението в антивируса, после стартирайте отново.
Стартиране"The drive ran out of space while the application was starting" или "There is not enough free space to start the application".
Какво означава Точно това. Съобщението посочва папката и оставащото свободно място.
Какво да направите Освободете място на това устройство и стартирайте отново.
По време на работа"The application backend stopped, restarting" и прозорецът се презарежда.
Какво означава Фоновата част на приложението спря неочаквано и приложението я рестартира. Запазената работа се пази. Това се случва най-много два пъти за 30 минути.
Какво да направите Продължете. Ако се повтори или видите "The application backend has stopped", изпратете ни desktop-launcher.log и logs/backend-crash.log.
СтартиранеВсеки път, когато стартирате приложението, излизате от акаунта си, а езикът се връща на английски.
Какво означава Друга програма използва порт 8732, който приложението обикновено ползва. Тогава версия 18.5.0 избира случаен свободен порт при всяко стартиране, а прозорецът третира всеки нов порт като нов сайт, затова входът и езикът не се намират.
Какво да направите Затворете или конфигурирайте наново другата програма, която използва порт 8732 (в Windows изпълнете netstat -ano | findstr :8732 в терминал, за да видите идентификатора ѝ на процес). Проектите ви не са засегнати, само входът и изборът на език.
СтартиранеПритеснявате се, че приложението е в конфликт с PostgreSQL, който вече ползвате на порт 5432.
Какво означава Не е. Вградената база данни в Windows взима случаен свободен локален порт, а в macOS и Linux слуша само на локален сокет, не на TCP порт.
Какво да направите Няма какво да се прави.
Инсталиране"OpenConstructionERP is damaged and can't be opened" (текстът може да е на езика на системата ви).
Какво означава Приложението още не е нотаризирано от Apple и все още носи маркера за изтеглено. Приложението не е повредено.
Какво да направите Помага само това: в Terminal изпълнете веднъж xattr -dr com.apple.quarantine /Applications/OpenConstructionERP.app и после отворете приложението нормално.
Инсталиране"OpenConstructionERP cannot be opened because the developer cannot be verified" (или Apple не е могла да провери, че няма злонамерен софтуер; текстът може да е на езика на системата ви).
Какво означава Приложението е подписано ad hoc, но още не е нотаризирано от Apple.
Какво да направите Изпълнете същата команда xattr или отворете System Settings, Privacy & Security, превъртете надолу и натиснете Open Anyway. Правите го само веднъж.
ИнсталиранеПриложението изобщо не работи на вашия Mac.
Какво означава Версията за Mac е само за Apple Silicon (M1 и по-нови). Няма версия за Intel.
Какво да направите На Mac с Intel ползвайте pip (Python 3.12 или по-нов) или Docker.
Къде са логовете
desktop-launcher.log~/.openestimate/desktop-launcher.logВсичко, което настолното приложение е направило при стартиране. Винаги в началната ви папка, дори да сте преместили папката с данни.backend-crash.log~/.openestimate/logs/backend-crash.logПодробности за неочаквано спиране. Стои в папката с данни, затова се мести заедно сOE_DATA_DIR.database log folder~/.openestimate/pgdata/logЗащо вградената база данни не е стартирала.
За да отворите папката от терминал:
open ~/.openestimateLinux
Linux: .deb (Ubuntu, Debian, Mint)
- 1
Изтеглете
OpenConstructionERP_18.5.0_amd64.deb.ВиждатеФайл от около 830 MB.
- 2
В терминал, в папката за изтегляне, изпълнете.
sudo apt install ./OpenConstructionERP_18.5.0_amd64.debВиждатеapt показва пакета и нужните библиотеки и ги инсталира. Важно е ./ пред името на файла.
- 3
Стартирайте OpenConstructionERP от менюто с приложения.
ВиждатеЕкранът за зареждане. Първото стартиране отнема минута или две.
- 4
Влезте с демо акаунта: имейл demo@openconstructionerp.com, парола DemoPass1234!. След това можете да създадете собствен акаунт и проекти.
ВиждатеПриложението. Демо проектите се създават на заден план при първото стартиране, затова списъкът с проекти може за кратко да показва, че са на път.
- 5
При нова инсталация администраторът бива попитан веднъж кои модули ще ползвате. Отбележете нужните и продължете. По-късно можете да го промените с бутона Фонови услуги в горната лента.
ВиждатеЕднократен списък с модули и паметта, която им е нужна.
Linux: .rpm (Fedora, RHEL, Rocky)
- 1
Изтеглете
OpenConstructionERP-18.5.0-1.x86_64.rpm.ВиждатеФайл от около 850 MB.
- 2
Изпълнете.
sudo dnf install ./OpenConstructionERP-18.5.0-1.x86_64.rpmВиждатеdnf разрешава зависимостите и инсталира.
- 3
Стартирайте OpenConstructionERP от менюто с приложения.
ВиждатеЕкранът за зареждане. Първото стартиране отнема минута или две.
- 4
Влезте с демо акаунта: имейл demo@openconstructionerp.com, парола DemoPass1234!. След това можете да създадете собствен акаунт и проекти.
ВиждатеПриложението. Демо проектите се създават на заден план при първото стартиране, затова списъкът с проекти може за кратко да показва, че са на път.
- 5
При нова инсталация администраторът бива попитан веднъж кои модули ще ползвате. Отбележете нужните и продължете. По-късно можете да го промените с бутона Фонови услуги в горната лента.
ВиждатеЕднократен списък с модули и паметта, която им е нужна.
Linux: AppImage (any distribution)
- 1
Изтеглете
OpenConstructionERP_18.5.0_amd64.AppImage.ВиждатеФайл от около 910 MB.
- 2
Направете го изпълним.
chmod +x OpenConstructionERP_18.5.0_amd64.AppImageВиждатеНяма изход.
- 3
Стартирайте го.
./OpenConstructionERP_18.5.0_amd64.AppImageВиждатеЕкранът за зареждане. Първото стартиране отнема минута или две.
- 4
Влезте с демо акаунта: имейл demo@openconstructionerp.com, парола DemoPass1234!. След това можете да създадете собствен акаунт и проекти.
ВиждатеПриложението. Демо проектите се създават на заден план при първото стартиране, затова списъкът с проекти може за кратко да показва, че са на път.
- 5
При нова инсталация администраторът бива попитан веднъж кои модули ще ползвате. Отбележете нужните и продължете. По-късно можете да го промените с бутона Фонови услуги в горната лента.
ВиждатеЕднократен списък с модули и паметта, която им е нужна.
Ако видите съобщение
СтартиранеЕкранът за зареждане стои минута или повече при най-първото стартиране.
Какво означава Приложението създава своята локална база данни. Това се случва само веднъж.
Какво да направите Изчакайте и не затваряйте прозореца. На бавен или почти пълен диск може да отнеме повече време. Следващите стартирания са бързи.
Стартиране"The backend started, but the local database is not answering, so the app cannot open."Значение: сървърната част е стартирала, но локалната ѝ база данни не отговаря, затова приложението не може да се отвори.
Какво означава Локалната база данни не стартира, често след работа, която не е била затворена правилно.
Какво да направите Рестартирайте компютъра и стартирайте приложението отново. Ако се повтори, изпратете ни desktop-launcher.log и лога на базата данни (вижте Логове).
Стартиране"The backend started, but this installation is missing the application files it serves"Значение: сървърната част е стартирала, но в инсталацията липсват файловете на потребителския интерфейс.
Какво означава Липсва част от папката на програмата, обикновено изтрита от антивируса.
Какво да направите Проверете карантината на антивируса и после пуснете инсталатора отново върху съществуващата инсталация. Проектите ви не се докосват.
Стартиране"The application backend did not start in time" или "The application backend stopped responding while preparing the local database" (или на друга стъпка).
Какво означава Стартирането отне повече, отколкото приложението чака. Съобщението посочва стъпката, на която е било.
Какво да направите Затворете прозореца и стартирайте отново. Първо освободете място на диска, ако е почти пълен. Ако спре пак на същата стъпка, изпратете ни desktop-launcher.log.
Стартиране"The application never finished unpacking itself, so its backend never started." или "The application could not unpack itself into the temporary folder it uses."
Какво означава В macOS и Linux приложението разархивира бекенда си при всяко стартиране. Бавен или пълен диск, или антивирус, който заключва файловете, го спира. (Приложението за Windows вече не се разархивира от 18.5.)
Какво да направите Освободете място на устройството с временната ви папка или разрешете приложението в антивируса, после стартирайте отново.
Стартиране"The drive ran out of space while the application was starting" или "There is not enough free space to start the application".
Какво означава Точно това. Съобщението посочва папката и оставащото свободно място.
Какво да направите Освободете място на това устройство и стартирайте отново.
По време на работа"The application backend stopped, restarting" и прозорецът се презарежда.
Какво означава Фоновата част на приложението спря неочаквано и приложението я рестартира. Запазената работа се пази. Това се случва най-много два пъти за 30 минути.
Какво да направите Продължете. Ако се повтори или видите "The application backend has stopped", изпратете ни desktop-launcher.log и logs/backend-crash.log.
СтартиранеВсеки път, когато стартирате приложението, излизате от акаунта си, а езикът се връща на английски.
Какво означава Друга програма използва порт 8732, който приложението обикновено ползва. Тогава версия 18.5.0 избира случаен свободен порт при всяко стартиране, а прозорецът третира всеки нов порт като нов сайт, затова входът и езикът не се намират.
Какво да направите Затворете или конфигурирайте наново другата програма, която използва порт 8732 (в Windows изпълнете netstat -ano | findstr :8732 в терминал, за да видите идентификатора ѝ на процес). Проектите ви не са засегнати, само входът и изборът на език.
СтартиранеПритеснявате се, че приложението е в конфликт с PostgreSQL, който вече ползвате на порт 5432.
Какво означава Не е. Вградената база данни в Windows взима случаен свободен локален порт, а в macOS и Linux слуша само на локален сокет, не на TCP порт.
Какво да направите Няма какво да се прави.
Инсталиране.deb иска libwebkit2gtk-4.1-0 или dpkg съобщава за неудовлетворени зависимости.
Какво означава Приложението се нуждае от WebKitGTK 4.1, за да начертае прозореца си. dpkg -i не инсталира зависимости.
Какво да направите Инсталирайте с sudo apt install ./OpenConstructionERP_18.5.0_amd64.deb, което донася и библиотеката. Ако вашата дистрибуция няма libwebkit2gtk-4.1-0 (Ubuntu по-стар от 22.04, Debian по-стар от 12), ползвайте pip.
ИнсталиранеAppImage не прави нищо при двойно щракване.
Какво означава Файлът още не е маркиран като програма.
Какво да направите Изпълнете chmod +x OpenConstructionERP_18.5.0_amd64.AppImage и го стартирайте отново.
ИнсталиранеГрешка на AppImage, която споменава FUSE или libfuse.so.2.
Какво означава По-новите дистрибуции вече не инсталират библиотеката FUSE 2, която ползват AppImage файловете.
Какво да направите Инсталирайте я (sudo apt install libfuse2, в Ubuntu 24.04 sudo apt install libfuse2t64) или ползвайте .deb, .rpm или pip.
Къде са логовете
desktop-launcher.log~/.openestimate/desktop-launcher.logВсичко, което настолното приложение е направило при стартиране. Винаги в началната ви папка, дори да сте преместили папката с данни.backend-crash.log~/.openestimate/logs/backend-crash.logПодробности за неочаквано спиране. Стои в папката с данни, затова се мести заедно сOE_DATA_DIR.database log folder~/.openestimate/pgdata/logЗащо вградената база данни не е стартирала.
За да отворите папката от терминал:
xdg-open ~/.openestimatepip
- 1
Изпълнете.
pip install --upgrade openconstructionerpВиждатеpip изтегля пакета и зависимостите му.
- 2
Изпълнете.
openconstructionerpВиждатеКратко приветствие. При първото изпълнение пита дали да зареди демо проектите и дали да отвори браузъра.
- 3
Изчакайте, докато се подготвя локалната база данни.
Виждате"Database: embedded PostgreSQL 16 (no Docker)" и после стартира сървърът. Браузърът ви отваря http://127.0.0.1:8080 (същото като http://localhost:8080).
- 4
Влезте. С демо данните можете да ползвате demo@openconstructionerp.com / DemoPass1234!
ВиждатеТаблото.
- 5
При нова инсталация администраторът бива попитан веднъж кои модули ще ползвате. Отбележете нужните и продължете. По-късно можете да го промените с бутона Фонови услуги в горната лента.
ВиждатеЕднократен списък с модули и паметта, която им е нужна.
- 6
За да спрете, натиснете Ctrl+C в терминала. Следващия път просто изпълнете openconstructionerp отново.
ВиждатеСървърът спира. Данните ви остават в папката
.openestimateв началната ви папка.
Полезни команди
Командата openconstructionerp не се намира
python -m openconstructionerpНещо не работи: проверява Python, порта, папката с данни и базата данни и казва какво да направите
openconstructionerp doctorПорт 8080 е зает от друга програма
openconstructionerp serve --port 8081Другите компютри във вашата мрежа трябва да имат достъп
openconstructionerp serve --host 0.0.0.0 --port 8080Трябва да ни кажете версията си
openconstructionerp --versionАко видите съобщение
Инсталиранеpip казва, че не е намерена подходяща дистрибуция или че се изисква друг Python.
Какво означава OpenConstructionERP изисква Python 3.12 или по-нов.
Какво да направите Инсталирайте Python 3.12 или по-нов и изпълнете python3.12 -m pip install --upgrade openconstructionerp (в Windows: py -3.12 -m pip install --upgrade openconstructionerp).
Инсталиранеerror: externally-managed-environment (Ubuntu 23.04+, Debian 12+).Значение: вашата Linux система защитава собствения си Python и отказва да инсталира пакети в него.
Какво означава Системният Python не позволява на pip да инсталира в него.
Какво да направите Ползвайте pipx install openconstructionerp или първо създайте виртуална среда: python3 -m venv ~/oe && ~/oe/bin/pip install openconstructionerp.
Стартиране"openconstructionerp" is not recognized или command not found.
Какво означава Папката, в която pip слага командите, не е във вашия PATH (често в Windows).
Какво да направите Изпълнете вместо това python -m openconstructionerp. Работи на всяка система, без да пипате PATH.
Стартиране"Port 8080 is already in use. Try: openconstructionerp serve --port 8081"Значение: друга програма вече използва порт 8080, затова стартирайте приложението на друг порт, например 8081.
Какво означава Друга програма използва порт 8080.
Какво да направите Изпълнете предложената команда и отворете адреса, който отпечатва.
Стартиране"Embedded PostgreSQL could not start".Значение: вградената база данни PostgreSQL не успя да стартира.
Какво означава Вградената база данни не стартира. Съобщението отпечатва пътя до нейния лог.
Какво да направите Изпълнете openconstructionerp doctor. Ако не помогне, преинсталирайте с pip install --upgrade --force-reinstall openconstructionerp и ни изпратете лога, който посочва.
Къде са логовете
terminal outputthe terminal window (pip);docker compose logs app(Docker)За pip и Docker копирайте това, което терминалът е отпечатал, и изхода наopenconstructionerp doctor.
Docker
- 1
В празна папка изтеглете двата 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.ymlВиждатеДва файла в папката.
- 2
Създайте файла с тайните веднъж.
echo "POSTGRES_PASSWORD=$(openssl rand -base64 24)" > .envecho "JWT_SECRET=$(openssl rand -hex 32)" >> .envВиждатеФайл
.env. Пазете го: съдържа паролата на базата данни и тайната за вход. - 3
Стартирайте го.
docker compose pull app && docker compose up -dВиждатеСтартират два контейнера: postgres и app.
- 4
Отворете http://localhost:8080 и влезте с demo@openconstructionerp.com / DemoPass1234!
ВиждатеСтраницата за вход. Първото стартиране може да отнеме минута, докато се подготвя базата данни.
- 5
При нова инсталация администраторът бива попитан веднъж кои модули ще ползвате. Отбележете нужните и продължете. По-късно можете да го промените с бутона Фонови услуги в горната лента.
ВиждатеЕднократен списък с модули и паметта, която им е нужна.
Полезни команди
Проверете дали и двата контейнера работят и са здрави
docker compose psВижте защо приложението не стартира
docker compose logs appПорт 8080 на вашата машина е зает
OE_PORT=8081 OE_ALLOWED_ORIGINS=http://localhost:8081 docker compose up -dТази compose конфигурация е за оценка и локална употреба. За продукционен сървър вижте docs/INSTALL_LINUX.md и docker-compose.prod.yml в хранилището.
Ако видите съобщение
СтартиранеCompose спира с "POSTGRES_PASSWORD must be set" или "JWT_SECRET must be set".
Какво означава Файлът .env с двете тайни липсва или не е в същата папка.
Какво да направите Създайте файла .env както в стъпка 2, в папката с docker-compose.yml.
Стартиранеhttp://localhost:8080 не се отваря.
Какво означава Контейнерът още не работи или порт 8080 е зает.
Какво да направите Изпълнете docker compose ps и docker compose logs app. За друг порт: OE_PORT=8081 OE_ALLOWED_ORIGINS=http://localhost:8081 docker compose up -d и после отворете http://localhost:8081.
ИнсталиранеНа Mac с Apple Silicon или друга ARM машина Docker предупреждава, че платформата на образа linux/amd64 не съвпада, или приложението работи много бавно.
Какво означава Публикуваният образ е изграден само за x86-64.
Какво да направите Изградете от изходния код с make quickstart или ползвайте pip.
Къде са логовете
terminal outputthe terminal window (pip);docker compose logs app(Docker)За pip и Docker копирайте това, което терминалът е отпечатал, и изхода наopenconstructionerp doctor.
Вашите данни, надграждане и деинсталиране
- Windows
C:\Users\<your name>\.openestimateПлюсC:\ProgramData\OpenConstructionERP\clusters\<id>\pgdata, ако потребителското ви име има нелатински знаци;pgdata.locationго посочва. - macOS~/
.openestimate(скрита; натиснете Cmd+Shift+. във Finder) - Linux~/
.openestimate - pip~/
.openestimate, същата папка като при настолното приложение, освен ако не подадете--data-dirили не зададетеOE_DATA_DIR - DockerDocker томовете <folder>_pg_data (база данни) и <folder>_app_data (файлове), където <folder> е името на папката с
docker-compose.yml
Надграждане
Инсталирайте новата версия върху старата. Папката ви .openestimate не е част от програмата, така че проектите, потребителите и настройките остават. Първото стартиране след надграждане може да отнеме повече време, докато базата данни се обновява сама.
Деинсталиране
Деинсталирането премахва програмата и запазва проектите ви. В Windows деинсталаторът предлага "Delete the application data" (на езика на инсталатора): това изтрива само запазения от прозореца на приложението вход и език (в %APPDATA% и %LOCALAPPDATA%\io.openconstructionerp.desktop), не проектите ви. За да започнете начисто, деинсталирайте, копирайте .openestimate на сигурно място и после го изтрийте.
Резервно копие
Затворете приложението и копирайте папката .openestimate (и папката ProgramData, посочена в pgdata.location, ако има такава).
Все още затруднени? Ще ви помогнем
Моля, включете:
- версията (тя е в името на изтегления файл; pip:
openconstructionerp --version; Docker: тагът на образа) и как сте инсталирали (инсталатор за Windows, .dmg, .deb, .rpm, AppImage, pip или Docker) - вашата система (Windows: Старт, напишете
winver; macOS: менюто Apple, About This Mac; Linux: дистрибуцията и версията) - точния текст на съобщението или екранна снимка
- лог файловете, изброени по-горе
Лог файловете могат да съдържат потребителското ви име и имена на папки. Прегледайте ги, преди да ги публикувате; ако предпочитате, изпратете ги по имейл.