Installatiehulp

OpenConstructionERP installeren

Kies hoe u het wilt draaien, volg de genummerde stappen en zoek bij problemen de melding die u ziet op in de lijst met problemen hieronder. Geen van de waarschuwingen tijdens de installatie brengt uw projecten in gevaar.

Weet u niet welke u nodig hebt?

Kijk eerst

Zo installeer je OpenConstructionERP

Videohandleiding op Windows, opgenomen met versie 17.7.1. Sommige schermen zien er in 18.5 anders uit en de wachttijd tijdens de installatie is in de video ingekort.

Duur 4:41 · Bekijk op YouTube

Windows

OpenConstructionERP_18.5.0_x64-setup.exeongeveer 800 MB

Voordat u begint Windows 10 of 11, 64-bits. Beheerdersrechten (de app wordt voor alle gebruikers geïnstalleerd). Tijdens de installatie hebt u geen internet nodig: het vensteronderdeel (Microsoft WebView2) zit in het installatieprogramma.

Bekijk deze stap:
  1. 1

    Download OpenConstructionERP_18.5.0_x64-setup.exe van de releasepagina.

    U zietEen bestand van ongeveer 800 MB in uw map Downloads.

  2. 2

    Dubbelklik erop. Als een blauw venster "Windows heeft uw pc beschermd" meldt, klikt u op Meer info, controleert u of de bestandsnaam met OpenConstructionERP begint en klikt u op Toch uitvoeren.

    U zietWindows vraagt om beheerdersrechten. Klik op Ja.

  3. 3

    Kies de taal van het installatieprogramma, accepteer de licentie en houd de voorgestelde map C:\Program Files\OpenConstructionERP aan.

    U zietEen voortgangsbalk, daarna een slotpagina.

  4. 4

    Klik op Voltooien, of start OpenConstructionERP via het Startmenu.

    U zietEen laadscherm "De applicatie wordt gestart" met een lijst: backend wordt gestart, lokale database wordt gestart, database wordt voorbereid, applicatieserver wordt gestart, app wordt geopend.

  5. 5

    Wacht bij de allereerste start. Sluit het venster niet.

    U ziet"Bij de eerste start wordt uw lokale database ingericht. Dit kan een minuut of twee duren, even geduld." Latere starts zijn veel sneller.

  6. 6

    Kies hoe u de app opent: als appvenster (aanbevolen) of in uw gewone browser.

    U ziet"Hoe wilt u OpenConstructionERP openen?" en daarna de aanmeldpagina.

  7. 7

    Meld u aan met het demoaccount: e-mail demo@openconstructionerp.com, wachtwoord DemoPass1234!. Daarna kunt u uw eigen account en projecten aanmaken.

    U zietDe app. De demoprojecten worden bij de eerste start op de achtergrond aangemaakt, dus de projectlijst kan heel even melden dat ze onderweg zijn.

  8. 8

    Bij een nieuwe installatie wordt de beheerder eenmalig gevraagd welke modules u gaat gebruiken. Vink aan wat u nodig hebt en ga verder. Later wijzigt u dit met de knop Achtergronddiensten in de bovenbalk.

    U zietEen eenmalige lijst met modules en het geheugen dat ze nodig hebben.

Als u een melding ziet

InstallatieEen blauw venster "Windows heeft uw pc beschermd".

Wat het betekent Het installatieprogramma is nog niet digitaal ondertekend, dus Windows kent de uitgever niet. Het is een waarschuwing, geen virusmelding.

Wat u doet Klik op Meer info, controleer of de bestandsnaam met OpenConstructionERP begint en klik op Toch uitvoeren.

InstallatieSlimme-app-beheer (Smart App Control) heeft de app geblokkeerd, zonder knop om door te gaan.

Wat het betekent Slimme-app-beheer in Windows 11 weigert niet-ondertekende programma's.

Wat u doet Slimme-app-beheer kan niet één enkele app toestaan. Om het ingeschakeld te laten, draait u OpenConstructionERP met Docker Desktop of in WSL (het ingebouwde Linux van Windows), die Slimme-app-beheer niet controleert. Stapsgewijze instructies: docs/desktop/WINDOWS_BLOCKED.md in de repository.

Installatie"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" (de melding bestaat alleen in het Engels)Betekenis: het pad van de installatiemap mag alleen Latijnse letters, cijfers en spaties bevatten, omdat de ingebouwde database vanaf geen enkel ander pad kan starten.

Wat het betekent De gekozen map heeft in het pad Cyrillische, Chinese, geaccentueerde of andere niet-Latijnse letters.

Wat u doet Houd de voorgestelde map C:\Program Files\OpenConstructionERP aan, of kies een map zoals C:\OpenConstructionERP. Een stille installatie (/S) stopt met code 3 en schrijft de reden naar %TEMP%\OpenConstructionERP-install-error.log.

InstallatieHet installatieprogramma stopt met een fout over WebView2.

Wat het betekent Windows weigerde Microsoft WebView2 te installeren, het onderdeel dat het appvenster tekent. Het zit in het installatieprogramma, dus u hebt geen internet nodig; de fout komt van Windows zelf (beleid, een openstaande update of een beschadigde eerdere WebView2).

