Pomoc przy instalacji

Instalacja OpenConstructionERP

Wybierz sposób uruchamiania, przejdź po kolei przez ponumerowane kroki, a jeśli coś wygląda źle, znajdź komunikat, który widzisz, na liście problemów poniżej. Żadne z ostrzeżeń podczas instalacji nie zagraża Twoim projektom.

Nie wiesz, co wybrać?

Najpierw obejrzyj

Jak zainstalować OpenConstructionERP

Film instruktażowy w systemie Windows, nagrany w wersji 17.7.1. Niektóre ekrany w wersji 18.5 wyglądają inaczej, a czas oczekiwania podczas instalacji został w filmie skrócony.

Czas trwania 4:41 · Obejrzyj na YouTube

Windows

OpenConstructionERP_18.5.0_x64-setup.exeokoło 800 MB

Zanim zaczniesz Windows 10 lub 11, 64-bitowy. Uprawnienia administratora (aplikacja instaluje się dla wszystkich użytkowników). Podczas instalacji nie potrzeba internetu: składnik okna (Microsoft WebView2) jest w instalatorze.

Obejrzyj ten krok:
  1. 1

    Pobierz OpenConstructionERP_18.5.0_x64-setup.exe ze strony wydania.

    ZobaczyszPlik o rozmiarze około 800 MB w folderze Pobrane.

  2. 2

    Kliknij go dwukrotnie. Jeśli niebieskie okno pokazuje "System Windows ochronił ten komputer", kliknij Więcej informacji, sprawdź, czy nazwa pliku zaczyna się od OpenConstructionERP, i kliknij Uruchom mimo to.

    ZobaczyszWindows prosi o uprawnienia administratora. Kliknij Tak.

  3. 3

    Wybierz język instalatora, zaakceptuj licencję i zostaw proponowany folder C:\Program Files\OpenConstructionERP.

    ZobaczyszPasek postępu, potem strona końcowa.

  4. 4

    Kliknij Zakończ albo uruchom OpenConstructionERP z menu Start.

    ZobaczyszEkran ładowania "Uruchamianie aplikacji" z listą: uruchamianie backendu, uruchamianie lokalnej bazy danych, przygotowywanie bazy danych, uruchamianie serwera aplikacji, otwieranie aplikacji.

  5. 5

    Poczekaj przy pierwszym uruchomieniu. Nie zamykaj okna.

    Zobaczysz"Pierwsze uruchomienie konfiguruje lokalną bazę danych. Może to potrwać minutę lub dwie, proszę czekać." Kolejne uruchomienia są dużo szybsze.

  6. 6

    Wybierz, jak otworzyć: w oknie aplikacji (zalecane) albo w zwykłej przeglądarce.

    Zobaczysz"Jak chcesz otworzyć OpenConstructionERP?", a potem strona logowania.

  7. 7

    Zaloguj się na konto demo: e-mail demo@openconstructionerp.com, hasło DemoPass1234!. Potem możesz założyć własne konto i własne projekty.

    ZobaczyszAplikacja. Projekty demo powstają w tle przy pierwszym uruchomieniu, więc lista projektów może przez chwilę pokazywać, że są w drodze.

  8. 8

    Przy świeżej instalacji administrator jest raz pytany, z jakich modułów będziesz korzystać. Zaznacz potrzebne i kontynuuj. Później możesz to zmienić przyciskiem Usługi w tle na górnym pasku.

    ZobaczyszJednorazowa lista modułów z pamięcią, której potrzebują.

Jeśli widzisz komunikat

InstalacjaNiebieskie okno "System Windows ochronił ten komputer".

Co to znaczy Instalator nie jest jeszcze podpisany cyfrowo, więc Windows nie zna wydawcy. To ostrzeżenie, a nie wykrycie wirusa.

Co zrobić Kliknij Więcej informacji, sprawdź, czy nazwa pliku zaczyna się od OpenConstructionERP, i kliknij Uruchom mimo to.

InstalacjaInteligentne zarządzanie aplikacjami (Smart App Control) zablokowało aplikację, bez przycisku, by kontynuować.

Co to znaczy Inteligentne zarządzanie aplikacjami w Windows 11 odrzuca niepodpisane programy.

Co zrobić Inteligentne zarządzanie aplikacjami nie pozwala dopuścić pojedynczej aplikacji. Aby zostało włączone, uruchom OpenConstructionERP przez Docker Desktop lub w WSL (wbudowany w Windows Linux), których ono nie sprawdza. Instrukcja krok po kroku: docs/desktop/WINDOWS_BLOCKED.md w repozytorium.

Instalacja"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" (komunikat jest tylko po angielsku)Znaczenie: ścieżka folderu instalacji może zawierać tylko litery łacińskie, cyfry i spacje, ponieważ wbudowana baza danych nie uruchomi się z żadnej innej ścieżki.

Co to znaczy W ścieżce wybranego folderu są litery cyrylicy, chińskie, z akcentami lub inne nielacińskie.

Co zrobić Zostaw proponowany folder C:\Program Files\OpenConstructionERP albo wybierz folder taki jak C:\OpenConstructionERP. Instalacja cicha (/S) kończy się kodem 3 i zapisuje powód w %TEMP%\OpenConstructionERP-install-error.log.

InstalacjaInstalator zatrzymuje się z błędem dotyczącym WebView2.

Co to znaczy Windows odmówił instalacji Microsoft WebView2, składnika, który rysuje okno aplikacji. Jest w instalatorze, więc internet nie jest potrzebny; błąd pochodzi z samego Windows (zasady, oczekująca aktualizacja albo uszkodzony wcześniejszy WebView2).

