Installationshjälp

Installera OpenConstructionERP

Välj hur du vill köra det, följ de numrerade stegen och om något ser fel ut, leta upp meddelandet du ser i problemlistan längre ned. Inga av varningarna under installationen utsätter dina projekt för risk.

Osäker på vilken du behöver?

Titta först

Så installerar du OpenConstructionERP

Videoguide i Windows, inspelad med version 17.7.1. Vissa skärmar ser annorlunda ut i 18.5, och väntetiden under installationen är förkortad i videon.

Längd 4:41 · Titta på YouTube

Windows

OpenConstructionERP_18.5.0_x64-setup.execirka 800 MB

Innan du börjar Windows 10 eller 11, 64-bitars. Administratörsbehörighet (appen installeras för alla användare). Du behöver inget internet under installationen: fönsterkomponenten (Microsoft WebView2) finns i installationsprogrammet.

Titta på det här steget:
  1. 1

    Ladda ned OpenConstructionERP_18.5.0_x64-setup.exe från utgåvesidan.

    Du serEn fil på cirka 800 MB i mappen Hämtade filer.

  2. 2

    Dubbelklicka på den. Om ett blått fönster säger "Windows skyddade datorn", klicka på Mer information, kontrollera att filnamnet börjar med OpenConstructionERP och klicka sedan på Kör ändå.

    Du serWindows ber om administratörsbehörighet. Klicka på Ja.

  3. 3

    Välj språk för installationsprogrammet, godkänn licensen och behåll den föreslagna mappen C:\Program Files\OpenConstructionERP.

    Du serEtt förloppsfält och sedan en slutsida.

  4. 4

    Klicka på Slutför, eller starta OpenConstructionERP från Start-menyn.

    Du serEn laddningsskärm "Programmet startar" med en checklista: startar backend, startar den lokala databasen, förbereder databasen, startar applikationsservern, öppnar appen.

  5. 5

    Vänta vid allra första starten. Stäng inte fönstret.

    Du ser"Vid första starten skapas din lokala databas. Det kan ta en eller två minuter, vänta gärna." Senare starter är mycket snabbare.

  6. 6

    Välj hur den ska öppnas: som ett appfönster (rekommenderas) eller i din vanliga webbläsare.

    Du ser"Hur vill du öppna OpenConstructionERP?" och sedan inloggningssidan.

  7. 7

    Logga in med demokontot: e-post demo@openconstructionerp.com, lösenord DemoPass1234!. Därefter kan du skapa ditt eget konto och egna projekt.

    Du serAppen. Demoprojekten skapas i bakgrunden vid första starten, så projektlistan kan en kort stund säga att de är på väg.

  8. 8

    Vid en ny installation får administratören en gång frågan vilka moduler du ska använda. Kryssa i det du behöver och fortsätt. Du kan ändra det senare med knappen Bakgrundstjänster i översta fältet.

    Du serEn engångslista med moduler och det minne de behöver.

Om du ser ett meddelande

InstallationEtt blått fönster "Windows skyddade datorn".

Det betyder Installationsprogrammet är inte kodsignerat än, så Windows känner inte till utgivaren. Det är en varning, inte ett virusfynd.

Gör så här Klicka på Mer information, kontrollera att filnamnet börjar med OpenConstructionERP och klicka sedan på Kör ändå.

InstallationSmart appkontroll (Smart App Control) blockerade appen, utan knapp för att fortsätta.

Det betyder Smart appkontroll i Windows 11 nekar osignerade program.

Gör så här Smart appkontroll kan inte tillåta en enskild app. Vill du ha den påslagen, kör OpenConstructionERP med Docker Desktop eller i WSL (Windows inbyggda Linux), som Smart appkontroll inte kontrollerar. Steg-för-steg-anvisningar: docs/desktop/WINDOWS_BLOCKED.md i repot.

Installation"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" (meddelandet finns bara på engelska)Betydelse: sökvägen till installationsmappen får bara innehålla latinska bokstäver, siffror och mellanslag, eftersom den inbyggda databasen inte kan starta från någon annan sökväg.

Det betyder Mappen du valde har kyrilliska, kinesiska, accentuerade eller andra icke-latinska tecken i sökvägen.

Gör så här Behåll den föreslagna mappen C:\Program Files\OpenConstructionERP, eller välj en mapp som C:\OpenConstructionERP. En tyst installation (/S) avslutas med kod 3 och skriver orsaken till %TEMP%\OpenConstructionERP-install-error.log.

InstallationInstallationsprogrammet stannar med ett fel om WebView2.

