Tulong sa pag-install

Pag-install ng OpenConstructionERP

Piliin kung paano mo ito gustong patakbuhin, sundin ang mga may numerong hakbang, at kung may mukhang mali, hanapin ang mensaheng nakikita mo sa listahan ng mga problema sa ibaba. Walang babala habang nag-i-install ang naglalagay sa panganib ng mga proyekto mo.

Hindi sigurado kung ano ang kailangan mo?

Panoorin muna

Paano i-install ang OpenConstructionERP

Video guide sa Windows, na-record gamit ang bersyon 17.7.1. May mga screen na iba ang itsura sa 18.5, at pinaikli sa video ang paghihintay habang nag-i-install.

Haba 4:41 · Panoorin sa YouTube

Windows

OpenConstructionERP_18.5.0_x64-setup.exemga 800 MB

Bago magsimula Windows 10 o 11, 64 bit. Pahintulot ng administrator (naka-install ang app para sa lahat ng user). Hindi kailangan ng internet habang nag-i-install: kasama na sa installer ang bahagi ng window (Microsoft WebView2).

Panoorin ang hakbang na ito:
  1. 1

    I-download ang OpenConstructionERP_18.5.0_x64-setup.exe mula sa pahina ng release.

    Makikita moIsang file na mga 800 MB sa folder na Downloads.

  2. 2

    I-double-click ito. Kung may asul na window na nagsasabing "Windows protected your PC", i-click ang "More info", tiyaking nagsisimula sa OpenConstructionERP ang pangalan ng file, at saka i-click ang "Run anyway".

    Makikita moHumihingi ang Windows ng pahintulot ng administrator. I-click ang Yes.

  3. 3

    Piliin ang wika ng installer, tanggapin ang lisensya, at panatilihin ang iminumungkahing folder na C:\Program Files\OpenConstructionERP.

    Makikita moIsang progress bar, at saka ang pahina ng pagtatapos.

  4. 4

    I-click ang Finish o buksan ang OpenConstructionERP mula sa Start menu.

    Makikita moIsang loading screen na "Sinisimulan ang app" na may listahan: pagsisimula ng backend, pagsisimula ng lokal na database, paghahanda ng database, pagsisimula ng app server, pagbubukas ng app.

  5. 5

    Maghintay sa pinakaunang pagbukas. Huwag isara ang window.

    Makikita mo"Sine-set up ng unang takbo ang lokal mong database. Maaari itong tumagal ng isa o dalawang minuto, pakihintay lang." Mas mabilis na ang mga susunod na pagbukas.

  6. 6

    Piliin kung paano ito bubuksan: bilang window ng app (inirerekomenda) o sa karaniwan mong browser.

    Makikita mo"Paano mo gustong buksan ang OpenConstructionERP?" at saka ang pahina ng pag-sign in.

  7. 7

    Mag-sign in gamit ang demo account: email demo@openconstructionerp.com, password DemoPass1234!. Pagkatapos ay makakagawa ka na ng sarili mong account at mga proyekto.

    Makikita moAng app. Ginagawa sa background ang mga demo na proyekto sa unang pagbukas, kaya maaaring sabihin saglit ng listahan ng proyekto na parating pa lang ang mga ito.

  8. 8

    Sa bagong install, tinatanong nang minsan ang administrator kung aling mga module ang gagamitin mo. Lagyan ng tsek ang kailangan mo at magpatuloy. Mapapalitan mo ito sa ibang pagkakataon gamit ang button na Background services sa itaas na bar.

    Makikita moIsang beses na listahan ng mga module kasama ang memory na kailangan ng bawat isa.

Kung may makita kang mensahe

Pag-installIsang asul na window na "Windows protected your PC".

Ano ang ibig sabihin Wala pang code signing ang installer, kaya hindi kilala ng Windows ang publisher. Babala ito, hindi pagtuklas ng virus.

Ano ang gagawin I-click ang "More info", tiyaking nagsisimula sa OpenConstructionERP ang pangalan ng file, at saka i-click ang "Run anyway".

Pag-installHinarang ng Smart App Control ang app, at walang button para magpatuloy.

Ano ang ibig sabihin Tinatanggihan ng Smart App Control ng Windows 11 ang mga programang walang lagda.

Ano ang gagawin Hindi maaaring payagan ng Smart App Control ang isang app lang. Para manatili itong naka-on, patakbuhin ang OpenConstructionERP gamit ang Docker Desktop o sa WSL (ang Linux na kasama sa Windows), na hindi sinusuri ng Smart App Control. Hakbang-hakbang na gabay: docs/desktop/WINDOWS_BLOCKED.md sa repository.

Pag-install"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" (sa Ingles lang ang mensaheng ito)Kahulugan: ang path ng installation folder ay maaari lamang maglaman ng mga letrang Latin, numero at espasyo, dahil hindi makakapagsimula ang built-in na database mula sa ibang path.

Ano ang ibig sabihin May letrang Cyrillic, Chinese, may tuldik, o ibang hindi-Latin na karakter ang path ng folder na pinili mo.

Ano ang gagawin Panatilihin ang iminumungkahing C:\Program Files\OpenConstructionERP o pumili ng folder na tulad ng C:\OpenConstructionERP. Ang tahimik na pag-install (/S) ay nagtatapos sa code 3 at isinusulat ang dahilan sa %TEMP%\OpenConstructionERP-install-error.log.

Pag-installHumihinto ang installer na may error tungkol sa WebView2.

Ano ang ibig sabihin Tumanggi ang Windows na i-install ang Microsoft WebView2, ang bahaging gumuguhit ng window ng app. Kasama ito sa installer kaya hindi kailangan ng internet; sa mismong Windows nanggagaling ang error (patakaran, nakabinbing update, o sirang lumang WebView2).