Co zrobić Uruchom komputer ponownie i odpal instalator jeszcze raz. Jeśli znów się nie uda, zainstaluj "Microsoft Edge WebView2 Runtime" od Microsoftu, a potem uruchom nasz instalator jeszcze raz.

InstalacjaAntywirus usuwa plik lub przenosi go do kwarantanny podczas instalacji albo przy pierwszym uruchomieniu.

Co to znaczy Program jest nowy i niepodpisany, a niektóre antywirusy podchodzą do tego podejrzliwie.

Co zrobić Przywróć plik z kwarantanny i dodaj te dwa foldery do wyjątków: folder programu C:\Program Files\OpenConstructionERP i swój folder danych C:\Users\<your name>\.openestimate. Potem uruchom instalator ponownie na istniejącej instalacji. Jeśli nie masz pewności, że plik jest prawdziwy, najpierw napisz do nas.

AktualizacjaEkran pytający, czy nadpisać zainstalowaną wersję, czy najpierw ją usunąć, z linią sugerującą usunięcie.

Co zrobić Zostaw już zaznaczoną opcję (nadpisz). Twoje projekty zostają. Pierwsze uruchomienie po aktualizacji może trwać dłużej, bo baza danych aktualizuje się sama.

AktualizacjaUruchamiasz OpenConstructionERP także przez pip lub w terminalu na tym samym komputerze i zatrzymuje się podczas aktualizacji.

Co to znaczy Oba używają tego samego folderu .openestimate i tej samej bazy danych. Instalator zatrzymuje tę bazę, by wymienić program. Przy aktualizacji z 18.4.0 stary deinstalator zamyka też każdy program o nazwie openconstructionerp.exe.

Co zrobić Zatrzymaj wersję w terminalu (Ctrl+C) przed instalacją lub aktualizacją i uruchom ją ponownie potem.

UruchamianieEkran ładowania stoi minutę lub dłużej przy pierwszym uruchomieniu.

Co to znaczy Aplikacja tworzy lokalną bazę danych. Dzieje się to tylko raz.

Co zrobić Poczekaj i nie zamykaj okna. Na wolnym lub prawie pełnym dysku może to trwać dłużej. Kolejne uruchomienia są szybkie.

UruchamianieOkno "OpenConstructionERP failed to start", które podaje plik dziennika.

Co to znaczy Aplikacja w ogóle nie mogła otworzyć okna.

Co zrobić Uruchom ją jeszcze raz. Jeśli okno wróci, wyślij nam plik dziennika, który podaje.

Uruchamianie"The backend started, but the local database is not answering, so the app cannot open."Znaczenie: część serwerowa została uruchomiona, ale jej lokalna baza danych nie odpowiada, więc aplikacji nie można otworzyć.

Co to znaczy Lokalna baza danych nie wystartowała, często po sesji, która nie zamknęła się poprawnie.

Co zrobić Uruchom komputer ponownie i włącz aplikację jeszcze raz. Jeśli się powtórzy, wyślij nam desktop-launcher.log i dziennik bazy danych (zobacz Dzienniki).

Uruchamianie"The backend started, but this installation is missing the application files it serves"Znaczenie: część serwerowa została uruchomiona, ale w instalacji brakuje plików interfejsu użytkownika.

Co to znaczy Brakuje części folderu programu, zwykle usuniętej przez antywirus.

Co zrobić Sprawdź kwarantannę antywirusa, potem uruchom instalator ponownie na istniejącej instalacji. Twoje projekty nie są ruszane.

Uruchamianie"The application backend did not start in time" albo "The application backend stopped responding while preparing the local database" (lub na innym kroku).

Co to znaczy Uruchamianie trwało dłużej, niż aplikacja czeka. Komunikat podaje krok, na którym to się stało.

Co zrobić Zamknij okno i uruchom ponownie. Najpierw zwolnij miejsce na dysku, jeśli jest prawie pełny. Jeśli znów zatrzyma się na tym samym kroku, wyślij nam desktop-launcher.log.

Uruchamianie"The drive ran out of space while the application was starting" albo "There is not enough free space to start the application".

Co to znaczy Dokładnie to. Komunikat podaje folder i pozostałe wolne miejsce.

Co zrobić Zwolnij miejsce na tym dysku i uruchom ponownie.

UruchamianieKomunikat, że folder lokalnej bazy danych "sits too deep in the filesystem", z dwiema liczbami.

Co to znaczy Windows ogranicza długość ścieżki, a ścieżka do Twojego folderu danych jest za długa dla plików bazy. Włączenie długich ścieżek w Windows nie pomaga.

Co zrobić Ustaw zmienną środowiskową użytkownika OE_DATA_DIR na krótką ścieżkę, np. C:\OpenConstructionERP\data (Start, wpisz "zmienne środowiskowe", Edytuj zmienne środowiskowe dla twojego konta, Nowa), potem uruchom ponownie.

UruchamianieTwoja nazwa użytkownika Windows ma litery nielacińskie (na przykład cyrylicę lub chińskie) i szukasz swojej bazy danych.

Co to znaczy Wbudowana baza danych nie może działać z takiej ścieżki, więc od 18.5.0 aplikacja trzyma ją w C:\ProgramData\OpenConstructionERP\clusters\<id>\pgdata. Przed 18.5.0 aplikacja dla takich kont w ogóle się nie uruchamiała.

Co zrobić Nic nie trzeba naprawiać. Plik pgdata.location w folderze .openestimate podaje dokładny folder bazy danych. Do kopii zapasowej skopiuj oba foldery.

Działanie"The application backend stopped, restarting" i okno się przeładowuje.