Det betyder Windows vägrade installera Microsoft WebView2, komponenten som ritar appfönstret. Den finns i installationsprogrammet, så du behöver inget internet; felet kommer från Windows självt (policy, en väntande uppdatering eller en skadad tidigare WebView2).

Gör så här Starta om datorn och kör installationsprogrammet igen. Om det misslyckas igen, installera "Microsoft Edge WebView2 Runtime" från Microsoft och kör sedan vårt installationsprogram en gång till.

InstallationDitt antivirusprogram tar bort eller sätter en fil i karantän under installationen eller vid första starten.

Det betyder Programmet är nytt och osignerat, och en del antivirusprogram är misstänksamma mot det.

Gör så här Återställ filen från karantänen och lägg till dessa två mappar som undantag: programmappen C:\Program Files\OpenConstructionERP och din datamapp C:\Users\<your name>\.openestimate. Kör sedan installationsprogrammet igen över den befintliga installationen. Är du inte säker på att filen är äkta, skriv till oss först.

UppgraderingEn skärm som frågar om den installerade versionen ska skrivas över eller tas bort först, med en rad som föreslår att ta bort den.

Gör så här Behåll alternativet som redan är valt (skriv över). Dina projekt behålls. Första starten efter en uppgradering kan ta längre tid medan databasen uppdaterar sig själv.

UppgraderingDu kör också OpenConstructionERP via pip eller i en terminal på samma dator, och det stannar under uppgraderingen.

Det betyder Båda använder samma mapp .openestimate och samma databas. Installationsprogrammet stoppar databasen för att byta ut programmet. Vid uppgradering från 18.4.0 stänger det gamla avinstallationsprogrammet också alla program som heter openconstructionerp.exe.

Gör så här Stoppa terminalversionen (Ctrl+C) innan du installerar eller uppgraderar och starta den igen efteråt.

StartLaddningsskärmen står kvar i en minut eller mer vid allra första starten.

Det betyder Appen skapar sin lokala databas. Det händer bara en gång.

Gör så här Vänta och stäng inte fönstret. På en långsam eller nästan full disk kan det ta längre tid. Senare starter går snabbt.

StartEn ruta "OpenConstructionERP failed to start" som anger en loggfil.

Det betyder Appen kunde inte öppna sitt fönster alls.

Gör så här Starta den en gång till. Kommer rutan tillbaka, skicka loggfilen den anger till oss.

Start"The backend started, but the local database is not answering, so the app cannot open."Betydelse: serverdelen har startat, men dess lokala databas svarar inte, så appen kan inte öppnas.

Det betyder Den lokala databasen kom inte upp, ofta efter en körning som inte avslutades ordentligt.

Gör så här Starta om datorn och starta appen igen. Upprepas det, skicka desktop-launcher.log och databasloggen till oss (se Loggar).

Start"The backend started, but this installation is missing the application files it serves"Betydelse: serverdelen har startat, men installationen saknar filerna för användargränssnittet.

Det betyder En del av programmappen saknas, oftast borttagen av antivirusprogrammet.

Gör så här Kontrollera antivirusprogrammets karantän och kör sedan installationsprogrammet igen över den befintliga installationen. Dina projekt rörs inte.

Start"The application backend did not start in time", eller "The application backend stopped responding while preparing the local database" (eller vid ett annat steg).

Det betyder Starten tog längre tid än appen väntar. Meddelandet anger vilket steg den var på.

Gör så här Stäng fönstret och starta om. Frigör först utrymme om disken är nästan full. Stannar den vid samma steg igen, skicka desktop-launcher.log till oss.

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

Det betyder Precis det. Meddelandet anger mappen och det lediga utrymmet som finns kvar.

Gör så här Frigör utrymme på den disken och starta om.

StartEtt meddelande om att mappen för den lokala databasen "sits too deep in the filesystem", med två siffror.

Det betyder Windows begränsar sökvägens längd och sökvägen till din datamapp är för lång för databasfilerna. Att slå på långa sökvägar i Windows hjälper inte.

Gör så här Sätt användarens miljövariabel OE_DATA_DIR till en kort sökväg som C:\OpenConstructionERP\data (Start, skriv "miljövariabler", Redigera miljövariabler för ditt konto, Ny) och starta sedan om.

StartDitt Windows-användarnamn har icke-latinska tecken (till exempel kyrilliska eller kinesiska) och du letar efter din databas.

Det betyder Den inbyggda databasen kan inte köras från en sådan sökväg, så sedan 18.5.0 lägger appen databasen i C:\ProgramData\OpenConstructionERP\clusters\<id>\pgdata. Före 18.5.0 kunde appen inte starta alls för sådana konton.

Gör så här Inget att åtgärda. Filen pgdata.location i din mapp .openestimate anger exakt databasmapp. För säkerhetskopior, kopiera båda mapparna.