Ano ang gagawin I-restart ang computer at patakbuhin muli ang installer. Kung pumalpak ulit, i-install ang "Microsoft Edge WebView2 Runtime" mula sa Microsoft at saka patakbuhin nang isa pang beses ang installer namin.

Pag-installBinubura o inilalagay ng antivirus sa quarantine ang isang file habang nag-i-install o sa unang pagbukas.

Ano ang ibig sabihin Bago at walang lagda ang programa, at pinaghihinalaan ito ng ilang antivirus.

Ano ang gagawin Ibalik ang file mula sa quarantine at idagdag ang dalawang folder na ito sa mga exception: ang folder ng programa na C:\Program Files\OpenConstructionERP at ang data folder mo na C:\Users\<your name>\.openestimate. Pagkatapos ay patakbuhin muli ang installer sa ibabaw ng kasalukuyang install. Kung hindi ka sigurado na tunay ang file, sumulat muna sa amin.

Pag-upgradeIsang screen na nagtatanong kung ookupahan ang naka-install na bersyon o aalisin muna ito, na may linyang nagmumungkahing alisin.

Ano ang gagawin Panatilihin ang opsyong napili na (ookupahan). Nananatili ang mga proyekto mo. Maaaring mas matagal ang unang pagbukas pagkatapos ng upgrade habang ina-update ng database ang sarili nito.

Pag-upgradePinapatakbo mo rin ang OpenConstructionERP sa pamamagitan ng pip o mula sa terminal sa parehong computer, at humihinto ito habang nag-a-upgrade.

Ano ang ibig sabihin Parehong folder na .openestimate at parehong database ang ginagamit ng dalawa. Hinihinto ng installer ang database na iyon para palitan ang programa. Kapag nag-upgrade mula sa 18.4.0, isinasara rin ng lumang uninstaller ang anumang programang may pangalang openconstructionerp.exe.

Ano ang gagawin Ihinto ang bersyon sa terminal (Ctrl+C) bago mag-install o mag-upgrade, at patakbuhin ulit pagkatapos.

PagsisimulaIsang minuto o higit pa ang tinatagal ng loading screen sa pinakaunang pagbukas.

Ano ang ibig sabihin Ginagawa ng app ang lokal nitong database. Isang beses lang ito nangyayari.

Ano ang gagawin Maghintay at huwag isara ang window. Sa mabagal o halos puno nang disk, maaari itong tumagal nang mas matagal. Mabilis na ang mga susunod na pagbukas.

PagsisimulaIsang kahon na "OpenConstructionERP failed to start" na may binabanggit na log file.

Ano ang ibig sabihin Hindi talaga nabuksan ng app ang window nito.

Ano ang gagawin Patakbuhin ito nang isa pang beses. Kung lumabas ulit ang kahon, ipadala sa amin ang log file na binabanggit nito.

Pagsisimula"The backend started, but the local database is not answering, so the app cannot open."Kahulugan: nagsimula ang bahagi ng server, ngunit hindi tumutugon ang lokal nitong database, kaya hindi mabuksan ang app.

Ano ang ibig sabihin Hindi nagsimula ang lokal na database, madalas pagkatapos ng sesyong hindi nasara nang maayos.

Ano ang gagawin I-restart ang computer at patakbuhin muli ang app. Kung umulit, ipadala sa amin ang desktop-launcher.log at ang log ng database (tingnan ang Mga log).

Pagsisimula"The backend started, but this installation is missing the application files it serves"Kahulugan: nagsimula ang bahagi ng server, ngunit kulang sa installation ang mga file ng user interface.

Ano ang ibig sabihin May kulang na bahagi sa folder ng programa, kadalasan dahil inalis ito ng antivirus.

Ano ang gagawin Tingnan ang quarantine ng antivirus, at saka patakbuhin muli ang installer sa ibabaw ng kasalukuyang install. Hindi ginagalaw ang mga proyekto mo.

Pagsisimula"The application backend did not start in time" o "The application backend stopped responding while preparing the local database" (o sa ibang hakbang).

Ano ang ibig sabihin Mas natagalan ang pagsisimula kaysa sa hinihintay ng app. Sinasabi ng mensahe kung anong hakbang ito noon.

Ano ang gagawin Isara ang window at patakbuhin muli. Magbakante muna ng espasyo sa disk kung halos puno na ito. Kung huminto ulit sa parehong hakbang, ipadala sa amin ang desktop-launcher.log.

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

Ano ang ibig sabihin Eksaktong iyon. Binabanggit ng mensahe ang folder at ang natitirang libreng espasyo.

Ano ang gagawin Magbakante ng espasyo sa drive na iyon at patakbuhin muli.

PagsisimulaIsang mensahe na ang folder ng lokal na database ay "sits too deep in the filesystem", na may dalawang numero.

Ano ang ibig sabihin Nililimitahan ng Windows ang haba ng path, at masyadong mahaba ang path ng data folder mo para sa mga file ng database. Hindi nakakatulong ang pag-enable ng mahabang path sa Windows.

Ano ang gagawin Itakda ang user environment variable na OE_DATA_DIR sa maikling path gaya ng C:\OpenConstructionERP\data (Start, i-type ang "environment variables", Edit environment variables for your account, New) at saka patakbuhin muli.

PagsisimulaMay mga hindi-Latin na karakter ang user name mo sa Windows (halimbawa Cyrillic o Chinese) at hinahanap mo ang database mo.

Ano ang ibig sabihin Hindi gumagana ang built-in na database mula sa ganoong path, kaya mula 18.5.0 ay iniingatan ito ng app sa C:\ProgramData\OpenConstructionERP\clusters\<id>\pgdata. Bago ang 18.5.0, hindi talaga makapagsimula ang app para sa ganitong mga account.

