Допомога зі встановленням

Встановлення 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 виглядають інакше, а очікування під час встановлення у відео скорочено.

Тривалість 4:41 · Дивитися на YouTube

Windows

OpenConstructionERP_18.5.0_x64-setup.exeблизько 800 МБ

Перед початком Windows 10 або 11, 64-бітна. Права адміністратора (застосунок встановлюється для всіх користувачів). Інтернет під час встановлення не потрібен: компонент вікна (Microsoft WebView2) уже всередині інсталятора.

Дивіться цей крок:

1

Завантажте OpenConstructionERP_18.5.0_x64-setup.exe зі сторінки релізу.

Ви побачитеФайл приблизно 800 МБ у папці «Завантаження».
2

Двічі клацніть по ньому. Якщо синє вікно повідомляє "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 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), які він не перевіряє. Покрокова інструкція: 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 from pgdata.location>\log)Чому не запустилася вбудована база даних.
OpenConstructionERP-install-error.log%TEMP%\OpenConstructionERP-install-error.log (введіть %TEMP% в адресному рядку Провідника)Чому інсталятор Windows відхилив папку встановлення.

Щоб відкрити папку, вставте це в адресний рядок Провідника:

%USERPROFILE%\.openestimate

macOS

OpenConstructionERP_18.5.0_aarch64.dmgблизько 640 МБ

Перед початком Mac з Apple Silicon (M1 або новіший). Збірки для Mac з Intel немає; на Mac з Intel використовуйте pip або Docker.

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 application backend did not start in time" або "The application backend stopped responding while preparing the local database" (або на іншому кроці).

Запуск"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" і вікно перезавантажується.

ЗапускПід час кожного запуску застосунку ви виходите з облікового запису, а мова повертається на англійську.

ЗапускВи побоюєтеся, що застосунок конфліктує з PostgreSQL, який у вас уже працює на порту 5432.

Що робити Робити нічого не потрібно.

Встановлення"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 ~/.openestimate

Linux

Linux: .deb (Ubuntu, Debian, Mint)

OpenConstructionERP_18.5.0_amd64.debблизько 830 МБ

Перед початком 64-бітний x86 (amd64). Пакету потрібен libwebkit2gtk-4.1-0, його за вас встановить apt. Зібрано в Ubuntu 22.04, тому надійний вибір це Ubuntu 22.04 і новіші та Debian 12 і новіші.

1

Завантажте OpenConstructionERP_18.5.0_amd64.deb.

Ви побачитеФайл приблизно 830 МБ.
2

У терміналі, у папці завантаження, виконайте.

sudo apt install ./OpenConstructionERP_18.5.0_amd64.deb

Ви побачитеapt покаже пакет і потрібні бібліотеки, потім встановить їх. Важливо, що перед назвою файлу стоїть ./
3

Запустіть OpenConstructionERP з меню застосунків.

Ви побачитеЕкран завантаження. Перший запуск займає хвилину-дві.
4

Увійдіть із демо-обліковим записом: пошта demo@openconstructionerp.com, пароль DemoPass1234!. Потім можна створити власний обліковий запис і власні проєкти.

Ви побачитеЗастосунок. Демо-проєкти створюються у фоні під час першого запуску, тому список проєктів може на мить повідомляти, що вони на підході.
5

Під час нового встановлення адміністратора один раз питають, які модулі ви використовуватимете. Позначте потрібні й продовжуйте. Пізніше це можна змінити кнопкою «Фонові служби» на верхній панелі.

Ви побачитеОдноразовий список модулів із зазначенням потрібної їм пам'яті.

Linux: .rpm (Fedora, RHEL, Rocky)

OpenConstructionERP-18.5.0-1.x86_64.rpmблизько 850 МБ

Перед початком 64-бітний x86. Пакету потрібна бібліотека WebKitGTK 4.1, її за вас встановить менеджер пакетів.

1

Завантажте OpenConstructionERP-18.5.0-1.x86_64.rpm.

Ви побачитеФайл приблизно 850 МБ.
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)

OpenConstructionERP_18.5.0_amd64.AppImageблизько 910 МБ

Перед початком 64-бітний x86 і бібліотека FUSE 2 (libfuse2; в Ubuntu 24.04 пакет називається libfuse2t64).

1

Завантажте OpenConstructionERP_18.5.0_amd64.AppImage.

Ви побачитеФайл приблизно 910 МБ.
2

Зробіть його виконуваним.

chmod +x OpenConstructionERP_18.5.0_amd64.AppImage

Ви побачитеВиводу немає.
3

Запустіть його.

./OpenConstructionERP_18.5.0_amd64.AppImage

Ви побачитеЕкран завантаження. Перший запуск займає хвилину-дві.
4

Увійдіть із демо-обліковим записом: пошта demo@openconstructionerp.com, пароль DemoPass1234!. Потім можна створити власний обліковий запис і власні проєкти.

Ви побачитеЗастосунок. Демо-проєкти створюються у фоні під час першого запуску, тому список проєктів може на мить повідомляти, що вони на підході.
5

Під час нового встановлення адміністратора один раз питають, які модулі ви використовуватимете. Позначте потрібні й продовжуйте. Пізніше це можна змінити кнопкою «Фонові служби» на верхній панелі.

Ви побачитеОдноразовий список модулів із зазначенням потрібної їм пам'яті.