Under körning"The application backend stopped, restarting" och fönstret laddas om.

Det betyder Appens bakgrundsdel stannade oväntat och appen startade om den. Sparat arbete behålls. Det görs högst två gånger på 30 minuter.

Gör så här Fortsätt. Upprepas det, eller ser du "The application backend has stopped", skicka desktop-launcher.log och logs/backend-crash.log till oss.

StartVarje gång du startar appen blir du utloggad och språket är tillbaka på engelska.

Det betyder Ett annat program använder port 8732, den port appen normalt använder. Version 18.5.0 väljer då en slumpmässig ledig port vid varje start, och fönstret behandlar varje ny port som en ny webbplats, så inloggningen och språket hittas inte.

Gör så här Stäng eller konfigurera om det andra programmet som använder port 8732 (kör netstat -ano | findstr :8732 i en terminal i Windows för att se dess process-ID). Dina projekt påverkas inte, bara inloggningen och språkvalet.

StartDu oroar dig för att appen krockar med en PostgreSQL som du redan kör på port 5432.

Det betyder Det gör den inte. Den inbyggda databasen tar i Windows en slumpmässig ledig lokal port, och i macOS och Linux lyssnar den bara på en lokal socket, inte på en TCP-port.

Gör så här Inget att göra.

Var loggarna finns

  • desktop-launcher.logC:\Users\<your name>\.openestimate\desktop-launcher.logAllt skrivbordsappen gjorde under starten. Alltid i din hemmapp, även om du har flyttat datamappen.
  • backend-crash.logC:\Users\<your name>\.openestimate\logs\backend-crash.logDetaljer om ett oväntat stopp. Ligger i datamappen och flyttar därför med OE_DATA_DIR.
  • database log folderC:\Users\<your name>\.openestimate\pgdata\log (or <folder from pgdata.location>\log)Varför den inbyggda databasen inte startade.
  • OpenConstructionERP-install-error.log%TEMP%\OpenConstructionERP-install-error.log (skriv %TEMP% i adressfältet i Utforskaren)Varför Windows-installationsprogrammet avvisade installationsmappen.

För att öppna mappen, klistra in detta i adressfältet i Utforskaren:

%USERPROFILE%\.openestimate

macOS

OpenConstructionERP_18.5.0_aarch64.dmgcirka 640 MB

Innan du börjar En Mac med Apple Silicon (M1 eller senare). Det finns ingen version för Intel-Mac; på en Intel-Mac använder du pip eller Docker.

  1. 1

    Ladda ned OpenConstructionERP_18.5.0_aarch64.dmg och öppna den.

    Du serEtt fönster med appikonen för OpenConstructionERP.

  2. 2

    Dra OpenConstructionERP till Program.

    Du serAppen dyker upp i mappen Program.

  3. 3

    Öppna Terminal en gång och kör.

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

    Du serIngen utdata. Det är rätt. Det här tar bort nedladdningsmarkeringen, eftersom appen inte är notariserad av Apple än.

  4. 4

    Öppna OpenConstructionERP från Program.

    Du serLaddningsskärmen "Programmet startar". Första starten sätter upp den lokala databasen och tar en eller två minuter.

  5. 5

    Välj appfönster eller webbläsare.

    Du serInloggningssidan.

  6. 6

    Logga in med demokontot: e-post demo@openconstructionerp.com, lösenord DemoPass1234!. Därefter kan du skapa ditt eget konto och egna projekt.

    Du serAppen. Demoprojekten skapas i bakgrunden vid första starten, så projektlistan kan en kort stund säga att de är på väg.

  7. 7

    Vid en ny installation får administratören en gång frågan vilka moduler du ska använda. Kryssa i det du behöver och fortsätt. Du kan ändra det senare med knappen Bakgrundstjänster i översta fältet.

    Du serEn engångslista med moduler och det minne de behöver.

Om du ser ett meddelande

StartLaddningsskärmen står kvar i en minut eller mer vid allra första starten.

Det betyder Appen skapar sin lokala databas. Det händer bara en gång.

Gör så här Vänta och stäng inte fönstret. På en långsam eller nästan full disk kan det ta längre tid. Senare starter går snabbt.

Start"The backend started, but the local database is not answering, so the app cannot open."Betydelse: serverdelen har startat, men dess lokala databas svarar inte, så appen kan inte öppnas.

Det betyder Den lokala databasen kom inte upp, ofta efter en körning som inte avslutades ordentligt.

Gör så här Starta om datorn och starta appen igen. Upprepas det, skicka desktop-launcher.log och databasloggen till oss (se Loggar).