Ano ang gagawin Walang kailangang ayusin. Ang file na pgdata.location sa .openestimate folder mo ay nagsasabi ng eksaktong folder ng database. Para sa backup, kopyahin ang parehong folder.

Habang tumatakbo"The application backend stopped, restarting" at nagre-reload ang window.

Ano ang ibig sabihin Biglang huminto ang bahagi ng app na tumatakbo sa background at muli itong pinatakbo ng app. Nananatili ang na-save na gawa. Hanggang dalawang beses lang ito ginagawa sa loob ng 30 minuto.

Ano ang gagawin Magpatuloy. Kung umulit o makita mo ang "The application backend has stopped", ipadala sa amin ang desktop-launcher.log at ang logs/backend-crash.log.

PagsisimulaSa bawat pagbukas mo ng app, na-sign out ka at bumabalik sa Ingles ang wika.

Ano ang ibig sabihin May ibang programang gumagamit ng port 8732, na karaniwang ginagamit ng app. Sa ganitong kaso, pumipili ang bersyon 18.5.0 ng kung anong libreng port sa bawat pagbukas, at itinuturing ng window na bagong site ang bawat bagong port, kaya hindi makita ang sign-in at wika.

Ano ang gagawin Isara o i-configure muli ang ibang programang gumagamit ng port 8732 (sa Windows, patakbuhin ang netstat -ano | findstr :8732 sa terminal para makita ang process ID nito). Hindi apektado ang mga proyekto mo, ang sign-in at pagpili ng wika lang.

PagsisimulaNag-aalala ka na nagbabanggaan ang app at ang PostgreSQL na pinapatakbo mo na sa port 5432.

Ano ang ibig sabihin Hindi sila nagbabanggaan. Kumukuha ang built-in na database sa Windows ng kung anong libreng lokal na port, at sa macOS at Linux ay nakikinig lang ito sa lokal na socket, hindi sa TCP port.

Ano ang gagawin Walang kailangang gawin.

Nasaan ang mga log

  • desktop-launcher.logC:\Users\<your name>\.openestimate\desktop-launcher.logLahat ng ginawa ng desktop app sa pagsisimula. Palaging nasa home folder mo, kahit inilipat mo ang data folder.
  • backend-crash.logC:\Users\<your name>\.openestimate\logs\backend-crash.logMga detalye ng biglaang paghinto. Nasa data folder ito, kaya sumasama ito kapag inilipat ang OE_DATA_DIR.
  • database log folderC:\Users\<your name>\.openestimate\pgdata\log (or <folder from pgdata.location>\log)Bakit hindi nagsimula ang built-in na database.
  • OpenConstructionERP-install-error.log%TEMP%\OpenConstructionERP-install-error.log (i-type ang %TEMP% sa address bar ng Explorer)Bakit tinanggihan ng installer ng Windows ang folder ng pag-install.

Para buksan ang folder, i-paste ito sa address bar ng Explorer:

%USERPROFILE%\.openestimate

macOS

OpenConstructionERP_18.5.0_aarch64.dmgmga 640 MB

Bago magsimula Isang Mac na may Apple Silicon (M1 o mas bago). Walang release para sa Mac na may Intel; sa Mac na may Intel, gumamit ng pip o Docker.

  1. 1

    I-download ang OpenConstructionERP_18.5.0_aarch64.dmg at buksan ito.

    Makikita moIsang window na may icon ng app na OpenConstructionERP.

  2. 2

    I-drag ang OpenConstructionERP sa Applications.

    Makikita moLumalabas ang app sa folder na Applications.

  3. 3

    Buksan ang Terminal nang isang beses at patakbuhin.

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

    Makikita moWalang output. Tama iyon. Inaalis ng command ang marka ng download, dahil hindi pa na-notarize ng Apple ang app.

  4. 4

    Buksan ang OpenConstructionERP mula sa Applications.

    Makikita moAng loading screen na "Sinisimulan ang app". Sine-set up ng unang pagbukas ang lokal na database at tumatagal ng isa o dalawang minuto.

  5. 5

    Pumili ng window ng app o browser.

    Makikita moAng pahina ng pag-sign in.

  6. 6

    Mag-sign in gamit ang demo account: email demo@openconstructionerp.com, password DemoPass1234!. Pagkatapos ay makakagawa ka na ng sarili mong account at mga proyekto.

    Makikita moAng app. Ginagawa sa background ang mga demo na proyekto sa unang pagbukas, kaya maaaring sabihin saglit ng listahan ng proyekto na parating pa lang ang mga ito.

  7. 7

    Sa bagong install, tinatanong nang minsan ang administrator kung aling mga module ang gagamitin mo. Lagyan ng tsek ang kailangan mo at magpatuloy. Mapapalitan mo ito sa ibang pagkakataon gamit ang button na Background services sa itaas na bar.

    Makikita moIsang beses na listahan ng mga module kasama ang memory na kailangan ng bawat isa.

Kung may makita kang mensahe

PagsisimulaIsang minuto o higit pa ang tinatagal ng loading screen sa pinakaunang pagbukas.

Ano ang ibig sabihin Ginagawa ng app ang lokal nitong database. Isang beses lang ito nangyayari.

Ano ang gagawin Maghintay at huwag isara ang window. Sa mabagal o halos puno nang disk, maaari itong tumagal nang mas matagal. Mabilis na ang mga susunod na pagbukas.

Pagsisimula"The backend started, but the local database is not answering, so the app cannot open."Kahulugan: nagsimula ang bahagi ng server, ngunit hindi tumutugon ang lokal nitong database, kaya hindi mabuksan ang app.

Ano ang ibig sabihin Hindi nagsimula ang lokal na database, madalas pagkatapos ng sesyong hindi nasara nang maayos.

Ano ang gagawin I-restart ang computer at patakbuhin muli ang app. Kung umulit, ipadala sa amin ang desktop-launcher.log at ang log ng database (tingnan ang Mga log).