Wat u doet Start de computer opnieuw op en voer het installatieprogramma nog eens uit. Mislukt het opnieuw, installeer dan "Microsoft Edge WebView2 Runtime" van Microsoft en start ons installatieprogramma nog een keer.

InstallatieUw antivirusprogramma verwijdert of isoleert een bestand tijdens de installatie of bij de eerste start.

Wat het betekent Het programma is nieuw en niet ondertekend, en sommige antivirusprogramma's vertrouwen dat niet.

Wat u doet Zet het bestand terug uit de quarantaine en voeg deze twee mappen toe als uitzondering: de programmamap C:\Program Files\OpenConstructionERP en uw gegevensmap C:\Users\<your name>\.openestimate. Voer daarna het installatieprogramma opnieuw uit over de bestaande installatie. Weet u niet zeker of het bestand echt is, schrijf ons dan eerst.

UpgradeEen scherm dat vraagt of de geïnstalleerde versie overschreven moet worden of eerst verwijderd, met een regel die voorstelt te verwijderen.

Wat u doet Houd de al gekozen optie aan (overschrijven). Uw projecten blijven behouden. De eerste start na een upgrade kan langer duren terwijl de database zichzelf bijwerkt.

UpgradeU draait OpenConstructionERP ook via pip of in een terminal op dezelfde computer, en het stopt tijdens de upgrade.

Wat het betekent Beide gebruiken dezelfde map .openestimate en dezelfde database. Het installatieprogramma stopt die database om het programma te vervangen. Bij een upgrade vanaf 18.4.0 sluit het oude verwijderprogramma ook elk programma met de naam openconstructionerp.exe.

Wat u doet Stop de terminalversie (Ctrl+C) voordat u installeert of upgradet en start hem daarna weer.

StartHet laadscherm blijft bij de allereerste start een minuut of langer staan.

Wat het betekent De app maakt zijn lokale database aan. Dit gebeurt één keer.

Wat u doet Wacht en sluit het venster niet. Op een trage of bijna volle schijf kan het langer duren. Latere starts zijn snel.

StartEen venster "OpenConstructionERP failed to start" dat een logbestand noemt.

Wat het betekent De app kon zijn venster helemaal niet openen.

Wat u doet Start hem nog eens. Komt het venster terug, stuur ons dan het logbestand dat erin staat.

Start"The backend started, but the local database is not answering, so the app cannot open."Betekenis: het servergedeelte is gestart, maar de lokale database reageert niet, dus de app kan niet openen.

Wat het betekent De lokale database kwam niet omhoog, vaak na een sessie die niet netjes is afgesloten.

Wat u doet Start de computer opnieuw op en start de app weer. Herhaalt het zich, stuur ons dan desktop-launcher.log en het databaselogboek (zie Logbestanden).

Start"The backend started, but this installation is missing the application files it serves"Betekenis: het servergedeelte is gestart, maar in de installatie ontbreken de bestanden van de gebruikersinterface.

Wat het betekent Een deel van de programmamap ontbreekt, meestal verwijderd door het antivirusprogramma.

Wat u doet Controleer de quarantaine van uw antivirusprogramma en voer het installatieprogramma daarna opnieuw uit over de bestaande installatie. Uw projecten worden niet aangeraakt.

Start"The application backend did not start in time", of "The application backend stopped responding while preparing the local database" (of bij een andere stap).

Wat het betekent Het starten duurde langer dan de app wacht. De melding noemt de stap waarbij het gebeurde.

Wat u doet Sluit het venster en start opnieuw. Maak eerst ruimte vrij als de schijf bijna vol is. Stopt het weer bij dezelfde stap, stuur ons dan desktop-launcher.log.

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

Wat het betekent Precies dat. De melding noemt de map en de resterende vrije ruimte.

Wat u doet Maak ruimte vrij op die schijf en start opnieuw.

StartEen melding dat de map voor de lokale database "sits too deep in the filesystem", met twee getallen.

Wat het betekent Windows beperkt de padlengte en het pad van uw gegevensmap is te lang voor de databasebestanden. Lange paden inschakelen in Windows helpt niet.

Wat u doet Stel de gebruikersomgevingsvariabele OE_DATA_DIR in op een kort pad zoals C:\OpenConstructionERP\data (Start, typ "omgevingsvariabelen", Omgevingsvariabelen voor uw account bewerken, Nieuw) en start daarna opnieuw.

StartUw Windows-gebruikersnaam bevat niet-Latijnse letters (bijvoorbeeld Cyrillisch of Chinees) en u zoekt uw database.

Wat het betekent De ingebouwde database kan niet draaien vanaf zo'n pad, dus sinds 18.5.0 bewaart de app de database in C:\ProgramData\OpenConstructionERP\clusters\<id>\pgdata. Vóór 18.5.0 kon de app voor zulke accounts helemaal niet starten.

Wat u doet Er hoeft niets te worden gerepareerd. Het bestand pgdata.location in uw map .openestimate noemt de exacte databasemap. Kopieer voor back-ups beide mappen.