Start"The backend started, but this installation is missing the application files it serves"Betydelse: serverdelen har startat, men installationen saknar filerna för användargränssnittet.

Det betyder En del av programmappen saknas, oftast borttagen av antivirusprogrammet.

Gör så här Kontrollera antivirusprogrammets karantän och kör sedan installationsprogrammet igen över den befintliga installationen. Dina projekt rörs inte.

Start"The application backend did not start in time", eller "The application backend stopped responding while preparing the local database" (eller vid ett annat steg).

Det betyder Starten tog längre tid än appen väntar. Meddelandet anger vilket steg den var på.

Gör så här Stäng fönstret och starta om. Frigör först utrymme om disken är nästan full. Stannar den vid samma steg igen, skicka desktop-launcher.log till oss.

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

Det betyder I macOS och Linux packar appen upp sin backend vid varje start. En långsam eller full disk, eller ett antivirusprogram som låser filerna, hindrar det. (Windows-appen packar inte upp sig själv längre sedan 18.5.)

Gör så här Frigör utrymme på disken med din temporära mapp, eller tillåt appen i ditt antivirusprogram, och starta sedan om.

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

Det betyder Precis det. Meddelandet anger mappen och det lediga utrymmet som finns kvar.

Gör så här Frigör utrymme på den disken och starta om.

Under körning"The application backend stopped, restarting" och fönstret laddas om.

Det betyder Appens bakgrundsdel stannade oväntat och appen startade om den. Sparat arbete behålls. Det görs högst två gånger på 30 minuter.

Gör så här Fortsätt. Upprepas det, eller ser du "The application backend has stopped", skicka desktop-launcher.log och logs/backend-crash.log till oss.

StartVarje gång du startar appen blir du utloggad och språket är tillbaka på engelska.

Det betyder Ett annat program använder port 8732, den port appen normalt använder. Version 18.5.0 väljer då en slumpmässig ledig port vid varje start, och fönstret behandlar varje ny port som en ny webbplats, så inloggningen och språket hittas inte.

Gör så här Stäng eller konfigurera om det andra programmet som använder port 8732 (kör netstat -ano | findstr :8732 i en terminal i Windows för att se dess process-ID). Dina projekt påverkas inte, bara inloggningen och språkvalet.

StartDu oroar dig för att appen krockar med en PostgreSQL som du redan kör på port 5432.

Det betyder Det gör den inte. Den inbyggda databasen tar i Windows en slumpmässig ledig lokal port, och i macOS och Linux lyssnar den bara på en lokal socket, inte på en TCP-port.

Gör så här Inget att göra.

Installation"”OpenConstructionERP” är skadad och kan inte öppnas."

Det betyder Appen är inte notariserad av Apple än och har fortfarande nedladdningsmarkeringen. Appen är inte skadad.

Gör så här Bara det här hjälper: kör xattr -dr com.apple.quarantine /Applications/OpenConstructionERP.app en gång i Terminal och öppna sedan appen som vanligt.

Installation"”OpenConstructionERP” kan inte öppnas eftersom utvecklaren inte kan verifieras" (eller så kunde Apple inte kontrollera att den är fri från skadlig kod).

Det betyder Appen är ad hoc-signerad men inte notariserad av Apple än.

Gör så här Kör samma xattr-kommando, eller öppna Systeminställningar, Integritet och säkerhet, scrolla ned och klicka på Öppna ändå. Du gör det bara en gång.

InstallationAppen går inte att köra alls på din Mac.

Det betyder Mac-versionen är bara för Apple Silicon (M1 och senare). Det finns ingen Intel-version.

Gör så här På en Intel-Mac använder du pip (Python 3.12 eller senare) eller Docker.

Var loggarna finns

  • desktop-launcher.log~/.openestimate/desktop-launcher.logAllt skrivbordsappen gjorde under starten. Alltid i din hemmapp, även om du har flyttat datamappen.
  • backend-crash.log~/.openestimate/logs/backend-crash.logDetaljer om ett oväntat stopp. Ligger i datamappen och flyttar därför med OE_DATA_DIR.
  • database log folder~/.openestimate/pgdata/logVarför den inbyggda databasen inte startade.

För att öppna mappen från en terminal:

open ~/.openestimate

Linux

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