Pagsisimula"The backend started, but this installation is missing the application files it serves"Kahulugan: nagsimula ang bahagi ng server, ngunit kulang sa installation ang mga file ng user interface.

Ano ang ibig sabihin May kulang na bahagi sa folder ng programa, kadalasan dahil inalis ito ng antivirus.

Ano ang gagawin Tingnan ang quarantine ng antivirus, at saka patakbuhin muli ang installer sa ibabaw ng kasalukuyang install. Hindi ginagalaw ang mga proyekto mo.

Pagsisimula"The application backend did not start in time" o "The application backend stopped responding while preparing the local database" (o sa ibang hakbang).

Ano ang ibig sabihin Mas natagalan ang pagsisimula kaysa sa hinihintay ng app. Sinasabi ng mensahe kung anong hakbang ito noon.

Ano ang gagawin Isara ang window at patakbuhin muli. Magbakante muna ng espasyo sa disk kung halos puno na ito. Kung huminto ulit sa parehong hakbang, ipadala sa amin ang desktop-launcher.log.

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

Ano ang ibig sabihin Sa macOS at Linux, binubuksan ng app ang backend nito sa bawat pagbukas. Hinaharangan ito ng mabagal o punong disk, o ng antivirus na naglo-lock ng mga file. (Hindi na nag-a-unpack ang app para sa Windows mula 18.5.)

Ano ang gagawin Magbakante ng espasyo sa drive na may temporary folder mo o payagan ang app sa antivirus, at saka patakbuhin muli.

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

Ano ang ibig sabihin Eksaktong iyon. Binabanggit ng mensahe ang folder at ang natitirang libreng espasyo.

Ano ang gagawin Magbakante ng espasyo sa drive na iyon at patakbuhin muli.

Habang tumatakbo"The application backend stopped, restarting" at nagre-reload ang window.

Ano ang ibig sabihin Biglang huminto ang bahagi ng app na tumatakbo sa background at muli itong pinatakbo ng app. Nananatili ang na-save na gawa. Hanggang dalawang beses lang ito ginagawa sa loob ng 30 minuto.

Ano ang gagawin Magpatuloy. Kung umulit o makita mo ang "The application backend has stopped", ipadala sa amin ang desktop-launcher.log at ang logs/backend-crash.log.

PagsisimulaSa bawat pagbukas mo ng app, na-sign out ka at bumabalik sa Ingles ang wika.

Ano ang ibig sabihin May ibang programang gumagamit ng port 8732, na karaniwang ginagamit ng app. Sa ganitong kaso, pumipili ang bersyon 18.5.0 ng kung anong libreng port sa bawat pagbukas, at itinuturing ng window na bagong site ang bawat bagong port, kaya hindi makita ang sign-in at wika.

Ano ang gagawin Isara o i-configure muli ang ibang programang gumagamit ng port 8732 (sa Windows, patakbuhin ang netstat -ano | findstr :8732 sa terminal para makita ang process ID nito). Hindi apektado ang mga proyekto mo, ang sign-in at pagpili ng wika lang.

PagsisimulaNag-aalala ka na nagbabanggaan ang app at ang PostgreSQL na pinapatakbo mo na sa port 5432.

Ano ang ibig sabihin Hindi sila nagbabanggaan. Kumukuha ang built-in na database sa Windows ng kung anong libreng lokal na port, at sa macOS at Linux ay nakikinig lang ito sa lokal na socket, hindi sa TCP port.

Ano ang gagawin Walang kailangang gawin.

Pag-install"OpenConstructionERP is damaged and can't be opened" (maaaring lumabas ang teksto sa wika ng sistema mo).

Ano ang ibig sabihin Hindi pa na-notarize ng Apple ang app at dala pa rin nito ang marka ng download. Hindi sira ang app.

Ano ang gagawin Ito lang ang nakakatulong: sa Terminal, patakbuhin nang isang beses ang xattr -dr com.apple.quarantine /Applications/OpenConstructionERP.app at saka buksan ang app nang normal.

Pag-install"OpenConstructionERP cannot be opened because the developer cannot be verified" (o hindi mapatunayan ng Apple na wala itong malware; maaaring lumabas ang teksto sa wika ng sistema mo).

Ano ang ibig sabihin Naka-sign ang app nang ad hoc pero hindi pa ito na-notarize ng Apple.

Ano ang gagawin Patakbuhin ang parehong xattr command o buksan ang System Settings, Privacy & Security, mag-scroll pababa at i-click ang Open Anyway. Isang beses mo lang itong gagawin.

Pag-installHindi talaga tumatakbo ang app sa Mac mo.

Ano ang ibig sabihin Para lang sa Apple Silicon (M1 at mas bago) ang release para sa Mac. Walang release para sa Intel.

Ano ang gagawin Sa Mac na may Intel, gumamit ng pip (Python 3.12 o mas bago) o Docker.

Nasaan ang mga log

  • desktop-launcher.log~/.openestimate/desktop-launcher.logLahat ng ginawa ng desktop app sa pagsisimula. Palaging nasa home folder mo, kahit inilipat mo ang data folder.
  • backend-crash.log~/.openestimate/logs/backend-crash.logMga detalye ng biglaang paghinto. Nasa data folder ito, kaya sumasama ito kapag inilipat ang OE_DATA_DIR.
  • database log folder~/.openestimate/pgdata/logBakit hindi nagsimula ang built-in na database.

Para buksan ang folder mula sa terminal:

open ~/.openestimate

Linux

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