Co to znaczy Działająca w tle część aplikacji niespodziewanie się zatrzymała i aplikacja ją zrestartowała. Zapisana praca zostaje. Dzieje się to najwyżej dwa razy na 30 minut.

Co zrobić Pracuj dalej. Jeśli się powtórzy albo zobaczysz "The application backend has stopped", wyślij nam desktop-launcher.log i logs/backend-crash.log.

UruchamianiePrzy każdym uruchomieniu aplikacji jesteś wylogowany, a język wraca do angielskiego.

Co to znaczy Inny program używa portu 8732, którego aplikacja zwykle używa. Wersja 18.5.0 wybiera wtedy przy każdym starcie losowy wolny port, a okno traktuje każdy nowy port jak nową stronę, więc logowanie i język nie są znajdowane.

Co zrobić Zamknij lub przekonfiguruj drugi program używający portu 8732 (w Windows uruchom w terminalu netstat -ano | findstr :8732, aby zobaczyć jego identyfikator procesu). Twoje projekty nie są dotknięte, tylko logowanie i wybór języka.

UruchamianieObawiasz się, że aplikacja koliduje z PostgreSQL, który już masz na porcie 5432.

Co to znaczy Nie koliduje. Wbudowana baza w Windows bierze losowy wolny port lokalny, a w macOS i Linuxie nasłuchuje tylko na lokalnym gnieździe, nie na porcie TCP.

Co zrobić Nic nie trzeba robić.

Gdzie są dzienniki

  • desktop-launcher.logC:\Users\<your name>\.openestimate\desktop-launcher.logWszystko, co aplikacja desktopowa zrobiła przy starcie. Zawsze w Twoim folderze domowym, nawet jeśli przeniesiesz folder danych.
  • backend-crash.logC:\Users\<your name>\.openestimate\logs\backend-crash.logSzczegóły niespodziewanego zatrzymania. Leży w folderze danych, więc przenosi się razem z OE_DATA_DIR.
  • database log folderC:\Users\<your name>\.openestimate\pgdata\log (or <folder from pgdata.location>\log)Dlaczego wbudowana baza danych nie wystartowała.
  • OpenConstructionERP-install-error.log%TEMP%\OpenConstructionERP-install-error.log (wpisz %TEMP% w pasku adresu Eksploratora)Dlaczego instalator Windows odrzucił folder instalacji.

Aby otworzyć folder, wklej to w pasek adresu Eksploratora plików:

%USERPROFILE%\.openestimate

macOS

OpenConstructionERP_18.5.0_aarch64.dmgokoło 640 MB

Zanim zaczniesz Mac z Apple Silicon (M1 lub nowszy). Wersji dla Maców z Intelem nie ma; na Macu z Intelem użyj pip lub Dockera.

  1. 1

    Pobierz OpenConstructionERP_18.5.0_aarch64.dmg i otwórz go.

    ZobaczyszOkno z ikoną aplikacji OpenConstructionERP.

  2. 2

    Przeciągnij OpenConstructionERP do Programów.

    ZobaczyszAplikacja pojawia się w folderze Programy.

  3. 3

    Raz otwórz Terminal i uruchom.

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

    ZobaczyszBrak wyniku. To poprawne. To polecenie usuwa znacznik pobrania, bo aplikacja nie ma jeszcze notaryzacji Apple.

  4. 4

    Otwórz OpenConstructionERP z Programów.

    ZobaczyszEkran ładowania "Uruchamianie aplikacji". Pierwsze uruchomienie przygotowuje lokalną bazę danych i trwa minutę lub dwie.

  5. 5

    Wybierz okno aplikacji lub przeglądarkę.

    ZobaczyszStrona logowania.

  6. 6

    Zaloguj się na konto demo: e-mail demo@openconstructionerp.com, hasło DemoPass1234!. Potem możesz założyć własne konto i własne projekty.

    ZobaczyszAplikacja. Projekty demo powstają w tle przy pierwszym uruchomieniu, więc lista projektów może przez chwilę pokazywać, że są w drodze.

  7. 7

    Przy świeżej instalacji administrator jest raz pytany, z jakich modułów będziesz korzystać. Zaznacz potrzebne i kontynuuj. Później możesz to zmienić przyciskiem Usługi w tle na górnym pasku.

    ZobaczyszJednorazowa lista modułów z pamięcią, której potrzebują.

Jeśli widzisz komunikat

UruchamianieEkran ładowania stoi minutę lub dłużej przy pierwszym uruchomieniu.

Co to znaczy Aplikacja tworzy lokalną bazę danych. Dzieje się to tylko raz.

Co zrobić Poczekaj i nie zamykaj okna. Na wolnym lub prawie pełnym dysku może to trwać dłużej. Kolejne uruchomienia są szybkie.

Uruchamianie"The backend started, but the local database is not answering, so the app cannot open."Znaczenie: część serwerowa została uruchomiona, ale jej lokalna baza danych nie odpowiada, więc aplikacji nie można otworzyć.

Co to znaczy Lokalna baza danych nie wystartowała, często po sesji, która nie zamknęła się poprawnie.

Co zrobić Uruchom komputer ponownie i włącz aplikację jeszcze raz. Jeśli się powtórzy, wyślij nam desktop-launcher.log i dziennik bazy danych (zobacz Dzienniki).

Uruchamianie"The backend started, but this installation is missing the application files it serves"Znaczenie: część serwerowa została uruchomiona, ale w instalacji brakuje plików interfejsu użytkownika.

Co to znaczy Brakuje części folderu programu, zwykle usuniętej przez antywirus.

Co zrobić Sprawdź kwarantannę antywirusa, potem uruchom instalator ponownie na istniejącej instalacji. Twoje projekty nie są ruszane.

