Installasjonshjelp
Installer OpenConstructionERP
Velg hvordan du vil kjøre det, følg de nummererte trinnene, og hvis noe ser feil ut, finn meldingen du ser i problemlisten lenger ned. Ingen av advarslene under installasjonen setter prosjektene dine i fare.
Usikker på hvilken du trenger?
- Du bruker Windows 10 eller 11Windows-installasjonsprogram (.exe)
- Du har en Mac med M1-, M2-, M3- eller M4-brikkemacOS (.dmg, Apple Silicon)
- Du har en Intel-Macpip eller Docker (det finnes ingen app for Intel-Mac)
- Du bruker Ubuntu, Debian eller Linux MintLinux .deb
- Du bruker Fedora, RHEL eller Rocky LinuxLinux .rpm
- Du bruker en annen Linux-distribusjonLinux AppImage
- Du har allerede Python 3.12 eller nyere, eller du vil ha det på en serverpip
- Du kjører Docker, eller du setter det opp for et teamDocker
Se dette først
Slik installerer du OpenConstructionERP
Videoguide på Windows, tatt opp med versjon 17.7.1. Noen skjermbilder ser annerledes ut i 18.5, og ventetiden under installasjonen er kortet ned i videoen.
Windows
- 1
Last ned
OpenConstructionERP_18.5.0_x64-setup.exefra utgivelsessiden.Du serEn fil på ca. 800 MB i Nedlastinger-mappen.
- 2
Dobbeltklikk på den. Hvis et blått vindu sier "Windows beskyttet PC-en", klikk på Mer informasjon ("More info"), sjekk at filnavnet starter med OpenConstructionERP, og klikk deretter på Kjør likevel ("Run anyway").
Du serWindows ber om administratortillatelse. Klikk på Ja.
- 3
Velg språk for installasjonsprogrammet, godta lisensen og behold den foreslåtte mappen
C:\Program Files\OpenConstructionERP.Du serEn fremdriftslinje og deretter en avslutningsside.
- 4
Klikk på Fullfør, eller start OpenConstructionERP fra Start-menyen.
Du serEn innlastingsskjerm "Starter programmet" med en sjekkliste: starter backend, starter den lokale databasen, forbereder databasen, starter applikasjonsserveren, åpner appen.
- 5
Vent ved aller første oppstart. Ikke lukk vinduet.
Du ser"Første gangs oppstart setter opp den lokale databasen. Det kan ta ett eller to minutter, vent litt." Senere oppstarter er mye raskere.
- 6
Velg hvordan den skal åpnes: som et appvindu (anbefalt) eller i den vanlige nettleseren din.
Du ser"Hvordan vil du åpne OpenConstructionERP?" og deretter innloggingssiden.
- 7
Logg inn med demokontoen: e-post demo@openconstructionerp.com, passord DemoPass1234!. Etterpå kan du opprette din egen konto og egne prosjekter.
Du serAppen. Demoprosjektene opprettes i bakgrunnen ved første oppstart, så prosjektlisten kan et lite øyeblikk si at de er på vei.
- 8
Ved en ny installasjon blir administratoren spurt én gang om hvilke moduler du skal bruke. Kryss av for det du trenger, og fortsett. Du kan endre det senere med knappen Bakgrunnstjenester i øverste linje.
Du serEn engangsliste over moduler med minnet de trenger.
Hvis du ser en melding
InstallasjonEt blått vindu "Windows beskyttet PC-en".
Det betyr Installasjonsprogrammet er ikke kodesignert ennå, så Windows kjenner ikke utgiveren. Det er en advarsel, ikke et virusfunn.
Gjør dette Klikk på Mer informasjon ("More info"), sjekk at filnavnet starter med OpenConstructionERP, og klikk deretter på Kjør likevel ("Run anyway").
InstallasjonSmart App Control blokkerte appen, uten knapp for å fortsette.
Det betyr Smart App Control i Windows 11 avviser usignerte programmer.
Gjør dette Smart App Control kan ikke tillate én enkelt app. Hvis du vil ha den slått på, kjør OpenConstructionERP med Docker Desktop eller i WSL (Windows' innebygde Linux), som Smart App Control ikke sjekker. Trinn-for-trinn-veiledning: docs/desktop/WINDOWS_BLOCKED.md i repositoriet.
Installasjon"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" (meldingen finnes bare på engelsk)Betydning: stien til installasjonsmappen kan bare inneholde latinske bokstaver, tall og mellomrom, fordi den innebygde databasen ikke kan starte fra noen annen sti.
Det betyr Mappen du valgte har kyrilliske, kinesiske, aksentuerte eller andre ikke-latinske tegn i stien.
Gjør dette Behold den foreslåtte mappen C:\Program Files\OpenConstructionERP, eller velg en mappe som C:\OpenConstructionERP. En stille installasjon (/S) avslutter med kode 3 og skriver årsaken til %TEMP%\OpenConstructionERP-install-error.log.
InstallasjonInstallasjonsprogrammet stopper med en feil om WebView2.
Det betyr Windows nektet å installere Microsoft WebView2, komponenten som tegner appvinduet. Den ligger i installasjonsprogrammet, så du trenger ikke internett; feilen kommer fra Windows selv (policy, en ventende oppdatering eller en skadet tidligere WebView2).
Gjør dette Start datamaskinen på nytt og kjør installasjonsprogrammet igjen. Feiler det igjen, installer "Microsoft Edge WebView2 Runtime" fra Microsoft og kjør deretter installasjonsprogrammet vårt en gang til.
InstallasjonAntivirusprogrammet ditt sletter eller setter en fil i karantene under installasjonen eller ved første oppstart.
Det betyr Programmet er nytt og usignert, og noen antivirusprogrammer er mistenksomme overfor det.
Gjør dette Gjenopprett filen fra karantenen og legg til disse to mappene som unntak: programmappen C:\Program Files\OpenConstructionERP og datamappen din C:\Users\<your name>\.openestimate. Kjør deretter installasjonsprogrammet igjen over den eksisterende installasjonen. Er du ikke sikker på at filen er ekte, skriv til oss først.
OppgraderingEn skjerm som spør om den installerte versjonen skal overskrives eller fjernes først, med en linje som foreslår å fjerne den.
Gjør dette Behold alternativet som allerede er valgt (overskriv). Prosjektene dine beholdes. Første oppstart etter en oppgradering kan ta lengre tid mens databasen oppdaterer seg selv.
OppgraderingDu kjører også OpenConstructionERP via pip eller i en terminal på samme datamaskin, og det stopper under oppgraderingen.
Det betyr Begge bruker samme mappe .openestimate og samme database. Installasjonsprogrammet stopper databasen for å bytte ut programmet. Ved oppgradering fra 18.4.0 lukker det gamle avinstallasjonsprogrammet også alle programmer som heter openconstructionerp.exe.
Gjør dette Stopp terminalversjonen (Ctrl+C) før du installerer eller oppgraderer, og start den igjen etterpå.
OppstartInnlastingsskjermen blir stående i et minutt eller mer ved aller første oppstart.
Det betyr Appen oppretter sin lokale database. Dette skjer bare én gang.
Gjør dette Vent, og ikke lukk vinduet. På en treg eller nesten full disk kan det ta lengre tid. Senere oppstarter går raskt.
OppstartEn boks "OpenConstructionERP failed to start" som nevner en loggfil.
Det betyr Appen kunne ikke åpne vinduet sitt i det hele tatt.
Gjør dette Start den én gang til. Kommer boksen tilbake, send oss loggfilen den nevner.
Oppstart"The backend started, but the local database is not answering, so the app cannot open."Betydning: serverdelen har startet, men den lokale databasen svarer ikke, så appen kan ikke åpnes.
Det betyr Den lokale databasen kom ikke opp, ofte etter en kjøring som ikke ble avsluttet ordentlig.
Gjør dette Start datamaskinen på nytt og start appen igjen. Gjentar det seg, send oss desktop-launcher.log og databaseloggen (se Logger).
Oppstart"The backend started, but this installation is missing the application files it serves"Betydning: serverdelen har startet, men installasjonen mangler filene til brukergrensesnittet.
Det betyr En del av programmappen mangler, vanligvis fjernet av antivirusprogrammet.
Gjør dette Sjekk karantenen til antivirusprogrammet, og kjør deretter installasjonsprogrammet igjen over den eksisterende installasjonen. Prosjektene dine blir ikke rørt.
Oppstart"The application backend did not start in time" eller "The application backend stopped responding while preparing the local database" (eller ved et annet trinn).
Det betyr Oppstarten tok lengre tid enn appen venter. Meldingen nevner trinnet den var på.
Gjør dette Lukk vinduet og start på nytt. Frigjør plass først hvis disken er nesten full. Stopper den ved samme trinn igjen, send oss desktop-launcher.log.
Oppstart"The drive ran out of space while the application was starting" eller "There is not enough free space to start the application".
Det betyr Akkurat det. Meldingen nevner mappen og hvor mye ledig plass som er igjen.
Gjør dette Frigjør plass på den stasjonen og start på nytt.
OppstartEn melding om at mappen for den lokale databasen "sits too deep in the filesystem", med to tall.
Det betyr Windows begrenser stilengden, og stien til datamappen din er for lang for databasefilene. Å slå på lange stier i Windows hjelper ikke.
Gjør dette Sett brukerens miljøvariabel OE_DATA_DIR til en kort sti som C:\OpenConstructionERP\data (Start, skriv "miljøvariabler", Rediger miljøvariabler for kontoen din, Ny), og start deretter på nytt.
OppstartWindows-brukernavnet ditt har ikke-latinske tegn (for eksempel kyrilliske eller kinesiske), og du leter etter databasen din.
Det betyr Den innebygde databasen kan ikke kjøre fra en slik sti, så siden 18.5.0 legger appen databasen i C:\ProgramData\OpenConstructionERP\clusters\<id>\pgdata. Før 18.5.0 kunne ikke appen starte i det hele tatt for slike kontoer.
Gjør dette Ingenting å rette. Filen pgdata.location i mappen din .openestimate oppgir den nøyaktige databasemappen. For sikkerhetskopier, kopier begge mappene.
Under kjøring"The application backend stopped, restarting", og vinduet lastes på nytt.
Det betyr Bakgrunnsdelen av appen stoppet uventet, og appen startet den på nytt. Lagret arbeid beholdes. Dette skjer høyst to ganger på 30 minutter.
Gjør dette Fortsett som vanlig. Gjentar det seg, eller ser du "The application backend has stopped", send oss desktop-launcher.log og logs/backend-crash.log.
OppstartHver gang du starter appen, blir du logget ut, og språket er tilbake til engelsk.
Det betyr Et annet program bruker port 8732, porten appen vanligvis bruker. Versjon 18.5.0 velger da en tilfeldig ledig port ved hver oppstart, og vinduet behandler hver nye port som et nytt nettsted, så innloggingen og språket blir ikke funnet.
Gjør dette Lukk eller omkonfigurer det andre programmet som bruker port 8732 (i Windows kan du kjøre netstat -ano | findstr :8732 i en terminal for å se prosess-ID-en). Prosjektene dine påvirkes ikke, bare innloggingen og språkvalget.
OppstartDu er redd for at appen kolliderer med en PostgreSQL du allerede kjører på port 5432.
Det betyr Det gjør den ikke. Den innebygde databasen tar i Windows en tilfeldig ledig lokal port, og i macOS og Linux lytter den bare på en lokal socket, ikke på en TCP-port.
Gjør dette Ingenting å gjøre.
Hvor loggene ligger
desktop-launcher.logC:\Users\<your name>\.openestimate\desktop-launcher.logAlt skrivebordsappen gjorde under oppstarten. Alltid i hjemmemappen din, selv om du har flyttet datamappen.backend-crash.logC:\Users\<your name>\.openestimate\logs\backend-crash.logDetaljer om et uventet stopp. Ligger i datamappen og flytter derfor medOE_DATA_DIR.database log folderC:\Users\<your name>\.openestimate\pgdata\log (or <folder frompgdata.location>\log)Hvorfor den innebygde databasen ikke startet.OpenConstructionERP-install-error.log%TEMP%\OpenConstructionERP-install-error.log(skriv%TEMP%i adressefeltet i Utforsker)Hvorfor Windows-installasjonsprogrammet avviste installasjonsmappen.
For å åpne mappen, lim inn dette i adressefeltet i Filutforsker:
%USERPROFILE%\.openestimatemacOS
- 1
Last ned
OpenConstructionERP_18.5.0_aarch64.dmgog åpne den.Du serEt vindu med appikonet til OpenConstructionERP.
- 2
Dra OpenConstructionERP til Programmer.
Du serAppen vises i Programmer-mappen.
- 3
Åpne Terminal én gang og kjør.
xattr -dr com.apple.quarantine /Applications/OpenConstructionERP.appDu serIngen utdata. Det er riktig. Dette fjerner nedlastingsmerket, fordi appen ennå ikke er notarisert av Apple.
- 4
Åpne OpenConstructionERP fra Programmer.
Du serInnlastingsskjermen "Starter programmet". Første oppstart setter opp den lokale databasen og tar ett eller to minutter.
- 5
Velg appvindu eller nettleser.
Du serInnloggingssiden.
- 6
Logg inn med demokontoen: e-post demo@openconstructionerp.com, passord DemoPass1234!. Etterpå kan du opprette din egen konto og egne prosjekter.
Du serAppen. Demoprosjektene opprettes i bakgrunnen ved første oppstart, så prosjektlisten kan et lite øyeblikk si at de er på vei.
- 7
Ved en ny installasjon blir administratoren spurt én gang om hvilke moduler du skal bruke. Kryss av for det du trenger, og fortsett. Du kan endre det senere med knappen Bakgrunnstjenester i øverste linje.
Du serEn engangsliste over moduler med minnet de trenger.
Hvis du ser en melding
OppstartInnlastingsskjermen blir stående i et minutt eller mer ved aller første oppstart.
Det betyr Appen oppretter sin lokale database. Dette skjer bare én gang.
Gjør dette Vent, og ikke lukk vinduet. På en treg eller nesten full disk kan det ta lengre tid. Senere oppstarter går raskt.
Oppstart"The backend started, but the local database is not answering, so the app cannot open."Betydning: serverdelen har startet, men den lokale databasen svarer ikke, så appen kan ikke åpnes.
Det betyr Den lokale databasen kom ikke opp, ofte etter en kjøring som ikke ble avsluttet ordentlig.
Gjør dette Start datamaskinen på nytt og start appen igjen. Gjentar det seg, send oss desktop-launcher.log og databaseloggen (se Logger).
Oppstart"The backend started, but this installation is missing the application files it serves"Betydning: serverdelen har startet, men installasjonen mangler filene til brukergrensesnittet.
Det betyr En del av programmappen mangler, vanligvis fjernet av antivirusprogrammet.
Gjør dette Sjekk karantenen til antivirusprogrammet, og kjør deretter installasjonsprogrammet igjen over den eksisterende installasjonen. Prosjektene dine blir ikke rørt.
Oppstart"The application backend did not start in time" eller "The application backend stopped responding while preparing the local database" (eller ved et annet trinn).
Det betyr Oppstarten tok lengre tid enn appen venter. Meldingen nevner trinnet den var på.
Gjør dette Lukk vinduet og start på nytt. Frigjør plass først hvis disken er nesten full. Stopper den ved samme trinn igjen, send oss desktop-launcher.log.
Oppstart"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 betyr I macOS og Linux pakker appen ut backend ved hver oppstart. En treg eller full disk, eller et antivirusprogram som låser filene, hindrer det. (Windows-appen pakker ikke lenger ut seg selv siden 18.5.)
Gjør dette Frigjør plass på stasjonen med den midlertidige mappen din, eller tillat appen i antivirusprogrammet, og start deretter på nytt.
Oppstart"The drive ran out of space while the application was starting" eller "There is not enough free space to start the application".
Det betyr Akkurat det. Meldingen nevner mappen og hvor mye ledig plass som er igjen.
Gjør dette Frigjør plass på den stasjonen og start på nytt.
Under kjøring"The application backend stopped, restarting", og vinduet lastes på nytt.
Det betyr Bakgrunnsdelen av appen stoppet uventet, og appen startet den på nytt. Lagret arbeid beholdes. Dette skjer høyst to ganger på 30 minutter.
Gjør dette Fortsett som vanlig. Gjentar det seg, eller ser du "The application backend has stopped", send oss desktop-launcher.log og logs/backend-crash.log.
OppstartHver gang du starter appen, blir du logget ut, og språket er tilbake til engelsk.
Det betyr Et annet program bruker port 8732, porten appen vanligvis bruker. Versjon 18.5.0 velger da en tilfeldig ledig port ved hver oppstart, og vinduet behandler hver nye port som et nytt nettsted, så innloggingen og språket blir ikke funnet.
Gjør dette Lukk eller omkonfigurer det andre programmet som bruker port 8732 (i Windows kan du kjøre netstat -ano | findstr :8732 i en terminal for å se prosess-ID-en). Prosjektene dine påvirkes ikke, bare innloggingen og språkvalget.
OppstartDu er redd for at appen kolliderer med en PostgreSQL du allerede kjører på port 5432.
Det betyr Det gjør den ikke. Den innebygde databasen tar i Windows en tilfeldig ledig lokal port, og i macOS og Linux lytter den bare på en lokal socket, ikke på en TCP-port.
Gjør dette Ingenting å gjøre.
Installasjon"«OpenConstructionERP» er skadet og kan ikke åpnes." (teksten kan stå på ditt eget språk)
Det betyr Appen er ennå ikke notarisert av Apple og har fortsatt nedlastingsmerket. Appen er ikke skadet.
Gjør dette Bare dette hjelper: kjør xattr -dr com.apple.quarantine /Applications/OpenConstructionERP.app én gang i Terminal, og åpne deretter appen som vanlig.
Installasjon"«OpenConstructionERP» kan ikke åpnes fordi utvikleren ikke kan verifiseres" (eller Apple kunne ikke kontrollere at den er fri for skadelig programvare; teksten kan stå på ditt eget språk).
Det betyr Appen er signert ad hoc, men ennå ikke notarisert av Apple.
Gjør dette Kjør den samme xattr-kommandoen, eller åpne Systeminnstillinger, Personvern og sikkerhet ("Privacy & Security"), rull ned og klikk på Åpne likevel ("Open Anyway"). Du gjør dette bare én gang.
InstallasjonAppen kjører ikke i det hele tatt på Macen din.
Det betyr Mac-versjonen er bare for Apple Silicon (M1 og nyere). Det finnes ingen Intel-versjon.
Gjør dette På en Intel-Mac bruker du pip (Python 3.12 eller nyere) eller Docker.
Hvor loggene ligger
desktop-launcher.log~/.openestimate/desktop-launcher.logAlt skrivebordsappen gjorde under oppstarten. Alltid i hjemmemappen din, selv om du har flyttet datamappen.backend-crash.log~/.openestimate/logs/backend-crash.logDetaljer om et uventet stopp. Ligger i datamappen og flytter derfor medOE_DATA_DIR.database log folder~/.openestimate/pgdata/logHvorfor den innebygde databasen ikke startet.
For å åpne mappen fra en terminal:
open ~/.openestimateLinux
Linux: .deb (Ubuntu, Debian, Mint)
- 1
Last ned
OpenConstructionERP_18.5.0_amd64.deb.Du serEn fil på ca. 830 MB.
- 2
Kjør i en terminal i nedlastingsmappen.
sudo apt install ./OpenConstructionERP_18.5.0_amd64.debDu serapt viser pakken og bibliotekene den trenger, og installerer dem. ./ foran filnavnet er viktig.
- 3
Start OpenConstructionERP fra programmenyen.
Du serInnlastingsskjermen. Første oppstart tar ett eller to minutter.
- 4
Logg inn med demokontoen: e-post demo@openconstructionerp.com, passord DemoPass1234!. Etterpå kan du opprette din egen konto og egne prosjekter.
Du serAppen. Demoprosjektene opprettes i bakgrunnen ved første oppstart, så prosjektlisten kan et lite øyeblikk si at de er på vei.
- 5
Ved en ny installasjon blir administratoren spurt én gang om hvilke moduler du skal bruke. Kryss av for det du trenger, og fortsett. Du kan endre det senere med knappen Bakgrunnstjenester i øverste linje.
Du serEn engangsliste over moduler med minnet de trenger.
Linux: .rpm (Fedora, RHEL, Rocky)
- 1
Last ned
OpenConstructionERP-18.5.0-1.x86_64.rpm.Du serEn fil på ca. 850 MB.
- 2
Kjør.
sudo dnf install ./OpenConstructionERP-18.5.0-1.x86_64.rpmDu serdnf løser avhengigheter og installerer.
- 3
Start OpenConstructionERP fra programmenyen.
Du serInnlastingsskjermen. Første oppstart tar ett eller to minutter.
- 4
Logg inn med demokontoen: e-post demo@openconstructionerp.com, passord DemoPass1234!. Etterpå kan du opprette din egen konto og egne prosjekter.
Du serAppen. Demoprosjektene opprettes i bakgrunnen ved første oppstart, så prosjektlisten kan et lite øyeblikk si at de er på vei.
- 5
Ved en ny installasjon blir administratoren spurt én gang om hvilke moduler du skal bruke. Kryss av for det du trenger, og fortsett. Du kan endre det senere med knappen Bakgrunnstjenester i øverste linje.
Du serEn engangsliste over moduler med minnet de trenger.
Linux: AppImage (any distribution)
- 1
Last ned
OpenConstructionERP_18.5.0_amd64.AppImage.Du serEn fil på ca. 910 MB.
- 2
Gjør den kjørbar.
chmod +x OpenConstructionERP_18.5.0_amd64.AppImageDu serIngen utdata.
- 3
Kjør den.
./OpenConstructionERP_18.5.0_amd64.AppImageDu serInnlastingsskjermen. Første oppstart tar ett eller to minutter.
- 4
Logg inn med demokontoen: e-post demo@openconstructionerp.com, passord DemoPass1234!. Etterpå kan du opprette din egen konto og egne prosjekter.
Du serAppen. Demoprosjektene opprettes i bakgrunnen ved første oppstart, så prosjektlisten kan et lite øyeblikk si at de er på vei.
- 5
Ved en ny installasjon blir administratoren spurt én gang om hvilke moduler du skal bruke. Kryss av for det du trenger, og fortsett. Du kan endre det senere med knappen Bakgrunnstjenester i øverste linje.
Du serEn engangsliste over moduler med minnet de trenger.
Hvis du ser en melding
OppstartInnlastingsskjermen blir stående i et minutt eller mer ved aller første oppstart.
Det betyr Appen oppretter sin lokale database. Dette skjer bare én gang.
Gjør dette Vent, og ikke lukk vinduet. På en treg eller nesten full disk kan det ta lengre tid. Senere oppstarter går raskt.
Oppstart"The backend started, but the local database is not answering, so the app cannot open."Betydning: serverdelen har startet, men den lokale databasen svarer ikke, så appen kan ikke åpnes.
Det betyr Den lokale databasen kom ikke opp, ofte etter en kjøring som ikke ble avsluttet ordentlig.
Gjør dette Start datamaskinen på nytt og start appen igjen. Gjentar det seg, send oss desktop-launcher.log og databaseloggen (se Logger).
Oppstart"The backend started, but this installation is missing the application files it serves"Betydning: serverdelen har startet, men installasjonen mangler filene til brukergrensesnittet.
Det betyr En del av programmappen mangler, vanligvis fjernet av antivirusprogrammet.
Gjør dette Sjekk karantenen til antivirusprogrammet, og kjør deretter installasjonsprogrammet igjen over den eksisterende installasjonen. Prosjektene dine blir ikke rørt.
Oppstart"The application backend did not start in time" eller "The application backend stopped responding while preparing the local database" (eller ved et annet trinn).
Det betyr Oppstarten tok lengre tid enn appen venter. Meldingen nevner trinnet den var på.
Gjør dette Lukk vinduet og start på nytt. Frigjør plass først hvis disken er nesten full. Stopper den ved samme trinn igjen, send oss desktop-launcher.log.
Oppstart"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 betyr I macOS og Linux pakker appen ut backend ved hver oppstart. En treg eller full disk, eller et antivirusprogram som låser filene, hindrer det. (Windows-appen pakker ikke lenger ut seg selv siden 18.5.)
Gjør dette Frigjør plass på stasjonen med den midlertidige mappen din, eller tillat appen i antivirusprogrammet, og start deretter på nytt.
Oppstart"The drive ran out of space while the application was starting" eller "There is not enough free space to start the application".
Det betyr Akkurat det. Meldingen nevner mappen og hvor mye ledig plass som er igjen.
Gjør dette Frigjør plass på den stasjonen og start på nytt.
Under kjøring"The application backend stopped, restarting", og vinduet lastes på nytt.
Det betyr Bakgrunnsdelen av appen stoppet uventet, og appen startet den på nytt. Lagret arbeid beholdes. Dette skjer høyst to ganger på 30 minutter.
Gjør dette Fortsett som vanlig. Gjentar det seg, eller ser du "The application backend has stopped", send oss desktop-launcher.log og logs/backend-crash.log.
OppstartHver gang du starter appen, blir du logget ut, og språket er tilbake til engelsk.
Det betyr Et annet program bruker port 8732, porten appen vanligvis bruker. Versjon 18.5.0 velger da en tilfeldig ledig port ved hver oppstart, og vinduet behandler hver nye port som et nytt nettsted, så innloggingen og språket blir ikke funnet.
Gjør dette Lukk eller omkonfigurer det andre programmet som bruker port 8732 (i Windows kan du kjøre netstat -ano | findstr :8732 i en terminal for å se prosess-ID-en). Prosjektene dine påvirkes ikke, bare innloggingen og språkvalget.
OppstartDu er redd for at appen kolliderer med en PostgreSQL du allerede kjører på port 5432.
Det betyr Det gjør den ikke. Den innebygde databasen tar i Windows en tilfeldig ledig lokal port, og i macOS og Linux lytter den bare på en lokal socket, ikke på en TCP-port.
Gjør dette Ingenting å gjøre.
Installasjon.deb-filen ber om libwebkit2gtk-4.1-0, eller dpkg melder uoppfylte avhengigheter.
Det betyr Appen trenger WebKitGTK 4.1 for å tegne vinduet sitt. dpkg -i installerer ikke avhengigheter.
Gjør dette Installer med sudo apt install ./OpenConstructionERP_18.5.0_amd64.deb, som henter med biblioteket. Har ikke distribusjonen din libwebkit2gtk-4.1-0 (Ubuntu eldre enn 22.04, Debian eldre enn 12), bruk pip.
InstallasjonAppImage-filen gjør ingenting når du dobbeltklikker på den.
Det betyr Filen er ennå ikke merket som et program.
Gjør dette Kjør chmod +x OpenConstructionERP_18.5.0_amd64.AppImage og start den igjen.
InstallasjonEn AppImage-feil som nevner FUSE eller libfuse.so.2.
Det betyr Nyere distribusjoner installerer ikke lenger biblioteket FUSE 2 som AppImage-filer bruker.
Gjør dette Installer det (sudo apt install libfuse2, i Ubuntu 24.04 sudo apt install libfuse2t64), eller bruk .deb, .rpm eller pip.
Hvor loggene ligger
desktop-launcher.log~/.openestimate/desktop-launcher.logAlt skrivebordsappen gjorde under oppstarten. Alltid i hjemmemappen din, selv om du har flyttet datamappen.backend-crash.log~/.openestimate/logs/backend-crash.logDetaljer om et uventet stopp. Ligger i datamappen og flytter derfor medOE_DATA_DIR.database log folder~/.openestimate/pgdata/logHvorfor den innebygde databasen ikke startet.
For å åpne mappen fra en terminal:
xdg-open ~/.openestimatepip
- 1
Kjør.
pip install --upgrade openconstructionerpDu serpip laster ned pakken og avhengighetene dens.
- 2
Kjør.
openconstructionerpDu serEn kort velkomst. Ved første kjøring spør den om demoprosjektene skal lastes og om nettleseren skal åpnes.
- 3
Vent mens den lokale databasen settes opp.
Du ser"Database: embedded PostgreSQL 16 (no Docker)", og deretter starter serveren. Nettleseren åpner http://127.0.0.1:8080 (det samme som http://localhost:8080).
- 4
Logg inn. Med demodata kan du bruke demo@openconstructionerp.com / DemoPass1234!
Du serOversikten.
- 5
Ved en ny installasjon blir administratoren spurt én gang om hvilke moduler du skal bruke. Kryss av for det du trenger, og fortsett. Du kan endre det senere med knappen Bakgrunnstjenester i øverste linje.
Du serEn engangsliste over moduler med minnet de trenger.
- 6
For å stoppe, trykk Ctrl+C i terminalen. Neste gang kjører du bare openconstructionerp igjen.
Du serServeren stopper. Dataene dine blir liggende i mappen
.openestimatei hjemmemappen din.
Nyttige kommandoer
Kommandoen openconstructionerp finnes ikke
python -m openconstructionerpNoe fungerer ikke: sjekker Python, porten, datamappen og databasen og sier hva du skal gjøre
openconstructionerp doctorPort 8080 er opptatt av et annet program
openconstructionerp serve --port 8081Andre datamaskiner på nettverket ditt skal få tilgang
openconstructionerp serve --host 0.0.0.0 --port 8080Du må fortelle oss hvilken versjon du har
openconstructionerp --versionHvis du ser en melding
Installasjonpip sier at det ikke ble funnet noen passende distribusjon, eller at det kreves en annen Python.
Det betyr OpenConstructionERP krever Python 3.12 eller nyere.
Gjør dette Installer Python 3.12 eller nyere og kjør python3.12 -m pip install --upgrade openconstructionerp (i Windows: py -3.12 -m pip install --upgrade openconstructionerp).
Installasjonerror: externally-managed-environment (Ubuntu 23.04+, Debian 12+).Betydning: Linux-systemet ditt beskytter sin egen Python og nekter å installere pakker i den.
Det betyr Systemets Python tillater ikke at pip installerer i den.
Gjør dette Bruk pipx install openconstructionerp, eller lag først et virtuelt miljø: python3 -m venv ~/oe && ~/oe/bin/pip install openconstructionerp.
Oppstart"openconstructionerp" is not recognized eller command not found.
Det betyr Mappen der pip legger kommandoer er ikke i PATH (vanlig i Windows).
Gjør dette Kjør python -m openconstructionerp i stedet. Det fungerer på alle systemer uten å røre PATH.
Oppstart"Port 8080 is already in use. Try: openconstructionerp serve --port 8081"Betydning: et annet program bruker allerede port 8080, så start appen på en annen port, for eksempel 8081.
Det betyr Et annet program bruker port 8080.
Gjør dette Kjør den foreslåtte kommandoen og åpne adressen den skriver ut.
Oppstart"Embedded PostgreSQL could not start".Betydning: den innebygde PostgreSQL-databasen kunne ikke starte.
Det betyr Den innebygde databasen kunne ikke starte. Meldingen skriver ut stien til loggen.
Gjør dette Kjør openconstructionerp doctor. Hjelper ikke det, installer på nytt med pip install --upgrade --force-reinstall openconstructionerp og send oss loggen som nevnes.
Hvor loggene ligger
terminal outputthe terminal window (pip);docker compose logs app(Docker)For pip og Docker, kopier det terminalen skrev ut og utdataene fraopenconstructionerp doctor.
Docker
- 1
Last ned de to compose-filene i en tom mappe.
curl -fsSL https://raw.githubusercontent.com/datadrivenconstruction/OpenConstructionERP/main/docker-compose.quickstart.yml -o docker-compose.ymlcurl -fsSL https://raw.githubusercontent.com/datadrivenconstruction/OpenConstructionERP/main/docker-compose.quickstart.image.yml -o docker-compose.override.ymlDu serTo filer i mappen.
- 2
Lag hemmelighetsfilen én gang.
echo "POSTGRES_PASSWORD=$(openssl rand -base64 24)" > .envecho "JWT_SECRET=$(openssl rand -hex 32)" >> .envDu serEn fil
.env. Ta vare på den: den inneholder databasepassordet og innloggingshemmeligheten. - 3
Start den.
docker compose pull app && docker compose up -dDu serTo containere starter: postgres og app.
- 4
Åpne http://localhost:8080 og logg inn med demo@openconstructionerp.com / DemoPass1234!
Du serInnloggingssiden. Første oppstart kan ta et minutt mens databasen forberedes.
- 5
Ved en ny installasjon blir administratoren spurt én gang om hvilke moduler du skal bruke. Kryss av for det du trenger, og fortsett. Du kan endre det senere med knappen Bakgrunnstjenester i øverste linje.
Du serEn engangsliste over moduler med minnet de trenger.
Nyttige kommandoer
Sjekk at begge containerne kjører og er friske
docker compose psSe hvorfor appen ikke starter
docker compose logs appPort 8080 på maskinen din er opptatt
OE_PORT=8081 OE_ALLOWED_ORIGINS=http://localhost:8081 docker compose up -dDette compose-oppsettet er for utprøving og lokal bruk. For en produksjonsserver, se docs/INSTALL_LINUX.md og docker-compose.prod.yml i repositoriet.
Hvis du ser en melding
OppstartCompose stopper med "POSTGRES_PASSWORD must be set" eller "JWT_SECRET must be set".
Det betyr Filen .env med de to hemmelighetene mangler eller ligger ikke i samme mappe.
Gjør dette Lag filen .env som i trinn 2, i mappen med docker-compose.yml.
Oppstarthttp://localhost:8080 åpnes ikke.
Det betyr Containeren kjører ikke ennå, eller port 8080 er opptatt.
Gjør dette Kjør docker compose ps og docker compose logs app. For å bruke en annen port: OE_PORT=8081 OE_ALLOWED_ORIGINS=http://localhost:8081 docker compose up -d, og åpne deretter http://localhost:8081.
InstallasjonPå en Mac med Apple Silicon eller en annen ARM-maskin advarer Docker om at image-plattformen linux/amd64 ikke stemmer, eller appen kjører veldig tregt.
Det betyr Det publiserte imaget er bare bygget for x86-64.
Gjør dette Bygg fra kildekode med make quickstart, eller bruk pip.
Hvor loggene ligger
terminal outputthe terminal window (pip);docker compose logs app(Docker)For pip og Docker, kopier det terminalen skrev ut og utdataene fraopenconstructionerp doctor.
Dataene dine, oppgraderinger og avinstallasjon
- Windows
C:\Users\<your name>\.openestimatePlussC:\ProgramData\OpenConstructionERP\clusters\<id>\pgdatahvis brukernavnet ditt har ikke-latinske tegn;pgdata.locationoppgir den. - macOS~/
.openestimate(skjult; trykk Cmd+Shift+. i Finder) - Linux~/
.openestimate - pip~/
.openestimate, samme mappe som skrivebordsappen, med mindre du oppgir--data-direller setterOE_DATA_DIR - DockerDocker-volumene <folder>_pg_data (database) og <folder>_app_data (filer), der <folder> er navnet på mappen med
docker-compose.yml
Oppgradering
Installer den nye versjonen over den gamle. Mappen din .openestimate er ikke en del av programmet, så prosjekter, brukere og innstillinger beholdes. Første oppstart etter en oppgradering kan ta lengre tid mens databasen oppdaterer seg selv.
Avinstallasjon
Avinstallasjon fjerner programmet og beholder prosjektene dine. I Windows tilbyr avinstallasjonsprogrammet "Delete the application data" (på installasjonsprogrammets språk): det fjerner bare innloggingen og språket appvinduet har lagret (i %APPDATA% og %LOCALAPPDATA%\io.openconstructionerp.desktop), ikke prosjektene dine. For å begynne helt på nytt, avinstaller, kopier .openestimate til et trygt sted og slett den deretter.
Sikkerhetskopi
Lukk appen og kopier mappen .openestimate (og ProgramData-mappen som er nevnt i pgdata.location, hvis det finnes en).
Står du fortsatt fast? Vi hjelper deg
Ta med:
- versjonen (den står i navnet på filen du lastet ned; pip:
openconstructionerp --version; Docker: image-taggen) og hvordan du installerte (Windows-installasjonsprogram, .dmg, .deb, .rpm, AppImage, pip eller Docker) - systemet ditt (Windows: Start, skriv
winver; macOS: Apple-menyen, Om denne Macen; Linux: distribusjonen og versjonen) - den nøyaktige teksten i meldingen, eller et skjermbilde
- loggfilene nevnt ovenfor
Loggfiler kan inneholde brukernavnet ditt og mappenavn. Se gjennom dem før du legger dem ut offentlig; send dem heller på e-post hvis du foretrekker det.
Neste steg etter installasjonen
Hele teksten finnes også på GitHub på English, Deutsch og Русский.