Bago magsimula 64-bit x86 (amd64). Kailangan ng package ang libwebkit2gtk-4.1-0, na ini-install ng apt para sa iyo. Binuo sa Ubuntu 22.04, kaya ang ligtas na pagpipilian ay Ubuntu 22.04 o mas bago at Debian 12 o mas bago.

  1. 1

    I-download ang OpenConstructionERP_18.5.0_amd64.deb.

    Makikita moIsang file na mga 830 MB.

  2. 2

    Sa terminal, sa download folder, patakbuhin.

    sudo apt install ./OpenConstructionERP_18.5.0_amd64.deb

    Makikita moInililista ng apt ang package at ang mga library na kailangan nito, at saka ini-install ang mga ito. Mahalaga ang ./ bago ang pangalan ng file.

  3. 3

    Simulan ang OpenConstructionERP mula sa menu ng mga application.

    Makikita moAng loading screen. Tumatagal ng isa o dalawang minuto ang unang pagbukas.

  4. 4

    Mag-sign in gamit ang demo account: email demo@openconstructionerp.com, password DemoPass1234!. Pagkatapos ay makakagawa ka na ng sarili mong account at mga proyekto.

    Makikita moAng app. Ginagawa sa background ang mga demo na proyekto sa unang pagbukas, kaya maaaring sabihin saglit ng listahan ng proyekto na parating pa lang ang mga ito.

  5. 5

    Sa bagong install, tinatanong nang minsan ang administrator kung aling mga module ang gagamitin mo. Lagyan ng tsek ang kailangan mo at magpatuloy. Mapapalitan mo ito sa ibang pagkakataon gamit ang button na Background services sa itaas na bar.

    Makikita moIsang beses na listahan ng mga module kasama ang memory na kailangan ng bawat isa.

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

Bago magsimula 64-bit x86. Kailangan ng package ang library na WebKitGTK 4.1, na ini-install ng package manager para sa iyo.

  1. 1

    I-download ang OpenConstructionERP-18.5.0-1.x86_64.rpm.

    Makikita moIsang file na mga 850 MB.

  2. 2

    Patakbuhin.

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

    Makikita moNilulutas ng dnf ang mga dependency at nag-i-install.

  3. 3

    Simulan ang OpenConstructionERP mula sa menu ng mga application.

    Makikita moAng loading screen. Tumatagal ng isa o dalawang minuto ang unang pagbukas.

  4. 4

    Mag-sign in gamit ang demo account: email demo@openconstructionerp.com, password DemoPass1234!. Pagkatapos ay makakagawa ka na ng sarili mong account at mga proyekto.

    Makikita moAng app. Ginagawa sa background ang mga demo na proyekto sa unang pagbukas, kaya maaaring sabihin saglit ng listahan ng proyekto na parating pa lang ang mga ito.

  5. 5

    Sa bagong install, tinatanong nang minsan ang administrator kung aling mga module ang gagamitin mo. Lagyan ng tsek ang kailangan mo at magpatuloy. Mapapalitan mo ito sa ibang pagkakataon gamit ang button na Background services sa itaas na bar.

    Makikita moIsang beses na listahan ng mga module kasama ang memory na kailangan ng bawat isa.

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

Bago magsimula 64-bit x86 at ang library na FUSE 2 (libfuse2; sa Ubuntu 24.04, libfuse2t64 ang pangalan ng package).

  1. 1

    I-download ang OpenConstructionERP_18.5.0_amd64.AppImage.

    Makikita moIsang file na mga 910 MB.

  2. 2

    Gawin itong executable.

    chmod +x OpenConstructionERP_18.5.0_amd64.AppImage

    Makikita moWalang output.

  3. 3

    Patakbuhin ito.

    ./OpenConstructionERP_18.5.0_amd64.AppImage

    Makikita moAng loading screen. Tumatagal ng isa o dalawang minuto ang unang pagbukas.

  4. 4

    Mag-sign in gamit ang demo account: email demo@openconstructionerp.com, password DemoPass1234!. Pagkatapos ay makakagawa ka na ng sarili mong account at mga proyekto.

    Makikita moAng app. Ginagawa sa background ang mga demo na proyekto sa unang pagbukas, kaya maaaring sabihin saglit ng listahan ng proyekto na parating pa lang ang mga ito.

  5. 5

    Sa bagong install, tinatanong nang minsan ang administrator kung aling mga module ang gagamitin mo. Lagyan ng tsek ang kailangan mo at magpatuloy. Mapapalitan mo ito sa ibang pagkakataon gamit ang button na Background services sa itaas na bar.

    Makikita moIsang beses na listahan ng mga module kasama ang memory na kailangan ng bawat isa.

Kung may makita kang mensahe

PagsisimulaIsang minuto o higit pa ang tinatagal ng loading screen sa pinakaunang pagbukas.

Ano ang ibig sabihin Ginagawa ng app ang lokal nitong database. Isang beses lang ito nangyayari.

Ano ang gagawin Maghintay at huwag isara ang window. Sa mabagal o halos puno nang disk, maaari itong tumagal nang mas matagal. Mabilis na ang mga susunod na pagbukas.

Pagsisimula"The backend started, but the local database is not answering, so the app cannot open."Kahulugan: nagsimula ang bahagi ng server, ngunit hindi tumutugon ang lokal nitong database, kaya hindi mabuksan ang app.

Ano ang ibig sabihin Hindi nagsimula ang lokal na database, madalas pagkatapos ng sesyong hindi nasara nang maayos.

Ano ang gagawin I-restart ang computer at patakbuhin muli ang app. Kung umulit, ipadala sa amin ang desktop-launcher.log at ang log ng database (tingnan ang Mga log).

Pagsisimula"The backend started, but this installation is missing the application files it serves"Kahulugan: nagsimula ang bahagi ng server, ngunit kulang sa installation ang mga file ng user interface.

Ano ang ibig sabihin May kulang na bahagi sa folder ng programa, kadalasan dahil inalis ito ng antivirus.