Uruchamianie"The application backend did not start in time" albo "The application backend stopped responding while preparing the local database" (lub na innym kroku).

Co to znaczy Uruchamianie trwało dłużej, niż aplikacja czeka. Komunikat podaje krok, na którym to się stało.

Co zrobić Zamknij okno i uruchom ponownie. Najpierw zwolnij miejsce na dysku, jeśli jest prawie pełny. Jeśli znów zatrzyma się na tym samym kroku, wyślij nam desktop-launcher.log.

Uruchamianie"The application never finished unpacking itself, so its backend never started." albo "The application could not unpack itself into the temporary folder it uses."

Co to znaczy W macOS i Linuxie aplikacja rozpakowuje swój backend przy każdym uruchomieniu. Powstrzymuje to wolny lub pełny dysk albo antywirus blokujący pliki. (Aplikacja dla Windows od 18.5 już się nie rozpakowuje.)

Co zrobić Zwolnij miejsce na dysku z folderem tymczasowym albo zezwól aplikacji w antywirusie, potem uruchom ponownie.

Uruchamianie"The drive ran out of space while the application was starting" albo "There is not enough free space to start the application".

Co to znaczy Dokładnie to. Komunikat podaje folder i pozostałe wolne miejsce.

Co zrobić Zwolnij miejsce na tym dysku i uruchom ponownie.

Działanie"The application backend stopped, restarting" i okno się przeładowuje.

Co to znaczy Działająca w tle część aplikacji niespodziewanie się zatrzymała i aplikacja ją zrestartowała. Zapisana praca zostaje. Dzieje się to najwyżej dwa razy na 30 minut.

Co zrobić Pracuj dalej. Jeśli się powtórzy albo zobaczysz "The application backend has stopped", wyślij nam desktop-launcher.log i logs/backend-crash.log.

UruchamianiePrzy każdym uruchomieniu aplikacji jesteś wylogowany, a język wraca do angielskiego.

Co to znaczy Inny program używa portu 8732, którego aplikacja zwykle używa. Wersja 18.5.0 wybiera wtedy przy każdym starcie losowy wolny port, a okno traktuje każdy nowy port jak nową stronę, więc logowanie i język nie są znajdowane.

Co zrobić Zamknij lub przekonfiguruj drugi program używający portu 8732 (w Windows uruchom w terminalu netstat -ano | findstr :8732, aby zobaczyć jego identyfikator procesu). Twoje projekty nie są dotknięte, tylko logowanie i wybór języka.

UruchamianieObawiasz się, że aplikacja koliduje z PostgreSQL, który już masz na porcie 5432.

Co to znaczy Nie koliduje. Wbudowana baza w Windows bierze losowy wolny port lokalny, a w macOS i Linuxie nasłuchuje tylko na lokalnym gnieździe, nie na porcie TCP.

Co zrobić Nic nie trzeba robić.

Instalacja"Aplikacja „OpenConstructionERP” jest uszkodzona i nie można jej otworzyć."

Co to znaczy Aplikacja nie ma jeszcze notaryzacji Apple i nadal ma znacznik pobrania. Aplikacja nie jest uszkodzona.

Co zrobić Pomaga tylko to: w Terminalu raz uruchom xattr -dr com.apple.quarantine /Applications/OpenConstructionERP.app, potem otwórz aplikację normalnie.

Instalacja"Nie można otworzyć aplikacji „OpenConstructionERP”, ponieważ nie można zweryfikować jej twórcy" (albo Apple nie mogło sprawdzić, że nie zawiera złośliwego oprogramowania).

Co to znaczy Aplikacja jest podpisana ad hoc, ale nie ma jeszcze notaryzacji Apple.

Co zrobić Uruchom to samo polecenie xattr albo otwórz Ustawienia systemowe, Prywatność i ochrona, przewiń w dół i kliknij Otwórz mimo to. Robisz to tylko raz.

InstalacjaAplikacja w ogóle nie działa na Twoim Macu.

Co to znaczy Wersja na Maca jest tylko dla Apple Silicon (M1 i nowsze). Wersji dla Intela nie ma.

Co zrobić Na Macu z Intelem użyj pip (Python 3.12 lub nowszy) albo Dockera.

Gdzie są dzienniki

  • desktop-launcher.log~/.openestimate/desktop-launcher.logWszystko, co aplikacja desktopowa zrobiła przy starcie. Zawsze w Twoim folderze domowym, nawet jeśli przeniesiesz folder danych.
  • backend-crash.log~/.openestimate/logs/backend-crash.logSzczegóły niespodziewanego zatrzymania. Leży w folderze danych, więc przenosi się razem z OE_DATA_DIR.
  • database log folder~/.openestimate/pgdata/logDlaczego wbudowana baza danych nie wystartowała.

Aby otworzyć folder z terminala:

open ~/.openestimate

Linux

Linux: .deb (Ubuntu, Debian, Mint)
OpenConstructionERP_18.5.0_amd64.debokoło 830 MB