Innan du börjar 64-bitars x86 (amd64). Paketet behöver libwebkit2gtk-4.1-0, som apt installerar åt dig. Byggt på Ubuntu 22.04, så Ubuntu 22.04 eller senare och Debian 12 eller senare är det säkra valet.

  1. 1

    Ladda ned OpenConstructionERP_18.5.0_amd64.deb.

    Du serEn fil på cirka 830 MB.

  2. 2

    Kör i en terminal i nedladdningsmappen.

    sudo apt install ./OpenConstructionERP_18.5.0_amd64.deb

    Du serapt listar paketet och de bibliotek som behövs och installerar dem. ./ framför filnamnet är viktigt.

  3. 3

    Starta OpenConstructionERP från programmenyn.

    Du serLaddningsskärmen. Första starten tar en eller två minuter.

  4. 4

    Logga in med demokontot: e-post demo@openconstructionerp.com, lösenord DemoPass1234!. Därefter kan du skapa ditt eget konto och egna projekt.

    Du serAppen. Demoprojekten skapas i bakgrunden vid första starten, så projektlistan kan en kort stund säga att de är på väg.

  5. 5

    Vid en ny installation får administratören en gång frågan vilka moduler du ska använda. Kryssa i det du behöver och fortsätt. Du kan ändra det senare med knappen Bakgrundstjänster i översta fältet.

    Du serEn engångslista med moduler och det minne de behöver.

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

Innan du börjar 64-bitars x86. Paketet behöver biblioteket WebKitGTK 4.1, som pakethanteraren installerar åt dig.

  1. 1

    Ladda ned OpenConstructionERP-18.5.0-1.x86_64.rpm.

    Du serEn fil på cirka 850 MB.

  2. 2

    Kör.

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

    Du serdnf löser beroenden och installerar.

  3. 3

    Starta OpenConstructionERP från programmenyn.

    Du serLaddningsskärmen. Första starten tar en eller två minuter.

  4. 4

    Logga in med demokontot: e-post demo@openconstructionerp.com, lösenord DemoPass1234!. Därefter kan du skapa ditt eget konto och egna projekt.

    Du serAppen. Demoprojekten skapas i bakgrunden vid första starten, så projektlistan kan en kort stund säga att de är på väg.

  5. 5

    Vid en ny installation får administratören en gång frågan vilka moduler du ska använda. Kryssa i det du behöver och fortsätt. Du kan ändra det senare med knappen Bakgrundstjänster i översta fältet.

    Du serEn engångslista med moduler och det minne de behöver.

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

Innan du börjar 64-bitars x86 och biblioteket FUSE 2 (libfuse2; i Ubuntu 24.04 heter paketet libfuse2t64).

  1. 1

    Ladda ned OpenConstructionERP_18.5.0_amd64.AppImage.

    Du serEn fil på cirka 910 MB.

  2. 2

    Gör den körbar.

    chmod +x OpenConstructionERP_18.5.0_amd64.AppImage

    Du serIngen utdata.

  3. 3

    Kör den.

    ./OpenConstructionERP_18.5.0_amd64.AppImage

    Du serLaddningsskärmen. Första starten tar en eller två minuter.

  4. 4

    Logga in med demokontot: e-post demo@openconstructionerp.com, lösenord DemoPass1234!. Därefter kan du skapa ditt eget konto och egna projekt.

    Du serAppen. Demoprojekten skapas i bakgrunden vid första starten, så projektlistan kan en kort stund säga att de är på väg.

  5. 5

    Vid en ny installation får administratören en gång frågan vilka moduler du ska använda. Kryssa i det du behöver och fortsätt. Du kan ändra det senare med knappen Bakgrundstjänster i översta fältet.

    Du serEn engångslista med moduler och det minne de behöver.

Om du ser ett meddelande

StartLaddningsskärmen står kvar i en minut eller mer vid allra första starten.

Det betyder Appen skapar sin lokala databas. Det händer bara en gång.

Gör så här Vänta och stäng inte fönstret. På en långsam eller nästan full disk kan det ta längre tid. Senare starter går snabbt.

Start"The backend started, but the local database is not answering, so the app cannot open."Betydelse: serverdelen har startat, men dess lokala databas svarar inte, så appen kan inte öppnas.

Det betyder Den lokala databasen kom inte upp, ofta efter en körning som inte avslutades ordentligt.

Gör så här Starta om datorn och starta appen igen. Upprepas det, skicka desktop-launcher.log och databasloggen till oss (se Loggar).

Start"The backend started, but this installation is missing the application files it serves"Betydelse: serverdelen har startat, men installationen saknar filerna för användargränssnittet.

Det betyder En del av programmappen saknas, oftast borttagen av antivirusprogrammet.

Gör så här Kontrollera antivirusprogrammets karantän och kör sedan installationsprogrammet igen över den befintliga installationen. Dina projekt rörs inte.

Start"The application backend did not start in time", eller "The application backend stopped responding while preparing the local database" (eller vid ett annat steg).

Det betyder Starten tog längre tid än appen väntar. Meddelandet anger vilket steg den var på.

