Ajutor la instalare

Instalarea OpenConstructionERP

Alegeți cum vreți să-l rulați, urmați pașii numerotați și, dacă ceva nu arată bine, găsiți mesajul pe care îl vedeți în lista de probleme de mai jos. Niciunul dintre avertismentele din timpul instalării nu vă pune proiectele în pericol.

Nu știți care vi se potrivește?

Priviți mai întâi

Cum instalezi OpenConstructionERP

Ghid video pe Windows, înregistrat cu versiunea 17.7.1. Unele ecrane arată altfel în 18.5, iar timpul de așteptare de la instalare este scurtat în video.

Durată 4:41 · Vezi pe YouTube

Windows

OpenConstructionERP_18.5.0_x64-setup.exeaprox. 800 MB

Înainte de a începe Windows 10 sau 11, pe 64 de biți. Permisiune de administrator (aplicația se instalează pentru toți utilizatorii). Nu aveți nevoie de internet în timpul instalării: componenta ferestrei (Microsoft WebView2) este în programul de instalare.

Vezi acest pas:
  1. 1

    Descărcați OpenConstructionERP_18.5.0_x64-setup.exe de pe pagina versiunii.

    Veți vedeaUn fișier de aproximativ 800 MB în folderul Downloads.

  2. 2

    Faceți dublu clic pe el. Dacă o fereastră albastră spune "Windows v-a protejat computerul" ("Windows protected your PC"), faceți clic pe Mai multe informații ("More info"), verificați că numele fișierului începe cu OpenConstructionERP, apoi faceți clic pe Executați oricum ("Run anyway").

    Veți vedeaWindows cere permisiune de administrator. Faceți clic pe Da.

  3. 3

    Alegeți limba programului de instalare, acceptați licența și păstrați folderul propus C:\Program Files\OpenConstructionERP.

    Veți vedeaO bară de progres, apoi o pagină de final.

  4. 4

    Faceți clic pe Terminare sau porniți OpenConstructionERP din meniul Start.

    Veți vedeaUn ecran de încărcare "Se pornește aplicația" cu o listă: se pornește backendul, se pornește baza de date locală, se pregătește baza de date, se pornește serverul aplicației, se deschide aplicația.

  5. 5

    Așteptați la cea mai primă pornire. Nu închideți fereastra.

    Veți vedea"Prima rulare configurează baza de date locală. Poate dura un minut sau două, vă rugăm așteptați." Pornirile următoare sunt mult mai rapide.

  6. 6

    Alegeți cum se deschide: ca fereastră de aplicație (recomandat) sau în browserul dvs. obișnuit.

    Veți vedea"Cum doriți să deschideți OpenConstructionERP?" și apoi pagina de autentificare.

  7. 7

    Autentificați-vă cu contul demo: e-mail demo@openconstructionerp.com, parola DemoPass1234!. Apoi puteți crea propriul cont și propriile proiecte.

    Veți vedeaAplicația. Proiectele demo se creează în fundal la prima pornire, deci lista de proiecte poate spune pentru scurt timp că sunt pe drum.

  8. 8

    La o instalare nouă, administratorul este întrebat o singură dată ce module veți folosi. Bifați ce vă trebuie și continuați. Puteți schimba mai târziu cu butonul Servicii de fundal din bara de sus.

    Veți vedeaO listă unică de module, cu memoria de care au nevoie.

Dacă vedeți un mesaj

InstalareO fereastră albastră "Windows v-a protejat computerul" ("Windows protected your PC").

Ce înseamnă Programul de instalare nu este încă semnat cu cod, așa că Windows nu cunoaște editorul. Este un avertisment, nu detectarea unui virus.

Ce faceți Faceți clic pe Mai multe informații ("More info"), verificați că numele fișierului începe cu OpenConstructionERP, apoi faceți clic pe Executați oricum ("Run anyway").

InstalareSmart App Control a blocat aplicația, fără buton pentru a continua.

Ce înseamnă Smart App Control din Windows 11 refuză programele nesemnate.

Ce faceți Smart App Control nu poate permite o singură aplicație. Ca să rămână pornit, rulați OpenConstructionERP cu Docker Desktop sau în WSL (Linuxul integrat în Windows), pe care Smart App Control nu le verifică. Instrucțiuni pas cu pas: docs/desktop/WINDOWS_BLOCKED.md în repository.

Instalare"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" (mesajul există doar în engleză)Semnificație: calea folderului de instalare poate conține doar litere latine, cifre și spații, deoarece baza de date încorporată nu poate porni din nicio altă cale.

Ce înseamnă Folderul ales are în cale litere chirilice, chinezești, cu accente sau alte litere nelatine.

Ce faceți Păstrați folderul propus C:\Program Files\OpenConstructionERP sau alegeți un folder precum C:\OpenConstructionERP. O instalare silențioasă (/S) se termină cu codul 3 și scrie motivul în %TEMP%\OpenConstructionERP-install-error.log.

InstalareProgramul de instalare se oprește cu o eroare despre WebView2.