Zanim zaczniesz 64-bitowy x86 (amd64). Pakiet wymaga libwebkit2gtk-4.1-0, który apt zainstaluje za Ciebie. Zbudowany na Ubuntu 22.04, więc bezpieczny wybór to Ubuntu 22.04 lub nowsze i Debian 12 lub nowszy.

  1. 1

    Pobierz OpenConstructionERP_18.5.0_amd64.deb.

    ZobaczyszPlik o rozmiarze około 830 MB.

  2. 2

    W terminalu, w folderze z pobranym plikiem, uruchom.

    sudo apt install ./OpenConstructionERP_18.5.0_amd64.deb

    Zobaczyszapt wypisze pakiet i potrzebne biblioteki, a potem je zainstaluje. Ważne jest ./ przed nazwą pliku.

  3. 3

    Uruchom OpenConstructionERP z menu aplikacji.

    ZobaczyszEkran ładowania. Pierwsze uruchomienie trwa minutę lub dwie.

  4. 4

    Zaloguj się na konto demo: e-mail demo@openconstructionerp.com, hasło DemoPass1234!. Potem możesz założyć własne konto i własne projekty.

    ZobaczyszAplikacja. Projekty demo powstają w tle przy pierwszym uruchomieniu, więc lista projektów może przez chwilę pokazywać, że są w drodze.

  5. 5

    Przy świeżej instalacji administrator jest raz pytany, z jakich modułów będziesz korzystać. Zaznacz potrzebne i kontynuuj. Później możesz to zmienić przyciskiem Usługi w tle na górnym pasku.

    ZobaczyszJednorazowa lista modułów z pamięcią, której potrzebują.

Linux: .rpm (Fedora, RHEL, Rocky)
OpenConstructionERP-18.5.0-1.x86_64.rpmokoło 850 MB

Zanim zaczniesz 64-bitowy x86. Pakiet wymaga biblioteki WebKitGTK 4.1, którą menedżer pakietów zainstaluje za Ciebie.

  1. 1

    Pobierz OpenConstructionERP-18.5.0-1.x86_64.rpm.

    ZobaczyszPlik o rozmiarze około 850 MB.

  2. 2

    Uruchom.

    sudo dnf install ./OpenConstructionERP-18.5.0-1.x86_64.rpm

    Zobaczyszdnf rozwiąże zależności i zainstaluje.

  3. 3

    Uruchom OpenConstructionERP z menu aplikacji.

    ZobaczyszEkran ładowania. Pierwsze uruchomienie trwa minutę lub dwie.

  4. 4

    Zaloguj się na konto demo: e-mail demo@openconstructionerp.com, hasło DemoPass1234!. Potem możesz założyć własne konto i własne projekty.

    ZobaczyszAplikacja. Projekty demo powstają w tle przy pierwszym uruchomieniu, więc lista projektów może przez chwilę pokazywać, że są w drodze.

  5. 5

    Przy świeżej instalacji administrator jest raz pytany, z jakich modułów będziesz korzystać. Zaznacz potrzebne i kontynuuj. Później możesz to zmienić przyciskiem Usługi w tle na górnym pasku.

    ZobaczyszJednorazowa lista modułów z pamięcią, której potrzebują.

Linux: AppImage (any distribution)
OpenConstructionERP_18.5.0_amd64.AppImageokoło 910 MB

Zanim zaczniesz 64-bitowy x86 i biblioteka FUSE 2 (libfuse2; w Ubuntu 24.04 pakiet nazywa się libfuse2t64).

  1. 1

    Pobierz OpenConstructionERP_18.5.0_amd64.AppImage.

    ZobaczyszPlik o rozmiarze około 910 MB.

  2. 2

    Nadaj mu prawo wykonywania.

    chmod +x OpenConstructionERP_18.5.0_amd64.AppImage

    ZobaczyszBrak wyniku.

  3. 3

    Uruchom go.

    ./OpenConstructionERP_18.5.0_amd64.AppImage

    ZobaczyszEkran ładowania. Pierwsze uruchomienie trwa minutę lub dwie.

  4. 4

    Zaloguj się na konto demo: e-mail demo@openconstructionerp.com, hasło DemoPass1234!. Potem możesz założyć własne konto i własne projekty.

    ZobaczyszAplikacja. Projekty demo powstają w tle przy pierwszym uruchomieniu, więc lista projektów może przez chwilę pokazywać, że są w drodze.

  5. 5

    Przy świeżej instalacji administrator jest raz pytany, z jakich modułów będziesz korzystać. Zaznacz potrzebne i kontynuuj. Później możesz to zmienić przyciskiem Usługi w tle na górnym pasku.

    ZobaczyszJednorazowa lista modułów z pamięcią, której potrzebują.

Jeśli widzisz komunikat

UruchamianieEkran ładowania stoi minutę lub dłużej przy pierwszym uruchomieniu.

Co to znaczy Aplikacja tworzy lokalną bazę danych. Dzieje się to tylko raz.

Co zrobić Poczekaj i nie zamykaj okna. Na wolnym lub prawie pełnym dysku może to trwać dłużej. Kolejne uruchomienia są szybkie.

Uruchamianie"The backend started, but the local database is not answering, so the app cannot open."Znaczenie: część serwerowa została uruchomiona, ale jej lokalna baza danych nie odpowiada, więc aplikacji nie można otworzyć.

Co to znaczy Lokalna baza danych nie wystartowała, często po sesji, która nie zamknęła się poprawnie.

Co zrobić Uruchom komputer ponownie i włącz aplikację jeszcze raz. Jeśli się powtórzy, wyślij nam desktop-launcher.log i dziennik bazy danych (zobacz Dzienniki).

Uruchamianie"The backend started, but this installation is missing the application files it serves"Znaczenie: część serwerowa została uruchomiona, ale w instalacji brakuje plików interfejsu użytkownika.

Co to znaczy Brakuje części folderu programu, zwykle usuniętej przez antywirus.

Co zrobić Sprawdź kwarantannę antywirusa, potem uruchom instalator ponownie na istniejącej instalacji. Twoje projekty nie są ruszane.

Uruchamianie"The application backend did not start in time" albo "The application backend stopped responding while preparing the local database" (lub na innym kroku).

Co to znaczy Uruchamianie trwało dłużej, niż aplikacja czeka. Komunikat podaje krok, na którym to się stało.