Gör så här Stäng fönstret och starta om. Frigör först utrymme om disken är nästan full. Stannar den vid samma steg igen, skicka desktop-launcher.log till oss.

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

Det betyder I macOS och Linux packar appen upp sin backend vid varje start. En långsam eller full disk, eller ett antivirusprogram som låser filerna, hindrar det. (Windows-appen packar inte upp sig själv längre sedan 18.5.)

Gör så här Frigör utrymme på disken med din temporära mapp, eller tillåt appen i ditt antivirusprogram, och starta sedan om.

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

Det betyder Precis det. Meddelandet anger mappen och det lediga utrymmet som finns kvar.

Gör så här Frigör utrymme på den disken och starta om.

Under körning"The application backend stopped, restarting" och fönstret laddas om.

Det betyder Appens bakgrundsdel stannade oväntat och appen startade om den. Sparat arbete behålls. Det görs högst två gånger på 30 minuter.

Gör så här Fortsätt. Upprepas det, eller ser du "The application backend has stopped", skicka desktop-launcher.log och logs/backend-crash.log till oss.

StartVarje gång du startar appen blir du utloggad och språket är tillbaka på engelska.

Det betyder Ett annat program använder port 8732, den port appen normalt använder. Version 18.5.0 väljer då en slumpmässig ledig port vid varje start, och fönstret behandlar varje ny port som en ny webbplats, så inloggningen och språket hittas inte.

Gör så här Stäng eller konfigurera om det andra programmet som använder port 8732 (kör netstat -ano | findstr :8732 i en terminal i Windows för att se dess process-ID). Dina projekt påverkas inte, bara inloggningen och språkvalet.

StartDu oroar dig för att appen krockar med en PostgreSQL som du redan kör på port 5432.

Det betyder Det gör den inte. Den inbyggda databasen tar i Windows en slumpmässig ledig lokal port, och i macOS och Linux lyssnar den bara på en lokal socket, inte på en TCP-port.

Gör så här Inget att göra.

Installation.deb-filen ber om libwebkit2gtk-4.1-0, eller dpkg rapporterar ouppfyllda beroenden.

Det betyder Appen behöver WebKitGTK 4.1 för att rita sitt fönster. dpkg -i installerar inte beroenden.

Gör så här Installera med sudo apt install ./OpenConstructionERP_18.5.0_amd64.deb, som tar med biblioteket. Saknar din distribution libwebkit2gtk-4.1-0 (Ubuntu äldre än 22.04, Debian äldre än 12), använd pip.

InstallationAppImage-filen gör ingenting när du dubbelklickar på den.

Det betyder Filen är inte markerad som program än.

Gör så här Kör chmod +x OpenConstructionERP_18.5.0_amd64.AppImage och starta den igen.

InstallationEtt AppImage-fel som nämner FUSE eller libfuse.so.2.

Det betyder Nyare distributioner installerar inte längre biblioteket FUSE 2 som AppImage-filer använder.

Gör så här Installera det (sudo apt install libfuse2, i Ubuntu 24.04 sudo apt install libfuse2t64), eller använd .deb, .rpm eller pip.

Var loggarna finns

  • desktop-launcher.log~/.openestimate/desktop-launcher.logAllt skrivbordsappen gjorde under starten. Alltid i din hemmapp, även om du har flyttat datamappen.
  • backend-crash.log~/.openestimate/logs/backend-crash.logDetaljer om ett oväntat stopp. Ligger i datamappen och flyttar därför med OE_DATA_DIR.
  • database log folder~/.openestimate/pgdata/logVarför den inbyggda databasen inte startade.

För att öppna mappen från en terminal:

xdg-open ~/.openestimate

pip

Paket openconstructionerp

Innan du börjar Python 3.12 eller senare. Kontrollera med python --version. Inget Docker och ingen separat databas: pip tar med en inbyggd PostgreSQL.

Titta på det här steget:
  1. 1

    Kör.

    pip install --upgrade openconstructionerp

    Du serpip hämtar paketet och dess beroenden.

  2. 2

    Kör.

    openconstructionerp

    Du serEn kort välkomsttext. Vid första körningen frågar den om demoprojekten ska laddas och om webbläsaren ska öppnas.

  3. 3

    Vänta medan den lokala databasen sätts upp.

    Du ser"Database: embedded PostgreSQL 16 (no Docker)" och sedan startar servern. Webbläsaren öppnar http://127.0.0.1:8080 (samma som http://localhost:8080).

  4. 4

    Logga in. Med demodata kan du använda demo@openconstructionerp.com / DemoPass1234!

    Du serÖversikten.

  5. 5

    Vid en ny installation får administratören en gång frågan vilka moduler du ska använda. Kryssa i det du behöver och fortsätt. Du kan ändra det senare med knappen Bakgrundstjänster i översta fältet.

    Du serEn engångslista med moduler och det minne de behöver.

  6. 6

    För att stoppa, tryck Ctrl+C i terminalen. Nästa gång kör du bara openconstructionerp igen.

    Du serServern stannar. Dina data ligger kvar i mappen .openestimate i din hemmapp.

