Помощь с установкой

Установка 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 защитила ваш компьютер», нажмите Подробнее, проверьте, что имя файла начинается с OpenConstructionERP, и нажмите Выполнить в любом случае.

Вы увидитеWindows запросит права администратора. Нажмите Да.
3

Выберите язык установщика, примите лицензию и оставьте предложенную папку C:\Program Files\OpenConstructionERP.

Вы увидитеИндикатор выполнения, затем страница завершения.
4

Нажмите «Готово» или запустите OpenConstructionERP из меню «Пуск».

Вы увидитеЭкран загрузки «Запуск приложения» со списком шагов: запуск бэкенда, запуск локальной базы данных, подготовка базы данных, запуск сервера приложения, открытие приложения.
5

Подождите при самом первом запуске. Не закрывайте окно.

Вы увидите«При первом запуске настраивается локальная база данных. Это может занять минуту или две, подождите.» Следующие запуски заметно быстрее.
6

Выберите, как открыть: в окне приложения (рекомендуется) или в вашем обычном браузере.

Вы увидите«Как открыть OpenConstructionERP?», затем страница входа.
7

Войдите под демо-учётной записью: почта demo@openconstructionerp.com, пароль DemoPass1234!. Потом можно создать свою учётную запись и свои проекты.

Вы увидитеПриложение. Демо-проекты создаются в фоне при первом запуске, поэтому список проектов может на короткое время сообщать, что они на подходе.
8

При новой установке администратора один раз спрашивают, какие модули вы будете использовать. Отметьте нужные и продолжайте. Позже это можно изменить кнопкой «Фоновые службы» в верхней панели.

Вы увидитеОдноразовый список модулей с указанием нужной им памяти.

Если вы видите сообщение

УстановкаСинее окно «Windows защитила ваш компьютер».

Что это значит Установщик пока не подписан цифровой подписью, поэтому Windows не знает издателя. Это предупреждение, а не обнаруженный вирус.

Что делать Нажмите Подробнее, проверьте, что имя файла начинается с OpenConstructionERP, и нажмите Выполнить в любом случае.

УстановкаИнтеллектуальное управление приложениями (Smart App Control) заблокировало приложение, кнопки для продолжения нет.

Что это значит Интеллектуальное управление приложениями в Windows 11 не пускает неподписанные программы.

Что делать Интеллектуальное управление приложениями нельзя разрешить для одного приложения. Чтобы оставить его включённым, запускайте 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 в папку «Программы».

Вы увидитеПриложение появится в папке «Программы».
3

Один раз откройте Терминал и выполните.

xattr -dr com.apple.quarantine /Applications/OpenConstructionERP.app

Вы увидитеВывода нет. Так и должно быть. Эта команда снимает пометку о загрузке, потому что приложение пока не прошло нотаризацию Apple.
4

Откройте OpenConstructionERP из папки «Программы».

Вы увидитеЭкран загрузки «Запуск приложения». При первом запуске готовится локальная база данных, это занимает минуту или две.
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» повреждена и не может быть открыта».

Что это значит Приложение пока не прошло нотаризацию Apple и всё ещё несёт пометку о загрузке. Само приложение не повреждено.

Что делать Помогает только это: один раз выполните в Терминале xattr -dr com.apple.quarantine /Applications/OpenConstructionERP.app, затем откройте приложение как обычно.

Установка«Невозможно открыть приложение «OpenConstructionERP», так как не удалось проверить разработчика» (или Apple не смогла проверить, что в нём нет вредоносного ПО).

Что это значит Приложение подписано ad hoc, но пока не нотаризовано Apple.

Что делать Выполните ту же команду xattr или откройте «Системные настройки», «Конфиденциальность и безопасность», прокрутите вниз и нажмите «Всё равно открыть». Это нужно сделать только один раз.

УстановкаПриложение вообще не запускается на вашем 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

При новой установке администратора один раз спрашивают, какие модули вы будете использовать. Отметьте нужные и продолжайте. Позже это можно изменить кнопкой «Фоновые службы» в верхней панели.

Вы увидитеОдноразовый список модулей с указанием нужной им памяти.