Ano ang gagawin Tingnan ang quarantine ng antivirus, at saka patakbuhin muli ang installer sa ibabaw ng kasalukuyang install. Hindi ginagalaw ang mga proyekto mo.

Pagsisimula"The application backend did not start in time" o "The application backend stopped responding while preparing the local database" (o sa ibang hakbang).

Ano ang ibig sabihin Mas natagalan ang pagsisimula kaysa sa hinihintay ng app. Sinasabi ng mensahe kung anong hakbang ito noon.

Ano ang gagawin Isara ang window at patakbuhin muli. Magbakante muna ng espasyo sa disk kung halos puno na ito. Kung huminto ulit sa parehong hakbang, ipadala sa amin ang desktop-launcher.log.

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

Ano ang ibig sabihin Sa macOS at Linux, binubuksan ng app ang backend nito sa bawat pagbukas. Hinaharangan ito ng mabagal o punong disk, o ng antivirus na naglo-lock ng mga file. (Hindi na nag-a-unpack ang app para sa Windows mula 18.5.)

Ano ang gagawin Magbakante ng espasyo sa drive na may temporary folder mo o payagan ang app sa antivirus, at saka patakbuhin muli.

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

Ano ang ibig sabihin Eksaktong iyon. Binabanggit ng mensahe ang folder at ang natitirang libreng espasyo.

Ano ang gagawin Magbakante ng espasyo sa drive na iyon at patakbuhin muli.

Habang tumatakbo"The application backend stopped, restarting" at nagre-reload ang window.

Ano ang ibig sabihin Biglang huminto ang bahagi ng app na tumatakbo sa background at muli itong pinatakbo ng app. Nananatili ang na-save na gawa. Hanggang dalawang beses lang ito ginagawa sa loob ng 30 minuto.

Ano ang gagawin Magpatuloy. Kung umulit o makita mo ang "The application backend has stopped", ipadala sa amin ang desktop-launcher.log at ang logs/backend-crash.log.

PagsisimulaSa bawat pagbukas mo ng app, na-sign out ka at bumabalik sa Ingles ang wika.

Ano ang ibig sabihin May ibang programang gumagamit ng port 8732, na karaniwang ginagamit ng app. Sa ganitong kaso, pumipili ang bersyon 18.5.0 ng kung anong libreng port sa bawat pagbukas, at itinuturing ng window na bagong site ang bawat bagong port, kaya hindi makita ang sign-in at wika.

Ano ang gagawin Isara o i-configure muli ang ibang programang gumagamit ng port 8732 (sa Windows, patakbuhin ang netstat -ano | findstr :8732 sa terminal para makita ang process ID nito). Hindi apektado ang mga proyekto mo, ang sign-in at pagpili ng wika lang.

PagsisimulaNag-aalala ka na nagbabanggaan ang app at ang PostgreSQL na pinapatakbo mo na sa port 5432.

Ano ang ibig sabihin Hindi sila nagbabanggaan. Kumukuha ang built-in na database sa Windows ng kung anong libreng lokal na port, at sa macOS at Linux ay nakikinig lang ito sa lokal na socket, hindi sa TCP port.

Ano ang gagawin Walang kailangang gawin.

Pag-installHumihingi ang .deb ng libwebkit2gtk-4.1-0 o nag-uulat ang dpkg ng mga dependency na hindi natugunan.

Ano ang ibig sabihin Kailangan ng app ang WebKitGTK 4.1 para iguhit ang window nito. Hindi nag-i-install ng mga dependency ang dpkg -i.

Ano ang gagawin Mag-install gamit ang sudo apt install ./OpenConstructionERP_18.5.0_amd64.deb, na nagdadala rin ng library. Kung walang libwebkit2gtk-4.1-0 ang distribusyon mo (Ubuntu na mas luma sa 22.04, Debian na mas luma sa 12), gumamit ng pip.

Pag-installWalang ginagawa ang AppImage kapag dinoble-click.

Ano ang ibig sabihin Hindi pa namamarkahan ang file bilang programa.

Ano ang gagawin Patakbuhin ang chmod +x OpenConstructionERP_18.5.0_amd64.AppImage at simulan ulit.

Pag-installIsang error ng AppImage na bumabanggit sa FUSE o libfuse.so.2.

Ano ang ibig sabihin Hindi na ini-install ng mas bagong mga distribusyon ang library na FUSE 2 na ginagamit ng mga AppImage.

Ano ang gagawin I-install ito (sudo apt install libfuse2, sa Ubuntu 24.04 ay sudo apt install libfuse2t64) o gamitin ang .deb, .rpm, o pip.

Nasaan ang mga log

  • desktop-launcher.log~/.openestimate/desktop-launcher.logLahat ng ginawa ng desktop app sa pagsisimula. Palaging nasa home folder mo, kahit inilipat mo ang data folder.
  • backend-crash.log~/.openestimate/logs/backend-crash.logMga detalye ng biglaang paghinto. Nasa data folder ito, kaya sumasama ito kapag inilipat ang OE_DATA_DIR.
  • database log folder~/.openestimate/pgdata/logBakit hindi nagsimula ang built-in na database.

Para buksan ang folder mula sa terminal:

xdg-open ~/.openestimate

pip

Package openconstructionerp

Bago magsimula Python 3.12 o mas bago. Tingnan gamit ang python --version. Walang Docker at walang hiwalay na database: may kasamang built-in na PostgreSQL ang pip.