Ce înseamnă Windows a refuzat să instaleze Microsoft WebView2, componenta care desenează fereastra aplicației. Este inclusă în programul de instalare, deci nu aveți nevoie de internet; eroarea vine de la Windows însuși (politică, o actualizare în așteptare sau un WebView2 anterior deteriorat).

Ce faceți Reporniți calculatorul și rulați din nou programul de instalare. Dacă eșuează iar, instalați "Microsoft Edge WebView2 Runtime" de la Microsoft, apoi rulați încă o dată programul nostru de instalare.

InstalareAntivirusul șterge sau pune în carantină un fișier în timpul instalării sau la prima pornire.

Ce înseamnă Programul este nou și nesemnat, iar unele antivirusuri se uită suspicios la asta.

Ce faceți Restaurați fișierul din carantină și adăugați aceste două foldere la excepții: folderul programului C:\Program Files\OpenConstructionERP și folderul dvs. de date C:\Users\<your name>\.openestimate. Apoi rulați din nou programul de instalare peste instalarea existentă. Dacă nu sunteți sigur că fișierul este autentic, scrieți-ne mai întâi.

ActualizareUn ecran care întreabă dacă să suprascrie versiunea instalată sau să o elimine mai întâi, cu o linie care sugerează eliminarea.

Ce faceți Păstrați opțiunea deja selectată (suprascriere). Proiectele dvs. se păstrează. Prima pornire după o actualizare poate dura mai mult cât timp baza de date se actualizează singură.

ActualizareRulați OpenConstructionERP și din pip sau dintr-un terminal pe același calculator, iar se oprește în timpul actualizării.

Ce înseamnă Ambele folosesc același folder .openestimate și aceeași bază de date. Programul de instalare oprește acea bază de date ca să înlocuiască programul. La actualizarea de la 18.4.0, vechiul program de dezinstalare închide și orice program numit openconstructionerp.exe.

Ce faceți Opriți versiunea din terminal (Ctrl+C) înainte de instalare sau actualizare și porniți-o din nou după aceea.

PornireEcranul de încărcare rămâne un minut sau mai mult la cea mai primă pornire.

Ce înseamnă Aplicația își creează baza de date locală. Se întâmplă o singură dată.

Ce faceți Așteptați și nu închideți fereastra. Pe un disc lent sau aproape plin poate dura mai mult. Pornirile următoare sunt rapide.

PornireO casetă "OpenConstructionERP failed to start" care indică un fișier jurnal.

Ce înseamnă Aplicația nu a putut deschide deloc fereastra.

Ce faceți Porniți-o încă o dată. Dacă apare din nou caseta, trimiteți-ne fișierul jurnal indicat.

Pornire"The backend started, but the local database is not answering, so the app cannot open."Semnificație: partea de server a pornit, dar baza ei de date locală nu răspunde, deci aplicația nu se poate deschide.

Ce înseamnă Baza de date locală nu a pornit, adesea după o rulare care nu s-a închis curat.

Ce faceți Reporniți calculatorul și porniți din nou aplicația. Dacă se repetă, trimiteți-ne desktop-launcher.log și jurnalul bazei de date (vezi Jurnale).

Pornire"The backend started, but this installation is missing the application files it serves"Semnificație: partea de server a pornit, dar instalării îi lipsesc fișierele interfeței cu utilizatorul.

Ce înseamnă Lipsește o parte din folderul programului, de obicei ștearsă de antivirus.

Ce faceți Verificați carantina antivirusului, apoi rulați din nou programul de instalare peste instalarea existentă. Proiectele dvs. nu sunt atinse.

Pornire"The application backend did not start in time" sau "The application backend stopped responding while preparing the local database" (sau la alt pas).

Ce înseamnă Pornirea a durat mai mult decât așteaptă aplicația. Mesajul indică pasul la care era.

Ce faceți Închideți fereastra și porniți din nou. Eliberați mai întâi spațiu pe disc dacă acesta este aproape plin. Dacă se oprește iar la același pas, trimiteți-ne desktop-launcher.log.

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

Ce înseamnă Exact asta. Mesajul indică folderul și spațiul liber rămas.

Ce faceți Eliberați spațiu pe acea unitate și porniți din nou.

PornireUn mesaj că folderul bazei de date locale "sits too deep in the filesystem", cu două numere.

Ce înseamnă Windows limitează lungimea căii, iar calea folderului dvs. de date este prea lungă pentru fișierele bazei de date. Activarea căilor lungi în Windows nu ajută.

Ce faceți Setați variabila de mediu de utilizator OE_DATA_DIR la o cale scurtă, cum ar fi C:\OpenConstructionERP\data (Start, tastați "variabile de mediu", Editați variabilele de mediu pentru contul dvs., Nouă), apoi porniți din nou.

PornireNumele dvs. de utilizator Windows are litere nelatine (de exemplu chirilice sau chinezești), iar căutați baza de date.