Draaiend"The application backend stopped, restarting" en het venster laadt opnieuw.

Wat het betekent Het achtergronddeel van de app is onverwacht gestopt en de app heeft het opnieuw gestart. Opgeslagen werk blijft behouden. Dit gebeurt hooguit twee keer per 30 minuten.

Wat u doet Werk gewoon door. Herhaalt het zich, of ziet u "The application backend has stopped", stuur ons dan desktop-launcher.log en logs/backend-crash.log.

StartBij elke start van de app wordt u afgemeld en staat de taal weer op Engels.

Wat het betekent Een ander programma gebruikt poort 8732, de poort die de app normaal gebruikt. Versie 18.5.0 kiest dan bij elke start een willekeurige vrije poort, en het venster ziet elke nieuwe poort als een nieuwe site, waardoor aanmelding en taal niet worden gevonden.

Wat u doet Sluit of herconfigureer het andere programma dat poort 8732 gebruikt (voer in Windows netstat -ano | findstr :8732 uit in een terminal om de proces-ID te zien). Uw projecten blijven ongemoeid, alleen aanmelding en taalkeuze niet.

StartU bent bang dat de app botst met een PostgreSQL die u al op poort 5432 draait.

Wat het betekent Dat doet hij niet. De ingebouwde database neemt in Windows een willekeurige vrije lokale poort en luistert in macOS en Linux alleen op een lokale socket, niet op een TCP-poort.

Wat u doet Niets te doen.

Waar de logbestanden staan

  • desktop-launcher.logC:\Users\<your name>\.openestimate\desktop-launcher.logAlles wat de desktop-app deed tijdens het starten. Altijd in uw thuismap, ook als u de gegevensmap hebt verplaatst.
  • backend-crash.logC:\Users\<your name>\.openestimate\logs\backend-crash.logDetails van een onverwachte stop. Staat in de gegevensmap, dus verhuist mee met OE_DATA_DIR.
  • database log folderC:\Users\<your name>\.openestimate\pgdata\log (or <folder from pgdata.location>\log)Waarom de ingebouwde database niet startte.
  • OpenConstructionERP-install-error.log%TEMP%\OpenConstructionERP-install-error.log (typ %TEMP% in de adresbalk van Verkenner)Waarom het Windows-installatieprogramma de installatiemap weigerde.

Om de map te openen, plakt u dit in de adresbalk van Verkenner:

%USERPROFILE%\.openestimate

macOS

OpenConstructionERP_18.5.0_aarch64.dmgongeveer 640 MB

Voordat u begint Een Mac met Apple Silicon (M1 of nieuwer). Voor Intel-Macs is er geen build; gebruik op een Intel-Mac pip of Docker.

  1. 1

    Download OpenConstructionERP_18.5.0_aarch64.dmg en open het.

    U zietEen venster met het app-symbool van OpenConstructionERP.

  2. 2

    Sleep OpenConstructionERP naar Programma's.

    U zietDe app verschijnt in uw map Programma's.

  3. 3

    Open één keer Terminal en voer uit.

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

    U zietGeen uitvoer. Dat klopt. Dit verwijdert de downloadmarkering, omdat de app nog niet door Apple is genotariseerd.

  4. 4

    Open OpenConstructionERP vanuit Programma's.

    U zietHet laadscherm "De applicatie wordt gestart". De eerste start richt de lokale database in en duurt een minuut of twee.

  5. 5

    Kies appvenster of browser.

    U zietDe aanmeldpagina.

  6. 6

    Meld u aan met het demoaccount: e-mail demo@openconstructionerp.com, wachtwoord DemoPass1234!. Daarna kunt u uw eigen account en projecten aanmaken.

    U zietDe app. De demoprojecten worden bij de eerste start op de achtergrond aangemaakt, dus de projectlijst kan heel even melden dat ze onderweg zijn.

  7. 7

    Bij een nieuwe installatie wordt de beheerder eenmalig gevraagd welke modules u gaat gebruiken. Vink aan wat u nodig hebt en ga verder. Later wijzigt u dit met de knop Achtergronddiensten in de bovenbalk.

    U zietEen eenmalige lijst met modules en het geheugen dat ze nodig hebben.

Als u een melding ziet

StartHet laadscherm blijft bij de allereerste start een minuut of langer staan.

Wat het betekent De app maakt zijn lokale database aan. Dit gebeurt één keer.

Wat u doet Wacht en sluit het venster niet. Op een trage of bijna volle schijf kan het langer duren. Latere starts zijn snel.

Start"The backend started, but the local database is not answering, so the app cannot open."Betekenis: het servergedeelte is gestart, maar de lokale database reageert niet, dus de app kan niet openen.

Wat het betekent De lokale database kwam niet omhoog, vaak na een sessie die niet netjes is afgesloten.

Wat u doet Start de computer opnieuw op en start de app weer. Herhaalt het zich, stuur ons dan desktop-launcher.log en het databaselogboek (zie Logbestanden).

Start"The backend started, but this installation is missing the application files it serves"Betekenis: het servergedeelte is gestart, maar in de installatie ontbreken de bestanden van de gebruikersinterface.