Co zrobić Zamknij okno i uruchom ponownie. Najpierw zwolnij miejsce na dysku, jeśli jest prawie pełny. Jeśli znów zatrzyma się na tym samym kroku, wyślij nam desktop-launcher.log.

Uruchamianie"The application never finished unpacking itself, so its backend never started." albo "The application could not unpack itself into the temporary folder it uses."

Co to znaczy W macOS i Linuxie aplikacja rozpakowuje swój backend przy każdym uruchomieniu. Powstrzymuje to wolny lub pełny dysk albo antywirus blokujący pliki. (Aplikacja dla Windows od 18.5 już się nie rozpakowuje.)

Co zrobić Zwolnij miejsce na dysku z folderem tymczasowym albo zezwól aplikacji w antywirusie, potem uruchom ponownie.

Uruchamianie"The drive ran out of space while the application was starting" albo "There is not enough free space to start the application".

Co to znaczy Dokładnie to. Komunikat podaje folder i pozostałe wolne miejsce.

Co zrobić Zwolnij miejsce na tym dysku i uruchom ponownie.

Działanie"The application backend stopped, restarting" i okno się przeładowuje.

Co to znaczy Działająca w tle część aplikacji niespodziewanie się zatrzymała i aplikacja ją zrestartowała. Zapisana praca zostaje. Dzieje się to najwyżej dwa razy na 30 minut.

Co zrobić Pracuj dalej. Jeśli się powtórzy albo zobaczysz "The application backend has stopped", wyślij nam desktop-launcher.log i logs/backend-crash.log.

UruchamianiePrzy każdym uruchomieniu aplikacji jesteś wylogowany, a język wraca do angielskiego.

Co to znaczy Inny program używa portu 8732, którego aplikacja zwykle używa. Wersja 18.5.0 wybiera wtedy przy każdym starcie losowy wolny port, a okno traktuje każdy nowy port jak nową stronę, więc logowanie i język nie są znajdowane.

Co zrobić Zamknij lub przekonfiguruj drugi program używający portu 8732 (w Windows uruchom w terminalu netstat -ano | findstr :8732, aby zobaczyć jego identyfikator procesu). Twoje projekty nie są dotknięte, tylko logowanie i wybór języka.

UruchamianieObawiasz się, że aplikacja koliduje z PostgreSQL, który już masz na porcie 5432.

Co to znaczy Nie koliduje. Wbudowana baza w Windows bierze losowy wolny port lokalny, a w macOS i Linuxie nasłuchuje tylko na lokalnym gnieździe, nie na porcie TCP.

Co zrobić Nic nie trzeba robić.

InstalacjaPakiet .deb wymaga libwebkit2gtk-4.1-0 albo dpkg zgłasza niespełnione zależności.

Co to znaczy Aplikacja potrzebuje WebKitGTK 4.1, by narysować okno. dpkg -i nie instaluje zależności.

Co zrobić Zainstaluj przez sudo apt install ./OpenConstructionERP_18.5.0_amd64.deb, co dociąga bibliotekę. Jeśli Twoja dystrybucja nie ma libwebkit2gtk-4.1-0 (Ubuntu starsze niż 22.04, Debian starszy niż 12), użyj pip.

InstalacjaAppImage nic nie robi po dwukrotnym kliknięciu.

Co to znaczy Plik nie jest jeszcze oznaczony jako program.

Co zrobić Uruchom chmod +x OpenConstructionERP_18.5.0_amd64.AppImage i włącz go ponownie.

InstalacjaBłąd AppImage wspominający FUSE lub libfuse.so.2.

Co to znaczy Nowsze dystrybucje nie instalują już biblioteki FUSE 2, której używają AppImage.

Co zrobić Zainstaluj ją (sudo apt install libfuse2, w Ubuntu 24.04 sudo apt install libfuse2t64) albo użyj pakietu .deb, .rpm lub pip.

Gdzie są dzienniki

  • desktop-launcher.log~/.openestimate/desktop-launcher.logWszystko, co aplikacja desktopowa zrobiła przy starcie. Zawsze w Twoim folderze domowym, nawet jeśli przeniesiesz folder danych.
  • backend-crash.log~/.openestimate/logs/backend-crash.logSzczegóły niespodziewanego zatrzymania. Leży w folderze danych, więc przenosi się razem z OE_DATA_DIR.
  • database log folder~/.openestimate/pgdata/logDlaczego wbudowana baza danych nie wystartowała.

Aby otworzyć folder z terminala:

xdg-open ~/.openestimate

pip

Pakiet openconstructionerp

Zanim zaczniesz Python 3.12 lub nowszy. Sprawdź poleceniem python --version. Bez Dockera i bez osobnej bazy danych: pip przynosi wbudowany PostgreSQL.

Obejrzyj ten krok:
  1. 1

    Uruchom.

    pip install --upgrade openconstructionerp

    Zobaczyszpip pobiera pakiet i jego zależności.

  2. 2

    Uruchom.

    openconstructionerp

    ZobaczyszKrótkie powitanie. Przy pierwszym uruchomieniu pyta, czy załadować projekty demo i czy otworzyć przeglądarkę.

  3. 3

    Poczekaj, aż przygotuje lokalną bazę danych.

    Zobaczysz"Database: embedded PostgreSQL 16 (no Docker)", a potem startuje serwer. Przeglądarka otworzy http://127.0.0.1:8080 (to samo co http://localhost:8080).

  4. 4

    Zaloguj się. Z danymi demo możesz użyć demo@openconstructionerp.com / DemoPass1234!

    ZobaczyszPulpit.

  5. 5

    Przy świeżej instalacji administrator jest raz pytany, z jakich modułów będziesz korzystać. Zaznacz potrzebne i kontynuuj. Później możesz to zmienić przyciskiem Usługi w tle na górnym pasku.

    ZobaczyszJednorazowa lista modułów z pamięcią, której potrzebują.

  6. 6

    Aby zatrzymać, naciśnij Ctrl+C w terminalu. Następnym razem po prostu uruchom ponownie openconstructionerp.

    ZobaczyszSerwer się zatrzymuje. Twoje dane zostają w folderze .openestimate w Twoim folderze domowym.