Ce înseamnă Baza de date integrată nu poate rula dintr-o astfel de cale, așa că de la 18.5.0 aplicația ține baza de date în C:\ProgramData\OpenConstructionERP\clusters\<id>\pgdata. Înainte de 18.5.0, aplicația nu putea porni deloc pentru astfel de conturi.

Ce faceți Nu e nimic de reparat. Fișierul pgdata.location din folderul dvs. .openestimate indică folderul exact al bazei de date. Pentru copii de siguranță copiați ambele foldere.

În funcțiune"The application backend stopped, restarting" și fereastra se reîncarcă.

Ce înseamnă Partea din fundal a aplicației s-a oprit pe neașteptate, iar aplicația a repornit-o. Munca salvată se păstrează. Face asta de cel mult două ori în 30 de minute.

Ce faceți Continuați. Dacă se repetă sau vedeți "The application backend has stopped", trimiteți-ne desktop-launcher.log și logs/backend-crash.log.

PornireDe fiecare dată când porniți aplicația sunteți deconectat, iar limba revine la engleză.

Ce înseamnă Alt program folosește portul 8732, pe care îl folosește de obicei aplicația. Versiunea 18.5.0 alege atunci la fiecare pornire un port liber aleator, iar fereastra tratează fiecare port nou ca pe un site nou, deci autentificarea și limba nu sunt găsite.

Ce faceți Închideți sau reconfigurați celălalt program care folosește portul 8732 (în Windows, rulați netstat -ano | findstr :8732 într-un terminal ca să vedeți ID-ul procesului). Proiectele dvs. nu sunt afectate, doar autentificarea și alegerea limbii.

PornireVă temeți că aplicația intră în conflict cu un PostgreSQL pe care îl rulați deja pe portul 5432.

Ce înseamnă Nu intră. Baza de date integrată ia în Windows un port local liber aleator, iar în macOS și Linux ascultă doar pe un socket local, nu pe un port TCP.

Ce faceți Nu e nimic de făcut.

Unde sunt jurnalele

  • desktop-launcher.logC:\Users\<your name>\.openestimate\desktop-launcher.logTot ce a făcut aplicația desktop la pornire. Întotdeauna în folderul dvs. home, chiar dacă ați mutat folderul de date.
  • backend-crash.logC:\Users\<your name>\.openestimate\logs\backend-crash.logDetalii despre o oprire neașteptată. Se află în folderul de date, deci se mută odată cu OE_DATA_DIR.
  • database log folderC:\Users\<your name>\.openestimate\pgdata\log (or <folder from pgdata.location>\log)De ce nu a pornit baza de date integrată.
  • OpenConstructionERP-install-error.log%TEMP%\OpenConstructionERP-install-error.log (tastați %TEMP% în bara de adrese din Explorer)De ce a refuzat programul de instalare Windows folderul de instalare.

Ca să deschideți folderul, lipiți aceasta în bara de adrese din Explorer:

%USERPROFILE%\.openestimate

macOS

OpenConstructionERP_18.5.0_aarch64.dmgaprox. 640 MB

Înainte de a începe Un Mac cu Apple Silicon (M1 sau mai nou). Nu există versiune pentru Mac cu Intel; pe un Mac cu Intel folosiți pip sau Docker.

  1. 1

    Descărcați OpenConstructionERP_18.5.0_aarch64.dmg și deschideți-l.

    Veți vedeaO fereastră cu pictograma aplicației OpenConstructionERP.

  2. 2

    Trageți OpenConstructionERP în Applications.

    Veți vedeaAplicația apare în folderul Applications.

  3. 3

    Deschideți Terminal o dată și rulați.

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

    Veți vedeaFără rezultat. Este corect. Comanda elimină marcajul de descărcare, deoarece aplicația nu este încă notarizată de Apple.

  4. 4

    Deschideți OpenConstructionERP din Applications.

    Veți vedeaEcranul de încărcare "Se pornește aplicația". Prima pornire configurează baza de date locală și durează un minut sau două.

  5. 5

    Alegeți fereastră de aplicație sau browser.

    Veți vedeaPagina de autentificare.

  6. 6

    Autentificați-vă cu contul demo: e-mail demo@openconstructionerp.com, parola DemoPass1234!. Apoi puteți crea propriul cont și propriile proiecte.

    Veți vedeaAplicația. Proiectele demo se creează în fundal la prima pornire, deci lista de proiecte poate spune pentru scurt timp că sunt pe drum.

  7. 7

    La o instalare nouă, administratorul este întrebat o singură dată ce module veți folosi. Bifați ce vă trebuie și continuați. Puteți schimba mai târziu cu butonul Servicii de fundal din bara de sus.

    Veți vedeaO listă unică de module, cu memoria de care au nevoie.

Dacă vedeți un mesaj

PornireEcranul de încărcare rămâne un minut sau mai mult la cea mai primă pornire.

Ce înseamnă Aplicația își creează baza de date locală. Se întâmplă o singură dată.