Wat het betekent Een deel van de programmamap ontbreekt, meestal verwijderd door het antivirusprogramma.

Wat u doet Controleer de quarantaine van uw antivirusprogramma en voer het installatieprogramma daarna opnieuw uit over de bestaande installatie. Uw projecten worden niet aangeraakt.

Start"The application backend did not start in time", of "The application backend stopped responding while preparing the local database" (of bij een andere stap).

Wat het betekent Het starten duurde langer dan de app wacht. De melding noemt de stap waarbij het gebeurde.

Wat u doet Sluit het venster en start opnieuw. Maak eerst ruimte vrij als de schijf bijna vol is. Stopt het weer bij dezelfde stap, stuur ons dan desktop-launcher.log.

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

Wat het betekent In macOS en Linux pakt de app bij elke start zijn backend uit. Een trage of volle schijf, of een antivirusprogramma dat de bestanden vergrendelt, verhindert dat. (De Windows-app pakt zich sinds 18.5 niet meer uit.)

Wat u doet Maak ruimte vrij op de schijf met uw tijdelijke map, of sta de app toe in uw antivirusprogramma en start daarna opnieuw.

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

Wat het betekent Precies dat. De melding noemt de map en de resterende vrije ruimte.

Wat u doet Maak ruimte vrij op die schijf en start opnieuw.

Draaiend"The application backend stopped, restarting" en het venster laadt opnieuw.

Wat het betekent Het achtergronddeel van de app is onverwacht gestopt en de app heeft het opnieuw gestart. Opgeslagen werk blijft behouden. Dit gebeurt hooguit twee keer per 30 minuten.

Wat u doet Werk gewoon door. Herhaalt het zich, of ziet u "The application backend has stopped", stuur ons dan desktop-launcher.log en logs/backend-crash.log.

StartBij elke start van de app wordt u afgemeld en staat de taal weer op Engels.

Wat het betekent Een ander programma gebruikt poort 8732, de poort die de app normaal gebruikt. Versie 18.5.0 kiest dan bij elke start een willekeurige vrije poort, en het venster ziet elke nieuwe poort als een nieuwe site, waardoor aanmelding en taal niet worden gevonden.

Wat u doet Sluit of herconfigureer het andere programma dat poort 8732 gebruikt (voer in Windows netstat -ano | findstr :8732 uit in een terminal om de proces-ID te zien). Uw projecten blijven ongemoeid, alleen aanmelding en taalkeuze niet.

StartU bent bang dat de app botst met een PostgreSQL die u al op poort 5432 draait.

Wat het betekent Dat doet hij niet. De ingebouwde database neemt in Windows een willekeurige vrije lokale poort en luistert in macOS en Linux alleen op een lokale socket, niet op een TCP-poort.

Wat u doet Niets te doen.

Installatie"“OpenConstructionERP” is beschadigd en kan niet worden geopend."

Wat het betekent De app is nog niet door Apple genotariseerd en heeft nog de downloadmarkering. De app is niet beschadigd.

Wat u doet Alleen dit helpt: voer in Terminal één keer xattr -dr com.apple.quarantine /Applications/OpenConstructionERP.app uit en open de app daarna gewoon.

Installatie"“OpenConstructionERP” kan niet worden geopend omdat de ontwikkelaar niet kan worden geverifieerd" (of Apple kon niet vaststellen dat de app vrij is van malware).

Wat het betekent De app is ad hoc ondertekend maar nog niet door Apple genotariseerd.

Wat u doet Voer dezelfde xattr-opdracht uit, of open Systeeminstellingen, Privacy en beveiliging, scrol omlaag en klik op Open toch. Dit hoeft maar één keer.

InstallatieDe app draait helemaal niet op uw Mac.

Wat het betekent De Mac-build is alleen voor Apple Silicon (M1 en nieuwer). Er is geen Intel-build.

Wat u doet Gebruik op een Intel-Mac pip (Python 3.12 of nieuwer) of Docker.

Waar de logbestanden staan

  • desktop-launcher.log~/.openestimate/desktop-launcher.logAlles wat de desktop-app deed tijdens het starten. Altijd in uw thuismap, ook als u de gegevensmap hebt verplaatst.
  • backend-crash.log~/.openestimate/logs/backend-crash.logDetails van een onverwachte stop. Staat in de gegevensmap, dus verhuist mee met OE_DATA_DIR.
  • database log folder~/.openestimate/pgdata/logWaarom de ingebouwde database niet startte.

Om de map vanuit een terminal te openen:

open ~/.openestimate

Linux

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