Przydatne polecenia

Nie znaleziono polecenia openconstructionerp

python -m openconstructionerp

Coś nie działa: sprawdza Pythona, port, folder danych i bazę danych i mówi, co zrobić

openconstructionerp doctor

Port 8080 jest zajęty przez inny program

openconstructionerp serve --port 8081

Inne komputery w Twojej sieci powinny mieć dostęp

openconstructionerp serve --host 0.0.0.0 --port 8080

Musisz podać nam swoją wersję

openconstructionerp --version

Jeśli widzisz komunikat

Instalacjapip pisze, że nie znaleziono pasującej dystrybucji albo że wymaga innej wersji Pythona.

Co to znaczy OpenConstructionERP wymaga Pythona 3.12 lub nowszego.

Co zrobić Zainstaluj Pythona 3.12 lub nowszego i uruchom python3.12 -m pip install --upgrade openconstructionerp (w Windows: py -3.12 -m pip install --upgrade openconstructionerp).

Instalacjaerror: externally-managed-environment (Ubuntu 23.04+, Debian 12+).Znaczenie: Twój system Linux chroni własny Python i odmawia instalowania w nim pakietów.

Co to znaczy Systemowy Python nie pozwala pip instalować w sobie pakietów.

Co zrobić Użyj pipx install openconstructionerp albo najpierw utwórz środowisko wirtualne: python3 -m venv ~/oe && ~/oe/bin/pip install openconstructionerp.

Uruchamianie"openconstructionerp" is not recognized albo command not found.

Co to znaczy Folderu, do którego pip wkłada polecenia, nie ma w PATH (często w Windows).

Co zrobić Uruchom zamiast tego python -m openconstructionerp. Działa w każdym systemie bez ruszania PATH.

Uruchamianie"Port 8080 is already in use. Try: openconstructionerp serve --port 8081"Znaczenie: inny program już używa portu 8080, więc uruchom aplikację na innym porcie, na przykład 8081.

Co to znaczy Inny program używa portu 8080.

Co zrobić Uruchom proponowane polecenie i otwórz adres, który wypisze.

Uruchamianie"Embedded PostgreSQL could not start".Znaczenie: nie udało się uruchomić wbudowanej bazy danych PostgreSQL.

Co to znaczy Wbudowana baza danych nie wystartowała. Komunikat podaje ścieżkę do jej dziennika.

Co zrobić Uruchom openconstructionerp doctor. Jeśli to nie pomoże, zainstaluj ponownie poleceniem pip install --upgrade --force-reinstall openconstructionerp i wyślij nam wskazany dziennik.

Gdzie są dzienniki

  • terminal outputthe terminal window (pip); docker compose logs app (Docker)Dla pip i Dockera skopiuj to, co wypisał terminal, oraz wynik openconstructionerp doctor.

Docker

Pakiet ghcr.io/datadrivenconstruction/openconstructionerp (tags 18.5.0, 18.5, latest; linux/amd64)

Zanim zaczniesz Docker z Docker Compose. Opublikowany obraz jest zbudowany dla x86-64 (amd64). Na Apple Silicon lub innych maszynach ARM zbuduj ze źródeł (make quickstart) albo użyj pip. Poniższe polecenia są dla powłoki bash (Linux, macOS albo Git Bash lub WSL w Windows). Windows PowerShell nie ma openssl i zapisuje pliki w formacie, którego compose nie czyta.

  1. 1

    W pustym folderze pobierz dwa pliki compose.

    curl -fsSL https://raw.githubusercontent.com/datadrivenconstruction/OpenConstructionERP/main/docker-compose.quickstart.yml -o docker-compose.yml
    curl -fsSL https://raw.githubusercontent.com/datadrivenconstruction/OpenConstructionERP/main/docker-compose.quickstart.image.yml -o docker-compose.override.yml

    ZobaczyszDwa pliki w folderze.

  2. 2

    Raz utwórz plik z sekretami.

    echo "POSTGRES_PASSWORD=$(openssl rand -base64 24)" > .env
    echo "JWT_SECRET=$(openssl rand -hex 32)" >> .env

    ZobaczyszPlik .env. Zachowaj go: zawiera hasło do bazy danych i sekret logowania.

  3. 3

    Uruchom to.

    docker compose pull app && docker compose up -d

    ZobaczyszStartują dwa kontenery: postgres i app.

  4. 4

    Otwórz http://localhost:8080 i zaloguj się jako demo@openconstructionerp.com / DemoPass1234!

    ZobaczyszStrona logowania. Pierwsze uruchomienie może potrwać minutę, gdy baza danych jest przygotowywana.

  5. 5

    Przy świeżej instalacji administrator jest raz pytany, z jakich modułów będziesz korzystać. Zaznacz potrzebne i kontynuuj. Później możesz to zmienić przyciskiem Usługi w tle na górnym pasku.

    ZobaczyszJednorazowa lista modułów z pamięcią, której potrzebują.

Przydatne polecenia

Sprawdź, czy oba kontenery działają i są zdrowe

docker compose ps

Zobacz, dlaczego aplikacja nie startuje

docker compose logs app

Port 8080 na Twoim komputerze jest zajęty

OE_PORT=8081 OE_ALLOWED_ORIGINS=http://localhost:8081 docker compose up -d