Ce faceți Așteptați și nu închideți fereastra. Pe un disc lent sau aproape plin poate dura mai mult. Pornirile următoare sunt rapide.

Pornire"The backend started, but the local database is not answering, so the app cannot open."Semnificație: partea de server a pornit, dar baza ei de date locală nu răspunde, deci aplicația nu se poate deschide.

Ce înseamnă Baza de date locală nu a pornit, adesea după o rulare care nu s-a închis curat.

Ce faceți Reporniți calculatorul și porniți din nou aplicația. Dacă se repetă, trimiteți-ne desktop-launcher.log și jurnalul bazei de date (vezi Jurnale).

Pornire"The backend started, but this installation is missing the application files it serves"Semnificație: partea de server a pornit, dar instalării îi lipsesc fișierele interfeței cu utilizatorul.

Ce înseamnă Lipsește o parte din folderul programului, de obicei ștearsă de antivirus.

Ce faceți Verificați carantina antivirusului, apoi rulați din nou programul de instalare peste instalarea existentă. Proiectele dvs. nu sunt atinse.

Pornire"The application backend did not start in time" sau "The application backend stopped responding while preparing the local database" (sau la alt pas).

Ce înseamnă Pornirea a durat mai mult decât așteaptă aplicația. Mesajul indică pasul la care era.

Ce faceți Închideți fereastra și porniți din nou. Eliberați mai întâi spațiu pe disc dacă acesta este aproape plin. Dacă se oprește iar la același pas, trimiteți-ne desktop-launcher.log.

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

Ce înseamnă În macOS și Linux aplicația își despachetează backendul la fiecare pornire. Un disc lent sau plin, ori un antivirus care blochează fișierele, o împiedică. (Aplicația pentru Windows nu se mai despachetează de la 18.5.)

Ce faceți Eliberați spațiu pe unitatea cu folderul temporar sau permiteți aplicația în antivirus, apoi porniți din nou.

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

Ce înseamnă Exact asta. Mesajul indică folderul și spațiul liber rămas.

Ce faceți Eliberați spațiu pe acea unitate și porniți din nou.

În funcțiune"The application backend stopped, restarting" și fereastra se reîncarcă.

Ce înseamnă Partea din fundal a aplicației s-a oprit pe neașteptate, iar aplicația a repornit-o. Munca salvată se păstrează. Face asta de cel mult două ori în 30 de minute.

Ce faceți Continuați. Dacă se repetă sau vedeți "The application backend has stopped", trimiteți-ne desktop-launcher.log și logs/backend-crash.log.

PornireDe fiecare dată când porniți aplicația sunteți deconectat, iar limba revine la engleză.

Ce înseamnă Alt program folosește portul 8732, pe care îl folosește de obicei aplicația. Versiunea 18.5.0 alege atunci la fiecare pornire un port liber aleator, iar fereastra tratează fiecare port nou ca pe un site nou, deci autentificarea și limba nu sunt găsite.

Ce faceți Închideți sau reconfigurați celălalt program care folosește portul 8732 (în Windows, rulați netstat -ano | findstr :8732 într-un terminal ca să vedeți ID-ul procesului). Proiectele dvs. nu sunt afectate, doar autentificarea și alegerea limbii.

PornireVă temeți că aplicația intră în conflict cu un PostgreSQL pe care îl rulați deja pe portul 5432.

Ce înseamnă Nu intră. Baza de date integrată ia în Windows un port local liber aleator, iar în macOS și Linux ascultă doar pe un socket local, nu pe un port TCP.

Ce faceți Nu e nimic de făcut.

Instalare"OpenConstructionERP is damaged and can't be opened" (textul poate apărea în limba sistemului dvs.).

Ce înseamnă Aplicația nu este încă notarizată de Apple și poartă încă marcajul de descărcare. Aplicația nu este deteriorată.

Ce faceți Doar asta ajută: în Terminal rulați o dată xattr -dr com.apple.quarantine /Applications/OpenConstructionERP.app, apoi deschideți aplicația normal.

Instalare"OpenConstructionERP cannot be opened because the developer cannot be verified" (sau Apple nu a putut verifica dacă este lipsită de malware; textul poate apărea în limba sistemului dvs.).

Ce înseamnă Aplicația este semnată ad hoc, dar nu este încă notarizată de Apple.

Ce faceți Rulați aceeași comandă xattr sau deschideți System Settings, Privacy & Security, derulați în jos și faceți clic pe Open Anyway. Faceți asta o singură dată.

InstalareAplicația nu rulează deloc pe Mac-ul dvs.

Ce înseamnă Versiunea pentru Mac este doar pentru Apple Silicon (M1 și mai noi). Nu există versiune pentru Intel.

Ce faceți Pe un Mac cu Intel folosiți pip (Python 3.12 sau mai nou) sau Docker.