Voordat u begint 64-bits x86 (amd64). Het pakket heeft libwebkit2gtk-4.1-0 nodig, dat apt voor u installeert. Gebouwd op Ubuntu 22.04, dus Ubuntu 22.04 of nieuwer en Debian 12 of nieuwer zijn de veilige keuze.

  1. 1

    Download OpenConstructionERP_18.5.0_amd64.deb.

    U zietEen bestand van ongeveer 830 MB.

  2. 2

    Voer in een terminal in de downloadmap uit.

    sudo apt install ./OpenConstructionERP_18.5.0_amd64.deb

    U zietapt toont het pakket en de bibliotheken die het nodig heeft en installeert ze. De ./ vóór de bestandsnaam is belangrijk.

  3. 3

    Start OpenConstructionERP vanuit het applicatiemenu.

    U zietHet laadscherm. De eerste start duurt een minuut of twee.

  4. 4

    Meld u aan met het demoaccount: e-mail demo@openconstructionerp.com, wachtwoord DemoPass1234!. Daarna kunt u uw eigen account en projecten aanmaken.

    U zietDe app. De demoprojecten worden bij de eerste start op de achtergrond aangemaakt, dus de projectlijst kan heel even melden dat ze onderweg zijn.

  5. 5

    Bij een nieuwe installatie wordt de beheerder eenmalig gevraagd welke modules u gaat gebruiken. Vink aan wat u nodig hebt en ga verder. Later wijzigt u dit met de knop Achtergronddiensten in de bovenbalk.

    U zietEen eenmalige lijst met modules en het geheugen dat ze nodig hebben.

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

Voordat u begint 64-bits x86. Het pakket heeft de bibliotheek WebKitGTK 4.1 nodig, die de pakketbeheerder voor u installeert.

  1. 1

    Download OpenConstructionERP-18.5.0-1.x86_64.rpm.

    U zietEen bestand van ongeveer 850 MB.

  2. 2

    Voer uit.

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

    U zietdnf lost de afhankelijkheden op en installeert.

  3. 3

    Start OpenConstructionERP vanuit het applicatiemenu.

    U zietHet laadscherm. De eerste start duurt een minuut of twee.

  4. 4

    Meld u aan met het demoaccount: e-mail demo@openconstructionerp.com, wachtwoord DemoPass1234!. Daarna kunt u uw eigen account en projecten aanmaken.

    U zietDe app. De demoprojecten worden bij de eerste start op de achtergrond aangemaakt, dus de projectlijst kan heel even melden dat ze onderweg zijn.

  5. 5

    Bij een nieuwe installatie wordt de beheerder eenmalig gevraagd welke modules u gaat gebruiken. Vink aan wat u nodig hebt en ga verder. Later wijzigt u dit met de knop Achtergronddiensten in de bovenbalk.

    U zietEen eenmalige lijst met modules en het geheugen dat ze nodig hebben.

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

Voordat u begint 64-bits x86 en de bibliotheek FUSE 2 (libfuse2; in Ubuntu 24.04 heet het pakket libfuse2t64).

  1. 1

    Download OpenConstructionERP_18.5.0_amd64.AppImage.

    U zietEen bestand van ongeveer 910 MB.

  2. 2

    Maak het uitvoerbaar.

    chmod +x OpenConstructionERP_18.5.0_amd64.AppImage

    U zietGeen uitvoer.

  3. 3

    Start het.

    ./OpenConstructionERP_18.5.0_amd64.AppImage

    U zietHet laadscherm. De eerste start duurt een minuut of twee.

  4. 4

    Meld u aan met het demoaccount: e-mail demo@openconstructionerp.com, wachtwoord DemoPass1234!. Daarna kunt u uw eigen account en projecten aanmaken.

    U zietDe app. De demoprojecten worden bij de eerste start op de achtergrond aangemaakt, dus de projectlijst kan heel even melden dat ze onderweg zijn.

  5. 5

    Bij een nieuwe installatie wordt de beheerder eenmalig gevraagd welke modules u gaat gebruiken. Vink aan wat u nodig hebt en ga verder. Later wijzigt u dit met de knop Achtergronddiensten in de bovenbalk.

    U zietEen eenmalige lijst met modules en het geheugen dat ze nodig hebben.

Als u een melding ziet

StartHet laadscherm blijft bij de allereerste start een minuut of langer staan.

Wat het betekent De app maakt zijn lokale database aan. Dit gebeurt één keer.

Wat u doet Wacht en sluit het venster niet. Op een trage of bijna volle schijf kan het langer duren. Latere starts zijn snel.

Start"The backend started, but the local database is not answering, so the app cannot open."Betekenis: het servergedeelte is gestart, maar de lokale database reageert niet, dus de app kan niet openen.

Wat het betekent De lokale database kwam niet omhoog, vaak na een sessie die niet netjes is afgesloten.

Wat u doet Start de computer opnieuw op en start de app weer. Herhaalt het zich, stuur ons dan desktop-launcher.log en het databaselogboek (zie Logbestanden).

Start"The backend started, but this installation is missing the application files it serves"Betekenis: het servergedeelte is gestart, maar in de installatie ontbreken de bestanden van de gebruikersinterface.

Wat het betekent Een deel van de programmamap ontbreekt, meestal verwijderd door het antivirusprogramma.

Wat u doet Controleer de quarantaine van uw antivirusprogramma en voer het installatieprogramma daarna opnieuw uit over de bestaande installatie. Uw projecten worden niet aangeraakt.

Start"The application backend did not start in time", of "The application backend stopped responding while preparing the local database" (of bij een andere stap).

Wat het betekent Het starten duurde langer dan de app wacht. De melding noemt de stap waarbij het gebeurde.