Ta konfiguracja compose służy do oceny i użytku lokalnego. Dla serwera produkcyjnego zobacz docs/INSTALL_LINUX.md i docker-compose.prod.yml w repozytorium.

Jeśli widzisz komunikat

UruchamianieCompose zatrzymuje się z komunikatem "POSTGRES_PASSWORD must be set" albo "JWT_SECRET must be set".

Co to znaczy Brakuje pliku .env z dwoma sekretami albo nie leży w tym samym folderze.

Co zrobić Utwórz plik .env jak w kroku 2, w folderze z docker-compose.yml.

Uruchamianiehttp://localhost:8080 się nie otwiera.

Co to znaczy Kontener jeszcze nie działa albo port 8080 jest zajęty.

Co zrobić Uruchom docker compose ps i docker compose logs app. Aby użyć innego portu: OE_PORT=8081 OE_ALLOWED_ORIGINS=http://localhost:8081 docker compose up -d, potem otwórz http://localhost:8081.

InstalacjaNa Macu z Apple Silicon lub innej maszynie ARM Docker ostrzega, że platforma obrazu linux/amd64 się nie zgadza, albo aplikacja działa bardzo wolno.

Co to znaczy Opublikowany obraz jest zbudowany tylko dla x86-64.

Co zrobić Zbuduj ze źródeł poleceniem make quickstart albo użyj pip.

Gdzie są dzienniki

  • terminal outputthe terminal window (pip); docker compose logs app (Docker)Dla pip i Dockera skopiuj to, co wypisał terminal, oraz wynik openconstructionerp doctor.

Twoje dane, aktualizacje i odinstalowanie

Aktualizacja

Zainstaluj nową wersję na starej. Folder .openestimate nie jest częścią programu, więc projekty, użytkownicy i ustawienia zostają. Pierwsze uruchomienie po aktualizacji może trwać dłużej, bo baza danych aktualizuje się sama.

Odinstalowanie

Odinstalowanie usuwa program i zostawia Twoje projekty. W Windows deinstalator oferuje "Delete the application data" (w języku instalatora): usuwa to tylko zapisane przez okno aplikacji logowanie i język (w %APPDATA% i %LOCALAPPDATA%\io.openconstructionerp.desktop), a nie Twoje projekty. Aby zacząć od zera, odinstaluj, skopiuj .openestimate w bezpieczne miejsce i potem usuń ten folder.

Kopia zapasowa

Zamknij aplikację i skopiuj folder .openestimate (oraz folder ProgramData wskazany w pgdata.location, jeśli istnieje).

Nadal nie działa? Pomożemy

Podaj, proszę:

GitHub Issues GitHub Discussions info@datadrivenconstruction.io

Pliki dziennika mogą zawierać Twoją nazwę użytkownika i nazwy folderów. Przejrzyj je, zanim opublikujesz; jeśli wolisz, wyślij e-mailem.

Kolejne kroki po instalacji

Zainstalowane i zalogowane? Obejrzyj te filmy po kolei. Każdy jest krótki i pokazuje prawdziwą aplikację.

  1. Pierwsze kroki po instalacji

    Druga połowa filmu o instalacji: pierwsze uruchomienie, język i region, moduły, użytkownicy, Twój pierwszy projekt.

  2. Zobacz cały produkt

    Przydatne także

    Prezentacja produktu: BOQ, BIM, DWG, przedmiar z PDF i kosztorysowanie z AI

    12:01 minuty, nagrane we wcześniejszej wersji. Pokazuje też instalację przez pip.

    Krótka wycieczka, 2:37: jeden budynek, jedno źródło prawdy

  3. Podstawy kosztorysowania

    Builder's Playbook: Getting Started3 filmyZacznij tutaj: baza cen i ceny jednostkowe, kosztorys krok po kroku, koszty ogólne, zysk i rezerwa (USA).

  4. Twój rynek od początku do końca

    Builder's Playbook UK: Construction in England6 filmów · ENZarządzanie komercyjne w Wielkiej Brytanii: wycena oferty NRM 2, porównanie ofert, płatności JCT i kaucje gwarancyjne, pay less notices, CIS i odwrotne obciążenie VAT, roboty dodatkowe.Builder's Playbook: Canada6 filmów · ENKanada/Ontario: wycena, przetargi dla podwykonawców, płatności etapowe CCDC 2, terminowa płatność (prompt payment), zmiany zlecenia, zasadnicze ukończenie.Builder's Playbook: Québec5 filmów · FRQuebec po francusku: pierwsze kroki, kosztorysowanie, przetargi BSDQ, fakturowanie z kaucją i hipoteką ustawową, odbiór i usterki.OpenConstructionERP auf Deutsch: vom Projektstart bis zur Übergabe8 filmów · DESeria niemiecka od konfiguracji projektu przez rysunki/RFI, ilości, kontrole BIM, LV, ceny jednostkowe, GAEB X83/X84, po udzielenie zamówienia (numeracja /12, opublikowano 8).Builder's Playbook Hrvatska: gradnja u Hrvatskoj5 filmów · HRChorwacja: import kontraktowego BOQ z Excela, faktury przychodzące, podwykonawcy, rozliczenia częściowe, stan finansowy i prace dodatkowe.

  5. Prowadzenie budowy: budżet, zakupy, godziny, faktury

    OpenConstructionERP en français: gérer un chantier4 filmy · FRProwadzenie budowy po francusku: budżet, zakupy i magazyn, godziny i sprzęt, faktury i płatności.

Wszystkie playlisty na kanale OpenConstruction Academy

Pełny tekst jest też na GitHubie w English, Deutsch i Русский.