Unde sunt jurnalele

  • desktop-launcher.log~/.openestimate/desktop-launcher.logTot ce a făcut aplicația desktop la pornire. Întotdeauna în folderul dvs. home, chiar dacă ați mutat folderul de date.
  • backend-crash.log~/.openestimate/logs/backend-crash.logDetalii despre o oprire neașteptată. Se află în folderul de date, deci se mută odată cu OE_DATA_DIR.
  • database log folder~/.openestimate/pgdata/logDe ce nu a pornit baza de date integrată.

Ca să deschideți folderul dintr-un terminal:

open ~/.openestimate

Linux

Linux: .deb (Ubuntu, Debian, Mint)
OpenConstructionERP_18.5.0_amd64.debaprox. 830 MB

Înainte de a începe x86 pe 64 de biți (amd64). Pachetul are nevoie de libwebkit2gtk-4.1-0, pe care apt îl instalează pentru dvs. Construit pe Ubuntu 22.04, deci alegerea sigură este Ubuntu 22.04 sau mai nou și Debian 12 sau mai nou.

  1. 1

    Descărcați OpenConstructionERP_18.5.0_amd64.deb.

    Veți vedeaUn fișier de aproximativ 830 MB.

  2. 2

    Într-un terminal, în folderul de descărcare, rulați.

    sudo apt install ./OpenConstructionERP_18.5.0_amd64.deb

    Veți vedeaapt listează pachetul și bibliotecile de care are nevoie, apoi le instalează. ./ din fața numelui fișierului contează.

  3. 3

    Porniți OpenConstructionERP din meniul de aplicații.

    Veți vedeaEcranul de încărcare. Prima pornire durează un minut sau două.

  4. 4

    Autentificați-vă cu contul demo: e-mail demo@openconstructionerp.com, parola DemoPass1234!. Apoi puteți crea propriul cont și propriile proiecte.

    Veți vedeaAplicația. Proiectele demo se creează în fundal la prima pornire, deci lista de proiecte poate spune pentru scurt timp că sunt pe drum.

  5. 5

    La o instalare nouă, administratorul este întrebat o singură dată ce module veți folosi. Bifați ce vă trebuie și continuați. Puteți schimba mai târziu cu butonul Servicii de fundal din bara de sus.

    Veți vedeaO listă unică de module, cu memoria de care au nevoie.

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

Înainte de a începe x86 pe 64 de biți. Pachetul are nevoie de biblioteca WebKitGTK 4.1, pe care managerul de pachete o instalează pentru dvs.

  1. 1

    Descărcați OpenConstructionERP-18.5.0-1.x86_64.rpm.

    Veți vedeaUn fișier de aproximativ 850 MB.

  2. 2

    Rulați.

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

    Veți vedeadnf rezolvă dependențele și instalează.

  3. 3

    Porniți OpenConstructionERP din meniul de aplicații.

    Veți vedeaEcranul de încărcare. Prima pornire durează un minut sau două.

  4. 4

    Autentificați-vă cu contul demo: e-mail demo@openconstructionerp.com, parola DemoPass1234!. Apoi puteți crea propriul cont și propriile proiecte.

    Veți vedeaAplicația. Proiectele demo se creează în fundal la prima pornire, deci lista de proiecte poate spune pentru scurt timp că sunt pe drum.

  5. 5

    La o instalare nouă, administratorul este întrebat o singură dată ce module veți folosi. Bifați ce vă trebuie și continuați. Puteți schimba mai târziu cu butonul Servicii de fundal din bara de sus.

    Veți vedeaO listă unică de module, cu memoria de care au nevoie.

Linux: AppImage (any distribution)
OpenConstructionERP_18.5.0_amd64.AppImageaprox. 910 MB

Înainte de a începe x86 pe 64 de biți și biblioteca FUSE 2 (libfuse2; în Ubuntu 24.04 pachetul se numește libfuse2t64).

  1. 1

    Descărcați OpenConstructionERP_18.5.0_amd64.AppImage.

    Veți vedeaUn fișier de aproximativ 910 MB.

  2. 2

    Faceți-l executabil.

    chmod +x OpenConstructionERP_18.5.0_amd64.AppImage

    Veți vedeaFără rezultat.

  3. 3

    Rulați-l.

    ./OpenConstructionERP_18.5.0_amd64.AppImage

    Veți vedeaEcranul de încărcare. Prima pornire durează un minut sau două.

  4. 4

    Autentificați-vă cu contul demo: e-mail demo@openconstructionerp.com, parola DemoPass1234!. Apoi puteți crea propriul cont și propriile proiecte.

    Veți vedeaAplicația. Proiectele demo se creează în fundal la prima pornire, deci lista de proiecte poate spune pentru scurt timp că sunt pe drum.

  5. 5

    La o instalare nouă, administratorul este întrebat o singură dată ce module veți folosi. Bifați ce vă trebuie și continuați. Puteți schimba mai târziu cu butonul Servicii de fundal din bara de sus.

    Veți vedeaO listă unică de module, cu memoria de care au nevoie.

Dacă vedeți un mesaj

PornireEcranul de încărcare rămâne un minut sau mai mult la cea mai primă pornire.