Wat u doet Sluit het venster en start opnieuw. Maak eerst ruimte vrij als de schijf bijna vol is. Stopt het weer bij dezelfde stap, stuur ons dan desktop-launcher.log.

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

Wat het betekent In macOS en Linux pakt de app bij elke start zijn backend uit. Een trage of volle schijf, of een antivirusprogramma dat de bestanden vergrendelt, verhindert dat. (De Windows-app pakt zich sinds 18.5 niet meer uit.)

Wat u doet Maak ruimte vrij op de schijf met uw tijdelijke map, of sta de app toe in uw antivirusprogramma en start daarna opnieuw.

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

Wat het betekent Precies dat. De melding noemt de map en de resterende vrije ruimte.

Wat u doet Maak ruimte vrij op die schijf en start opnieuw.

Draaiend"The application backend stopped, restarting" en het venster laadt opnieuw.

Wat het betekent Het achtergronddeel van de app is onverwacht gestopt en de app heeft het opnieuw gestart. Opgeslagen werk blijft behouden. Dit gebeurt hooguit twee keer per 30 minuten.

Wat u doet Werk gewoon door. Herhaalt het zich, of ziet u "The application backend has stopped", stuur ons dan desktop-launcher.log en logs/backend-crash.log.

StartBij elke start van de app wordt u afgemeld en staat de taal weer op Engels.

Wat het betekent Een ander programma gebruikt poort 8732, de poort die de app normaal gebruikt. Versie 18.5.0 kiest dan bij elke start een willekeurige vrije poort, en het venster ziet elke nieuwe poort als een nieuwe site, waardoor aanmelding en taal niet worden gevonden.

Wat u doet Sluit of herconfigureer het andere programma dat poort 8732 gebruikt (voer in Windows netstat -ano | findstr :8732 uit in een terminal om de proces-ID te zien). Uw projecten blijven ongemoeid, alleen aanmelding en taalkeuze niet.

StartU bent bang dat de app botst met een PostgreSQL die u al op poort 5432 draait.

Wat het betekent Dat doet hij niet. De ingebouwde database neemt in Windows een willekeurige vrije lokale poort en luistert in macOS en Linux alleen op een lokale socket, niet op een TCP-poort.

Wat u doet Niets te doen.

InstallatieDe .deb vraagt om libwebkit2gtk-4.1-0, of dpkg meldt onvervulde afhankelijkheden.

Wat het betekent De app heeft WebKitGTK 4.1 nodig om zijn venster te tekenen. dpkg -i installeert geen afhankelijkheden.

Wat u doet Installeer met sudo apt install ./OpenConstructionERP_18.5.0_amd64.deb, dat de bibliotheek meebrengt. Heeft uw distributie geen libwebkit2gtk-4.1-0 (Ubuntu ouder dan 22.04, Debian ouder dan 12), gebruik dan pip.

InstallatieDe AppImage doet niets als u erop dubbelklikt.

Wat het betekent Het bestand is nog niet als programma gemarkeerd.

Wat u doet Voer chmod +x OpenConstructionERP_18.5.0_amd64.AppImage uit en start het opnieuw.

InstallatieEen AppImage-fout die FUSE of libfuse.so.2 noemt.

Wat het betekent Nieuwere distributies installeren de FUSE 2-bibliotheek die AppImages gebruiken niet meer.

Wat u doet Installeer die (sudo apt install libfuse2, in Ubuntu 24.04 sudo apt install libfuse2t64), of gebruik de .deb, de .rpm of pip.

Waar de logbestanden staan

  • desktop-launcher.log~/.openestimate/desktop-launcher.logAlles wat de desktop-app deed tijdens het starten. Altijd in uw thuismap, ook als u de gegevensmap hebt verplaatst.
  • backend-crash.log~/.openestimate/logs/backend-crash.logDetails van een onverwachte stop. Staat in de gegevensmap, dus verhuist mee met OE_DATA_DIR.
  • database log folder~/.openestimate/pgdata/logWaarom de ingebouwde database niet startte.

Om de map vanuit een terminal te openen:

xdg-open ~/.openestimate

pip

Pakket openconstructionerp

Voordat u begint Python 3.12 of nieuwer. Controleer met python --version. Geen Docker en geen aparte database: pip brengt een ingebouwde PostgreSQL mee.

Bekijk deze stap:
  1. 1

    Voer uit.

    pip install --upgrade openconstructionerp

    U zietpip downloadt het pakket en de afhankelijkheden.

  2. 2

    Voer uit.

    openconstructionerp

    U zietEen korte welkomsttekst. Bij de eerste keer vraagt het of de demoprojecten geladen moeten worden en of uw browser geopend moet worden.

  3. 3

    Wacht terwijl de lokale database wordt ingericht.

    U ziet"Database: embedded PostgreSQL 16 (no Docker)" en daarna start de server. Uw browser opent http://127.0.0.1:8080 (hetzelfde als http://localhost:8080).

  4. 4

    Meld u aan. Met demogegevens kunt u demo@openconstructionerp.com / DemoPass1234! gebruiken.

    U zietHet dashboard.

  5. 5

    Bij een nieuwe installatie wordt de beheerder eenmalig gevraagd welke modules u gaat gebruiken. Vink aan wat u nodig hebt en ga verder. Later wijzigt u dit met de knop Achtergronddiensten in de bovenbalk.

    U zietEen eenmalige lijst met modules en het geheugen dat ze nodig hebben.

  6. 6

    Druk om te stoppen op Ctrl+C in de terminal. Voer de volgende keer gewoon opnieuw openconstructionerp uit.

    U zietDe server stopt. Uw gegevens blijven in de map .openestimate in uw thuismap.