Panoorin ang hakbang na ito:
  1. 1

    Patakbuhin.

    pip install --upgrade openconstructionerp

    Makikita moDina-download ng pip ang package at ang mga dependency nito.

  2. 2

    Patakbuhin.

    openconstructionerp

    Makikita moIsang maikling pagbati. Sa unang takbo, tinatanong nito kung ilo-load ang mga demo na proyekto at kung bubuksan ang browser.

  3. 3

    Maghintay habang sine-set up ang lokal na database.

    Makikita mo"Database: embedded PostgreSQL 16 (no Docker)" at saka magsisimula ang server. Binubuksan ng browser mo ang http://127.0.0.1:8080 (pareho ng http://localhost:8080).

  4. 4

    Mag-sign in. Sa demo data, magagamit mo ang demo@openconstructionerp.com / DemoPass1234!

    Makikita moAng dashboard.

  5. 5

    Sa bagong install, tinatanong nang minsan ang administrator kung aling mga module ang gagamitin mo. Lagyan ng tsek ang kailangan mo at magpatuloy. Mapapalitan mo ito sa ibang pagkakataon gamit ang button na Background services sa itaas na bar.

    Makikita moIsang beses na listahan ng mga module kasama ang memory na kailangan ng bawat isa.

  6. 6

    Para huminto, pindutin ang Ctrl+C sa terminal. Sa susunod, patakbuhin lang ulit ang openconstructionerp.

    Makikita moHumihinto ang server. Nananatili ang data mo sa folder na .openestimate sa home folder mo.

Mga kapaki-pakinabang na command

Hindi mahanap ang command na openconstructionerp

python -m openconstructionerp

May hindi gumagana: sinusuri ang Python, port, data folder, at database, at sinasabi kung ano ang gagawin

openconstructionerp doctor

Ginagamit ng ibang programa ang port 8080

openconstructionerp serve --port 8081

Kailangang maabot ng ibang mga computer sa network mo

openconstructionerp serve --host 0.0.0.0 --port 8080

Kailangan mong sabihin sa amin ang bersyon mo

openconstructionerp --version

Kung may makita kang mensahe

Pag-installSabi ng pip, walang nahanap na angkop na distribusyon o kailangan ng ibang Python.

Ano ang ibig sabihin Kailangan ng OpenConstructionERP ang Python 3.12 o mas bago.

Ano ang gagawin Mag-install ng Python 3.12 o mas bago at patakbuhin ang python3.12 -m pip install --upgrade openconstructionerp (sa Windows: py -3.12 -m pip install --upgrade openconstructionerp).

Pag-installerror: externally-managed-environment (Ubuntu 23.04+, Debian 12+).Kahulugan: pinoprotektahan ng iyong Linux system ang sarili nitong Python at tumatangging mag-install ng mga package dito.

Ano ang ibig sabihin Hindi pinapayagan ng Python ng sistema ang pip na mag-install sa loob nito.

Ano ang gagawin Gamitin ang pipx install openconstructionerp o gumawa muna ng virtual environment: python3 -m venv ~/oe && ~/oe/bin/pip install openconstructionerp.

Pagsisimula"openconstructionerp" is not recognized o command not found.

Ano ang ibig sabihin Wala sa PATH mo ang folder kung saan inilalagay ng pip ang mga command (karaniwan sa Windows).

Ano ang gagawin Patakbuhin na lang ang python -m openconstructionerp. Gumagana ito sa anumang sistema nang hindi ginagalaw ang PATH.

Pagsisimula"Port 8080 is already in use. Try: openconstructionerp serve --port 8081"Kahulugan: ginagamit na ng ibang program ang port 8080, kaya simulan ang app sa ibang port, halimbawa 8081.

Ano ang ibig sabihin May ibang programang gumagamit ng port 8080.

Ano ang gagawin Patakbuhin ang iminumungkahing command at buksan ang address na ipi-print nito.

Pagsisimula"Embedded PostgreSQL could not start".Kahulugan: hindi masimulan ang built-in na PostgreSQL database.

Ano ang ibig sabihin Hindi nagsimula ang built-in na database. Ipini-print ng mensahe ang path ng log nito.

Ano ang gagawin Patakbuhin ang openconstructionerp doctor. Kung hindi nakatulong, mag-install muli gamit ang pip install --upgrade --force-reinstall openconstructionerp at ipadala sa amin ang log na binabanggit nito.

Nasaan ang mga log

  • terminal outputthe terminal window (pip); docker compose logs app (Docker)Para sa pip at Docker, kopyahin ang ipinrint ng terminal at ang output ng openconstructionerp doctor.

Docker

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

Bago magsimula Docker na may Docker Compose. Ang nailathalang image ay binuo para sa x86-64 (amd64). Sa Apple Silicon o iba pang makinang ARM, bumuo mula sa source (make quickstart) o gumamit ng pip. Ang mga command sa ibaba ay para sa bash shell (Linux, macOS, o Git Bash o WSL sa Windows). Walang openssl ang Windows PowerShell at nagsusulat ito ng mga file sa format na hindi mabasa ng compose.

  1. 1

    Sa isang walang laman na folder, i-download ang dalawang compose file.

    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

    Makikita moDalawang file sa folder.

  2. 2

    Gawin nang isang beses ang file ng mga lihim.

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

    Makikita moIsang .env file. Ingatan ito: naglalaman ito ng password ng database at ng lihim ng pag-sign in.

  3. 3

    Simulan ito.

    docker compose pull app && docker compose up -d

    Makikita moDalawang container ang magsisimula: postgres at app.

  4. 4

    Buksan ang http://localhost:8080 at mag-sign in gamit ang demo@openconstructionerp.com / DemoPass1234!

    Makikita moAng pahina ng pag-sign in. Maaaring umabot ng isang minuto ang unang pagbukas habang inihahanda ang database.

  5. 5

    Sa bagong install, tinatanong nang minsan ang administrator kung aling mga module ang gagamitin mo. Lagyan ng tsek ang kailangan mo at magpatuloy. Mapapalitan mo ito sa ibang pagkakataon gamit ang button na Background services sa itaas na bar.

    Makikita moIsang beses na listahan ng mga module kasama ang memory na kailangan ng bawat isa.

Mga kapaki-pakinabang na command