Användbara kommandon

Kommandot openconstructionerp hittas inte

python -m openconstructionerp

Något fungerar inte: kontrollerar Python, porten, datamappen och databasen och säger vad du ska göra

openconstructionerp doctor

Port 8080 används av ett annat program

openconstructionerp serve --port 8081

Andra datorer i ditt nätverk ska nå den

openconstructionerp serve --host 0.0.0.0 --port 8080

Du måste berätta vilken version du har

openconstructionerp --version

Om du ser ett meddelande

Installationpip säger att ingen matchande distribution hittades, eller att en annan Python krävs.

Det betyder OpenConstructionERP kräver Python 3.12 eller senare.

Gör så här Installera Python 3.12 eller senare och kör python3.12 -m pip install --upgrade openconstructionerp (i Windows: py -3.12 -m pip install --upgrade openconstructionerp).

Installationerror: externally-managed-environment (Ubuntu 23.04+, Debian 12+).Betydelse: ditt Linux-system skyddar sin egen Python och vägrar installera paket i den.

Det betyder Systemets Python tillåter inte att pip installerar i den.

Gör så här Använd pipx install openconstructionerp, eller skapa först en virtuell miljö: python3 -m venv ~/oe && ~/oe/bin/pip install openconstructionerp.

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

Det betyder Mappen där pip lägger kommandon finns inte i din PATH (vanligt i Windows).

Gör så här Kör python -m openconstructionerp i stället. Det fungerar på alla system utan att röra PATH.

Start"Port 8080 is already in use. Try: openconstructionerp serve --port 8081"Betydelse: ett annat program använder redan port 8080, så starta appen på en annan port, till exempel 8081.

Det betyder Ett annat program använder port 8080.

Gör så här Kör det föreslagna kommandot och öppna adressen det skriver ut.

Start"Embedded PostgreSQL could not start".Betydelse: den inbyggda PostgreSQL-databasen kunde inte starta.

Det betyder Den inbyggda databasen kunde inte starta. Meddelandet skriver ut sökvägen till dess logg.

Gör så här Kör openconstructionerp doctor. Hjälper inte det, installera om med pip install --upgrade --force-reinstall openconstructionerp och skicka loggen som anges till oss.

Var loggarna finns

  • terminal outputthe terminal window (pip); docker compose logs app (Docker)För pip och Docker, kopiera det terminalen skrev ut och utdata från openconstructionerp doctor.

Docker

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

Innan du börjar Docker med Docker Compose. Den publicerade avbilden är byggd för x86-64 (amd64). På Apple Silicon eller andra ARM-maskiner, bygg från källkod (make quickstart) eller använd pip. Kommandona nedan är för ett bash-skal (Linux, macOS, eller Git Bash eller WSL i Windows). Windows PowerShell saknar openssl och skriver filer i ett format som compose inte kan läsa.

  1. 1

    Ladda ned de två compose-filerna i en tom mapp.

    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

    Du serTvå filer i mappen.

  2. 2

    Skapa hemlighetsfilen en gång.

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

    Du serEn fil .env. Spara den: den innehåller databaslösenordet och inloggningshemligheten.

  3. 3

    Starta den.

    docker compose pull app && docker compose up -d

    Du serTvå containrar startar: postgres och app.

  4. 4

    Öppna http://localhost:8080 och logga in med demo@openconstructionerp.com / DemoPass1234!

    Du serInloggningssidan. Första starten kan ta en minut medan databasen förbereds.

  5. 5

    Vid en ny installation får administratören en gång frågan vilka moduler du ska använda. Kryssa i det du behöver och fortsätt. Du kan ändra det senare med knappen Bakgrundstjänster i översta fältet.

    Du serEn engångslista med moduler och det minne de behöver.

Användbara kommandon

Kontrollera att båda containrarna körs och mår bra

docker compose ps

Se varför appen inte startar

docker compose logs app

Port 8080 på din dator används

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

Den här compose-konfigurationen är för utvärdering och lokal användning. För en produktionsserver, se docs/INSTALL_LINUX.md och docker-compose.prod.yml i repot.

Om du ser ett meddelande

StartCompose stannar med "POSTGRES_PASSWORD must be set" eller "JWT_SECRET must be set".

Det betyder Filen .env med de två hemligheterna saknas eller ligger inte i samma mapp.