Handige opdrachten

De opdracht openconstructionerp wordt niet gevonden

python -m openconstructionerp

Iets werkt niet: controleert Python, de poort, de gegevensmap en de database en zegt wat u moet doen

openconstructionerp doctor

Poort 8080 is bezet door een ander programma

openconstructionerp serve --port 8081

Andere computers in uw netwerk moeten erbij kunnen

openconstructionerp serve --host 0.0.0.0 --port 8080

U moet ons uw versie doorgeven

openconstructionerp --version

Als u een melding ziet

Installatiepip meldt dat er geen passende distributie is gevonden, of dat een andere Python nodig is.

Wat het betekent OpenConstructionERP heeft Python 3.12 of nieuwer nodig.

Wat u doet Installeer Python 3.12 of nieuwer en voer python3.12 -m pip install --upgrade openconstructionerp uit (in Windows: py -3.12 -m pip install --upgrade openconstructionerp).

Installatieerror: externally-managed-environment (Ubuntu 23.04+, Debian 12+).Betekenis: uw Linux-systeem beschermt zijn eigen Python en weigert er pakketten in te installeren.

Wat het betekent De systeem-Python staat niet toe dat pip er iets in installeert.

Wat u doet Gebruik pipx install openconstructionerp, of maak eerst een virtuele omgeving: python3 -m venv ~/oe && ~/oe/bin/pip install openconstructionerp.

Start"openconstructionerp" is not recognized, of command not found.

Wat het betekent De map waar pip opdrachten neerzet staat niet in uw PATH (komt in Windows vaak voor).

Wat u doet Voer in plaats daarvan python -m openconstructionerp uit. Dat werkt op elk systeem zonder aan PATH te komen.

Start"Port 8080 is already in use. Try: openconstructionerp serve --port 8081"Betekenis: een ander programma gebruikt poort 8080 al, start de app dus op een andere poort, bijvoorbeeld 8081.

Wat het betekent Een ander programma gebruikt poort 8080.

Wat u doet Voer de voorgestelde opdracht uit en open het adres dat die toont.

Start"Embedded PostgreSQL could not start".Betekenis: de ingebouwde PostgreSQL-database kon niet starten.

Wat het betekent De ingebouwde database kon niet starten. De melding toont het pad van het bijbehorende logbestand.

Wat u doet Voer openconstructionerp doctor uit. Helpt dat niet, installeer dan opnieuw met pip install --upgrade --force-reinstall openconstructionerp en stuur ons het genoemde logbestand.

Waar de logbestanden staan

  • terminal outputthe terminal window (pip); docker compose logs app (Docker)Kopieer bij pip en Docker wat de terminal toonde en de uitvoer van openconstructionerp doctor.

Docker

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

Voordat u begint Docker met Docker Compose. De gepubliceerde image is gebouwd voor x86-64 (amd64). Bouw op Apple Silicon of andere ARM-machines vanuit de broncode (make quickstart) of gebruik pip. De opdrachten hieronder zijn voor een bash-shell (Linux, macOS, of Git Bash of WSL in Windows). Windows PowerShell heeft geen openssl en schrijft bestanden in een formaat dat compose niet kan lezen.

  1. 1

    Download in een lege map de twee compose-bestanden.

    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

    U zietTwee bestanden in de map.

  2. 2

    Maak eenmalig het bestand met geheimen aan.

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

    U zietEen bestand .env. Bewaar het: het bevat het databasewachtwoord en het aanmeldgeheim.

  3. 3

    Start het.

    docker compose pull app && docker compose up -d

    U zietTwee containers starten: postgres en app.

  4. 4

    Open http://localhost:8080 en meld u aan met demo@openconstructionerp.com / DemoPass1234!

    U zietDe aanmeldpagina. De eerste start kan een minuut duren terwijl de database wordt voorbereid.

  5. 5

    Bij een nieuwe installatie wordt de beheerder eenmalig gevraagd welke modules u gaat gebruiken. Vink aan wat u nodig hebt en ga verder. Later wijzigt u dit met de knop Achtergronddiensten in de bovenbalk.

    U zietEen eenmalige lijst met modules en het geheugen dat ze nodig hebben.

Handige opdrachten

Controleren of beide containers draaien en gezond zijn

docker compose ps

Zien waarom de app niet start

docker compose logs app

Poort 8080 op uw computer is bezet

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

Deze compose-opzet is bedoeld voor evaluatie en lokaal gebruik. Voor een productieserver zie docs/INSTALL_LINUX.md en docker-compose.prod.yml in de repository.