Ce înseamnă Aplicația își creează baza de date locală. Se întâmplă o singură dată.

Ce faceți Așteptați și nu închideți fereastra. Pe un disc lent sau aproape plin poate dura mai mult. Pornirile următoare sunt rapide.

Pornire"The backend started, but the local database is not answering, so the app cannot open."Semnificație: partea de server a pornit, dar baza ei de date locală nu răspunde, deci aplicația nu se poate deschide.

Ce înseamnă Baza de date locală nu a pornit, adesea după o rulare care nu s-a închis curat.

Ce faceți Reporniți calculatorul și porniți din nou aplicația. Dacă se repetă, trimiteți-ne desktop-launcher.log și jurnalul bazei de date (vezi Jurnale).

Pornire"The backend started, but this installation is missing the application files it serves"Semnificație: partea de server a pornit, dar instalării îi lipsesc fișierele interfeței cu utilizatorul.

Ce înseamnă Lipsește o parte din folderul programului, de obicei ștearsă de antivirus.

Ce faceți Verificați carantina antivirusului, apoi rulați din nou programul de instalare peste instalarea existentă. Proiectele dvs. nu sunt atinse.

Pornire"The application backend did not start in time" sau "The application backend stopped responding while preparing the local database" (sau la alt pas).

Ce înseamnă Pornirea a durat mai mult decât așteaptă aplicația. Mesajul indică pasul la care era.

Ce faceți Închideți fereastra și porniți din nou. Eliberați mai întâi spațiu pe disc dacă acesta este aproape plin. Dacă se oprește iar la același pas, trimiteți-ne desktop-launcher.log.

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

Ce înseamnă În macOS și Linux aplicația își despachetează backendul la fiecare pornire. Un disc lent sau plin, ori un antivirus care blochează fișierele, o împiedică. (Aplicația pentru Windows nu se mai despachetează de la 18.5.)

Ce faceți Eliberați spațiu pe unitatea cu folderul temporar sau permiteți aplicația în antivirus, apoi porniți din nou.

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

Ce înseamnă Exact asta. Mesajul indică folderul și spațiul liber rămas.

Ce faceți Eliberați spațiu pe acea unitate și porniți din nou.

În funcțiune"The application backend stopped, restarting" și fereastra se reîncarcă.

Ce înseamnă Partea din fundal a aplicației s-a oprit pe neașteptate, iar aplicația a repornit-o. Munca salvată se păstrează. Face asta de cel mult două ori în 30 de minute.

Ce faceți Continuați. Dacă se repetă sau vedeți "The application backend has stopped", trimiteți-ne desktop-launcher.log și logs/backend-crash.log.

PornireDe fiecare dată când porniți aplicația sunteți deconectat, iar limba revine la engleză.

Ce înseamnă Alt program folosește portul 8732, pe care îl folosește de obicei aplicația. Versiunea 18.5.0 alege atunci la fiecare pornire un port liber aleator, iar fereastra tratează fiecare port nou ca pe un site nou, deci autentificarea și limba nu sunt găsite.

Ce faceți Închideți sau reconfigurați celălalt program care folosește portul 8732 (în Windows, rulați netstat -ano | findstr :8732 într-un terminal ca să vedeți ID-ul procesului). Proiectele dvs. nu sunt afectate, doar autentificarea și alegerea limbii.

PornireVă temeți că aplicația intră în conflict cu un PostgreSQL pe care îl rulați deja pe portul 5432.

Ce înseamnă Nu intră. Baza de date integrată ia în Windows un port local liber aleator, iar în macOS și Linux ascultă doar pe un socket local, nu pe un port TCP.

Ce faceți Nu e nimic de făcut.

InstalareFișierul .deb cere libwebkit2gtk-4.1-0 sau dpkg raportează dependențe nesatisfăcute.

Ce înseamnă Aplicația are nevoie de WebKitGTK 4.1 ca să-și deseneze fereastra. dpkg -i nu instalează dependențele.

Ce faceți Instalați cu sudo apt install ./OpenConstructionERP_18.5.0_amd64.deb, care aduce și biblioteca. Dacă distribuția dvs. nu are libwebkit2gtk-4.1-0 (Ubuntu mai vechi de 22.04, Debian mai vechi de 12), folosiți pip.

InstalareAppImage nu face nimic la dublu clic.

Ce înseamnă Fișierul nu este încă marcat ca program.

Ce faceți Rulați chmod +x OpenConstructionERP_18.5.0_amd64.AppImage și porniți-l din nou.

InstalareO eroare AppImage care menționează FUSE sau libfuse.so.2.

Ce înseamnă Distribuțiile mai noi nu mai instalează biblioteca FUSE 2 pe care o folosesc AppImage-urile.

Ce faceți Instalați-o (sudo apt install libfuse2, în Ubuntu 24.04 sudo apt install libfuse2t64) sau folosiți .deb, .rpm ori pip.