Gör så här Skapa filen .env som i steg 2, i mappen med docker-compose.yml.

Starthttp://localhost:8080 öppnas inte.

Det betyder Containern körs inte än, eller port 8080 används.

Gör så här Kör docker compose ps och docker compose logs app. För att använda en annan port: OE_PORT=8081 OE_ALLOWED_ORIGINS=http://localhost:8081 docker compose up -d, och öppna sedan http://localhost:8081.

InstallationPå en Mac med Apple Silicon eller en annan ARM-maskin varnar Docker för att avbildens plattform linux/amd64 inte stämmer, eller så går appen mycket långsamt.

Det betyder Den publicerade avbilden är bara byggd för x86-64.

Gör så här Bygg från källkod med make quickstart, eller använd pip.

Var loggarna finns

  • terminal outputthe terminal window (pip); docker compose logs app (Docker)För pip och Docker, kopiera det terminalen skrev ut och utdata från openconstructionerp doctor.

Dina data, uppgraderingar och avinstallation

Uppgradering

Installera den nya versionen över den gamla. Din mapp .openestimate ingår inte i programmet, så projekt, användare och inställningar finns kvar. Första starten efter en uppgradering kan ta längre tid medan databasen uppdaterar sig själv.

Avinstallation

Avinstallation tar bort programmet och behåller dina projekt. I Windows erbjuder avinstallationsprogrammet "Delete the application data" (på installationsprogrammets språk): det tar bara bort inloggningen och språket som appfönstret sparat (i %APPDATA% och %LOCALAPPDATA%\io.openconstructionerp.desktop), inte dina projekt. För att börja om från noll, avinstallera, kopiera .openestimate till en säker plats och radera den sedan.

Säkerhetskopia

Stäng appen och kopiera mappen .openestimate (och ProgramData-mappen som anges i pgdata.location, om det finns en).

Kör fast fortfarande? Vi hjälper dig

Ta med:

GitHub Issues GitHub Discussions info@datadrivenconstruction.io

Loggfiler kan innehålla ditt användarnamn och mappnamn. Titta igenom dem innan du lägger ut dem offentligt; skicka dem gärna med e-post i stället.

Nästa steg efter installationen

Installerat och inloggad? Titta på de här videorna i ordning. Varje video är kort och visar den riktiga appen.

  1. Första stegen efter installationen

    Andra halvan av installationsvideon: första start, språk och region, moduler, användare, ditt första projekt.

  2. Se hela produkten

    Också användbart

    Produktrundtur: BOQ, BIM, DWG, PDF-takeoff och AI-kalkylering

    12:01 minuter, inspelad med en tidigare version. Visar också en pip-installation.

    Kort rundtur, 2:37: en byggnad, en källa till sanning

  3. Grunderna i kalkylering

    Builder's Playbook: Getting Started3 videorBörja här: kostnadsdatabas och enhetspriser, en kalkyl steg för steg, indirekta kostnader, vinst och oförutsett (USA).

  4. Din marknad, från början till slut

    Builder's Playbook UK: Construction in England6 videor · ENKommersiell styrning i Storbritannien: anbudskalkyl enligt NRM 2, anbudsjämförelse, JCT-betalningar och innehållen betalning, pay less notices, CIS och omvänd skattskyldighet för moms, ändringar.Builder's Playbook: Canada6 videor · ENKanada/Ontario: prissättning, upphandling av underentreprenörer, CCDC 2 delbetalningar, snabb betalning (prompt payment), ändringsorder, väsentlig färdigställande.Builder's Playbook: Québec5 videor · FRQuébec på franska: komma igång, kalkylering, BSDQ-upphandlingar, fakturering med innehållen betalning och lagstadgad panträtt, godkännande och brister.OpenConstructionERP auf Deutsch: vom Projektstart bis zur Übergabe8 videor · DETysk serie från projektuppsättning via ritningar/RFI, mängder, BIM-kontroller, LV, enhetspriser och GAEB X83/X84 till tilldelning (numrerad /12, 8 publicerade).Builder's Playbook Hrvatska: gradnja u Hrvatskoj5 videor · HRKroatien: import av kontrakts-BOQ från Excel, inkommande fakturor, underentreprenörer, delfakturor, ekonomisk status och tilläggsarbeten.

  5. Driva byggplatsen: budget, inköp, timmar, fakturor

    OpenConstructionERP en français: gérer un chantier4 videor · FRByggplatsledning på franska: budget, inköp och lager, timmar och maskiner, fakturor och betalningar.

Alla spellistor på OpenConstruction Academy-kanalen

Hela texten finns också på GitHub på English, Deutsch och Русский.