Tiyaking tumatakbo at malusog ang dalawang container

docker compose ps

Tingnan kung bakit hindi nagsisimula ang app

docker compose logs app

Ginagamit ang port 8080 sa makina mo

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

Ang compose setup na ito ay para sa pagsusuri at lokal na paggamit. Para sa production server, tingnan ang docs/INSTALL_LINUX.md at ang docker-compose.prod.yml sa repository.

Kung may makita kang mensahe

PagsisimulaHumihinto ang Compose na may "POSTGRES_PASSWORD must be set" o "JWT_SECRET must be set".

Ano ang ibig sabihin Wala ang .env file na may dalawang lihim o wala ito sa parehong folder.

Ano ang gagawin Gawin ang .env file gaya ng hakbang 2, sa folder na may docker-compose.yml.

PagsisimulaHindi nagbubukas ang http://localhost:8080.

Ano ang ibig sabihin Hindi pa tumatakbo ang container o ginagamit ang port 8080.

Ano ang gagawin Patakbuhin ang docker compose ps at docker compose logs app. Para sa ibang port: OE_PORT=8081 OE_ALLOWED_ORIGINS=http://localhost:8081 docker compose up -d at saka buksan ang http://localhost:8081.

Pag-installSa Mac na may Apple Silicon o ibang makinang ARM, nagbababala ang Docker na hindi tugma ang platform ng image na linux/amd64, o napakabagal ng takbo ng app.

Ano ang ibig sabihin Para lang sa x86-64 binuo ang nailathalang image.

Ano ang gagawin Bumuo mula sa source gamit ang make quickstart o gumamit ng pip.

Nasaan ang mga log

  • terminal outputthe terminal window (pip); docker compose logs app (Docker)Para sa pip at Docker, kopyahin ang ipinrint ng terminal at ang output ng openconstructionerp doctor.

Ang data mo, mga upgrade, at pag-uninstall

Pag-upgrade

I-install ang bagong bersyon sa ibabaw ng luma. Hindi bahagi ng programa ang .openestimate folder mo, kaya nananatili ang mga proyekto, user, at setting. Maaaring mas matagal ang unang pagbukas pagkatapos ng upgrade habang ina-update ng database ang sarili nito.

Pag-uninstall

Inaalis ng pag-uninstall ang programa at pinapanatili ang mga proyekto mo. Sa Windows, nag-aalok ang uninstaller ng "Delete the application data" (sa wika ng installer): binubura lang nito ang sign-in at wikang na-save ng window ng app (sa %APPDATA% at %LOCALAPPDATA%\io.openconstructionerp.desktop), hindi ang mga proyekto mo. Para magsimulang muli, mag-uninstall, kopyahin ang .openestimate sa ligtas na lugar, at saka burahin ito.

Backup

Isara ang app at kopyahin ang .openestimate folder (at ang ProgramData folder na binanggit sa pgdata.location, kung mayroon).

Naipit pa rin? Tutulungan ka namin

Pakisama ang:

GitHub Issues GitHub Discussions info@datadrivenconstruction.io

Maaaring may laman ang mga log file na user name at pangalan ng mga folder mo. Suriin muna bago i-post nang publiko; mas mabuting ipadala sa email kung mas gusto mo.

Mga susunod na hakbang pagkatapos mag-install

Naka-install na at naka-sign in? Panoorin ang mga video na ito nang pa-sunod-sunod. Maikli ang bawat isa at ipinapakita ang totoong app.

  1. Mga unang hakbang pagkatapos mag-install

    Ikalawang kalahati ng installation video: unang pagbukas, wika at rehiyon, mga module, mga user, ang una mong proyekto.

  2. Tingnan ang buong produkto

    Kapaki-pakinabang din

    Product tour: BOQ, BIM, DWG, PDF takeoff at AI estimating

    12:01 minuto, na-record gamit ang mas lumang bersyon. Ipinapakita rin ang pag-install gamit ang pip.

    Maikling tour, 2:37: isang gusali, isang pinagmumulan ng katotohanan

  3. Mga batayan ng estimating

    Builder's Playbook: Getting Started3 videoMagsimula rito: cost database at unit rate, estimate nang hakbang-hakbang, overhead, tubo at contingency (US).

  4. Ang merkado mo, mula simula hanggang dulo

    Builder's Playbook UK: Construction in England6 na video · ENCommercial management sa UK: NRM 2 tender pricing, paghahambing ng bid, mga bayad sa JCT at retention, pay less notices, CIS at VAT reverse charge, mga variation.Builder's Playbook: Canada6 na video · ENCanada/Ontario: pricing, subcontract tendering, CCDC 2 progress draw, prompt payment, change order, substantial performance.Builder's Playbook: Québec5 video · FRQuébec sa Pranses: pagsisimula, estimating, mga tender ng BSDQ, invoicing na may holdback at legal hypothec, pagtanggap at mga kakulangan.OpenConstructionERP auf Deutsch: vom Projektstart bis zur Übergabe8 video · DESeryeng Aleman mula sa project setup hanggang drawings/RFI, mga dami, BIM check, LV, unit rate, GAEB X83/X84 at award (may numerong /12, 8 ang nailathala).Builder's Playbook Hrvatska: gradnja u Hrvatskoj5 video · HRCroatia: pag-import ng contract BOQ mula sa Excel, mga papasok na invoice, mga subcontractor, interim valuation, financial status at extra work.

  5. Pagpapatakbo ng site: budget, pagbili, oras, invoice

    OpenConstructionERP en français: gérer un chantier4 na video · FRSite management sa Pranses: budget, pagbili at stock, oras at kagamitan, mga invoice at bayad.

Lahat ng playlist sa channel ng OpenConstruction Academy

Nasa GitHub din ang buong teksto sa English, Deutsch, at Русский.