Unde sunt jurnalele

  • desktop-launcher.log~/.openestimate/desktop-launcher.logTot ce a făcut aplicația desktop la pornire. Întotdeauna în folderul dvs. home, chiar dacă ați mutat folderul de date.
  • backend-crash.log~/.openestimate/logs/backend-crash.logDetalii despre o oprire neașteptată. Se află în folderul de date, deci se mută odată cu OE_DATA_DIR.
  • database log folder~/.openestimate/pgdata/logDe ce nu a pornit baza de date integrată.

Ca să deschideți folderul dintr-un terminal:

xdg-open ~/.openestimate

pip

Pachet openconstructionerp

Înainte de a începe Python 3.12 sau mai nou. Verificați cu python --version. Fără Docker și fără bază de date separată: pip aduce un PostgreSQL integrat.

Vezi acest pas:
  1. 1

    Rulați.

    pip install --upgrade openconstructionerp

    Veți vedeapip descarcă pachetul și dependențele lui.

  2. 2

    Rulați.

    openconstructionerp

    Veți vedeaUn scurt mesaj de bun venit. La prima rulare întreabă dacă să încarce proiectele demo și dacă să deschidă browserul.

  3. 3

    Așteptați cât se configurează baza de date locală.

    Veți vedea"Database: embedded PostgreSQL 16 (no Docker)" și apoi pornește serverul. Browserul dvs. deschide http://127.0.0.1:8080 (la fel ca http://localhost:8080).

  4. 4

    Autentificați-vă. Cu datele demo puteți folosi demo@openconstructionerp.com / DemoPass1234!

    Veți vedeaPanoul de control.

  5. 5

    La o instalare nouă, administratorul este întrebat o singură dată ce module veți folosi. Bifați ce vă trebuie și continuați. Puteți schimba mai târziu cu butonul Servicii de fundal din bara de sus.

    Veți vedeaO listă unică de module, cu memoria de care au nevoie.

  6. 6

    Ca să opriți, apăsați Ctrl+C în terminal. Data viitoare rulați din nou openconstructionerp.

    Veți vedeaServerul se oprește. Datele dvs. rămân în folderul .openestimate din folderul home.

Comenzi utile

Comanda openconstructionerp nu este găsită

python -m openconstructionerp

Ceva nu funcționează: verifică Python, portul, folderul de date și baza de date și spune ce să faceți

openconstructionerp doctor

Portul 8080 este ocupat de alt program

openconstructionerp serve --port 8081

Alte calculatoare din rețeaua dvs. trebuie să aibă acces

openconstructionerp serve --host 0.0.0.0 --port 8080

Trebuie să ne spuneți versiunea dvs.

openconstructionerp --version

Dacă vedeți un mesaj

Instalarepip spune că nu s-a găsit nicio distribuție potrivită sau că este nevoie de alt Python.

Ce înseamnă OpenConstructionERP are nevoie de Python 3.12 sau mai nou.

Ce faceți Instalați Python 3.12 sau mai nou și rulați python3.12 -m pip install --upgrade openconstructionerp (în Windows: py -3.12 -m pip install --upgrade openconstructionerp).

Instalareerror: externally-managed-environment (Ubuntu 23.04+, Debian 12+).Semnificație: sistemul dvs. Linux își protejează propriul Python și refuză să instaleze pachete în el.

Ce înseamnă Python-ul sistemului nu permite pip să instaleze în el.

Ce faceți Folosiți pipx install openconstructionerp sau creați mai întâi un mediu virtual: python3 -m venv ~/oe && ~/oe/bin/pip install openconstructionerp.

Pornire"openconstructionerp" is not recognized sau command not found.

Ce înseamnă Folderul în care pip pune comenzile nu este în PATH (frecvent în Windows).

Ce faceți Rulați în schimb python -m openconstructionerp. Merge pe orice sistem fără să atingeți PATH.

Pornire"Port 8080 is already in use. Try: openconstructionerp serve --port 8081"Semnificație: un alt program folosește deja portul 8080, așa că porniți aplicația pe alt port, de exemplu 8081.

Ce înseamnă Alt program folosește portul 8080.

Ce faceți Rulați comanda sugerată și deschideți adresa pe care o afișează.

Pornire"Embedded PostgreSQL could not start".Semnificație: baza de date PostgreSQL încorporată nu a putut porni.

Ce înseamnă Baza de date integrată nu a pornit. Mesajul afișează calea jurnalului ei.

Ce faceți Rulați openconstructionerp doctor. Dacă nu ajută, reinstalați cu pip install --upgrade --force-reinstall openconstructionerp și trimiteți-ne jurnalul indicat.

Unde sunt jurnalele

  • terminal outputthe terminal window (pip); docker compose logs app (Docker)Pentru pip și Docker, copiați ce a afișat terminalul și rezultatul comenzii openconstructionerp doctor.

Docker

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