Als u een melding ziet

StartCompose stopt met "POSTGRES_PASSWORD must be set" of "JWT_SECRET must be set".

Wat het betekent Het bestand .env met de twee geheimen ontbreekt of staat niet in dezelfde map.

Wat u doet Maak het bestand .env aan zoals in stap 2, in de map met docker-compose.yml.

Starthttp://localhost:8080 gaat niet open.

Wat het betekent De container draait nog niet, of poort 8080 is bezet.

Wat u doet Voer docker compose ps en docker compose logs app uit. Voor een andere poort: OE_PORT=8081 OE_ALLOWED_ORIGINS=http://localhost:8081 docker compose up -d, en open daarna http://localhost:8081.

InstallatieOp een Mac met Apple Silicon of een andere ARM-machine waarschuwt Docker dat het imageplatform linux/amd64 niet overeenkomt, of draait de app erg traag.

Wat het betekent De gepubliceerde image is alleen voor x86-64 gebouwd.

Wat u doet Bouw vanuit de broncode met make quickstart, of gebruik pip.

Waar de logbestanden staan

  • terminal outputthe terminal window (pip); docker compose logs app (Docker)Kopieer bij pip en Docker wat de terminal toonde en de uitvoer van openconstructionerp doctor.

Uw gegevens, upgrades en verwijderen

Upgrade

Installeer de nieuwe versie over de oude heen. Uw map .openestimate hoort niet bij het programma, dus projecten, gebruikers en instellingen blijven behouden. De eerste start na een upgrade kan langer duren terwijl de database zichzelf bijwerkt.

Verwijderen

Verwijderen haalt het programma weg en laat uw projecten staan. In Windows biedt het verwijderprogramma "Delete the application data" aan (in de taal van het installatieprogramma): dat verwijdert alleen de opgeslagen aanmelding en taal van het appvenster (in %APPDATA% en %LOCALAPPDATA%\io.openconstructionerp.desktop), niet uw projecten. Om helemaal opnieuw te beginnen verwijdert u het programma, kopieert u .openestimate naar een veilige plek en wist u de map daarna.

Back-up

Sluit de app en kopieer de map .openestimate (en de ProgramData-map uit pgdata.location, als die er is).

Nog steeds vast? Wij helpen u

Geef alstublieft door:

GitHub Issues GitHub Discussions info@datadrivenconstruction.io

Logbestanden kunnen uw gebruikersnaam en mapnamen bevatten. Lees ze door voordat u ze openbaar plaatst; stuur ze liever per e-mail als u wilt.

Volgende stappen na de installatie

Geïnstalleerd en ingelogd? Bekijk deze video’s op volgorde. Elk is kort en toont de echte app.

  1. Eerste stappen na de installatie

    De tweede helft van de installatievideo: eerste start, taal en regio, modules, gebruikers, je eerste project.

  2. Zie het hele product

    Ook handig

    Productrondleiding: BOQ, BIM, DWG, PDF-takeoff en calculeren met AI

    12:01 minuten, opgenomen met een eerdere versie. Toont ook een pip-installatie.

    Korte rondleiding, 2:37: één gebouw, één bron van waarheid

  3. Basis van calculeren

    Builder's Playbook: Getting Started3 video’sBegin hier: kostendatabase en eenheidsprijzen, een begroting stap voor stap, algemene kosten, winst en onvoorzien (VS).

  4. Jouw markt, van begin tot eind

    Builder's Playbook UK: Construction in England6 video’s · ENCommercieel beheer in het VK: tenderprijzen volgens NRM 2, offertevergelijking, JCT-betalingen en inhoudingen, pay less notices, CIS en btw-verlegging, meerwerk.Builder's Playbook: Canada6 video’s · ENCanada/Ontario: prijsstelling, aanbesteding van onderaannemers, CCDC 2 termijnbetalingen, tijdige betaling (prompt payment), wijzigingsopdrachten, substantiële oplevering.Builder's Playbook: Québec5 video’s · FRQuébec in het Frans: aan de slag, calculeren, BSDQ-aanbestedingen, facturatie met inhouding en wettelijke hypotheek, oplevering en gebreken.OpenConstructionERP auf Deutsch: vom Projektstart bis zur Übergabe8 video’s · DEDuitse serie van projectopzet via tekeningen/RFI, hoeveelheden, BIM-controles, LV, eenheidsprijzen en GAEB X83/X84 tot gunning (genummerd /12, 8 gepubliceerd).Builder's Playbook Hrvatska: gradnja u Hrvatskoj5 video’s · HRKroatië: import van de contractuele BOQ uit Excel, inkomende facturen, onderaannemers, termijnstaten, financiële stand en meerwerk.

  5. De bouwplaats runnen: budget, inkoop, uren, facturen

    OpenConstructionERP en français: gérer un chantier4 video’s · FRBouwplaatsbeheer in het Frans: budget, inkoop en voorraad, uren en materieel, facturen en betalingen.

Alle afspeellijsten op het kanaal van OpenConstruction Academy

De volledige tekst staat ook op GitHub in English, Deutsch en Русский.