Înainte de a începe Docker cu Docker Compose. Imaginea publicată este construită pentru x86-64 (amd64). Pe Apple Silicon sau alte mașini ARM, construiți din sursă (make quickstart) sau folosiți pip. Comenzile de mai jos sunt pentru un shell bash (Linux, macOS sau Git Bash ori WSL în Windows). Windows PowerShell nu are openssl și scrie fișierele într-un format pe care compose nu îl poate citi.

  1. 1

    Într-un folder gol, descărcați cele două fișiere 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

    Veți vedeaDouă fișiere în folder.

  2. 2

    Creați o dată fișierul cu secrete.

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

    Veți vedeaUn fișier .env. Păstrați-l: conține parola bazei de date și secretul de autentificare.

  3. 3

    Porniți-l.

    docker compose pull app && docker compose up -d

    Veți vedeaPornesc două containere: postgres și app.

  4. 4

    Deschideți http://localhost:8080 și autentificați-vă cu demo@openconstructionerp.com / DemoPass1234!

    Veți vedeaPagina de autentificare. Prima pornire poate dura un minut cât se pregătește baza de date.

  5. 5

    La o instalare nouă, administratorul este întrebat o singură dată ce module veți folosi. Bifați ce vă trebuie și continuați. Puteți schimba mai târziu cu butonul Servicii de fundal din bara de sus.

    Veți vedeaO listă unică de module, cu memoria de care au nevoie.

Comenzi utile

Verificați că ambele containere rulează și sunt sănătoase

docker compose ps

Vedeți de ce nu pornește aplicația

docker compose logs app

Portul 8080 de pe calculatorul dvs. este ocupat

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

Această configurare compose este pentru evaluare și utilizare locală. Pentru un server de producție vedeți docs/INSTALL_LINUX.md și docker-compose.prod.yml în repository.

Dacă vedeți un mesaj

PornireCompose se oprește cu "POSTGRES_PASSWORD must be set" sau "JWT_SECRET must be set".

Ce înseamnă Fișierul .env cu cele două secrete lipsește sau nu este în același folder.

Ce faceți Creați fișierul .env ca la pasul 2, în folderul cu docker-compose.yml.

Pornirehttp://localhost:8080 nu se deschide.

Ce înseamnă Containerul nu rulează încă sau portul 8080 este ocupat.

Ce faceți Rulați docker compose ps și docker compose logs app. Pentru alt port: OE_PORT=8081 OE_ALLOWED_ORIGINS=http://localhost:8081 docker compose up -d, apoi deschideți http://localhost:8081.

InstalarePe un Mac cu Apple Silicon sau altă mașină ARM, Docker avertizează că platforma imaginii linux/amd64 nu se potrivește sau aplicația rulează foarte lent.

Ce înseamnă Imaginea publicată este construită doar pentru x86-64.

Ce faceți Construiți din sursă cu make quickstart sau folosiți pip.

Unde sunt jurnalele

  • terminal outputthe terminal window (pip); docker compose logs app (Docker)Pentru pip și Docker, copiați ce a afișat terminalul și rezultatul comenzii openconstructionerp doctor.

Datele dvs., actualizările și dezinstalarea

Actualizare

Instalați noua versiune peste cea veche. Folderul dvs. .openestimate nu face parte din program, deci proiectele, utilizatorii și setările rămân. Prima pornire după o actualizare poate dura mai mult cât timp baza de date se actualizează singură.

Dezinstalare

Dezinstalarea elimină programul și păstrează proiectele dvs. În Windows, programul de dezinstalare oferă "Delete the application data" (în limba programului de instalare): aceasta șterge doar autentificarea și limba salvate de fereastra aplicației (în %APPDATA% și %LOCALAPPDATA%\io.openconstructionerp.desktop), nu proiectele dvs. Ca să începeți de la zero, dezinstalați, copiați .openestimate într-un loc sigur și apoi ștergeți-l.

Copie de siguranță

Închideți aplicația și copiați folderul .openestimate (și folderul ProgramData indicat în pgdata.location, dacă există).

Tot nu merge? Vă ajutăm

Vă rugăm să includeți:

Fișierele jurnal pot conține numele dvs. de utilizator și numele folderelor. Parcurgeți-le înainte de a le posta public; trimiteți-le mai bine prin e-mail, dacă preferați.

Pașii următori după instalare

Ai instalat și te-ai autentificat? Urmărește aceste videoclipuri în ordine. Fiecare este scurt și arată aplicația reală.

  1. Primii pași după instalare

    A doua jumătate a videoclipului de instalare: prima pornire, limba și regiunea, module, utilizatori, primul tău proiect.

  2. Vezi tot produsul

    Util și acesta

    Prezentarea produsului: BOQ, BIM, DWG, takeoff din PDF și devize cu AI

    12:01 minute, înregistrat cu o versiune anterioară. Arată și o instalare cu pip.

    Tur scurt, 2:37: o clădire, o singură sursă de adevăr

  3. Bazele devizării

  4. Piața ta, de la cap la coadă

  5. Conducerea șantierului: buget, achiziții, ore, facturi

Toate listele de redare de pe canalul OpenConstruction Academy

Textul complet se găsește și pe GitHub în English, Deutsch și Русский.