Installationshilfe

OpenConstructionERP installieren

Wählen Sie, wie Sie das Programm betreiben möchten, folgen Sie den nummerierten Schritten und suchen Sie bei Problemen die angezeigte Meldung in der Liste weiter unten. Keine der Warnungen bei der Installation gefährdet Ihre Projekte.

Sie wissen nicht, welche Variante Sie brauchen?

Zuerst ansehen

So installieren Sie OpenConstructionERP

Video-Anleitung unter Windows, aufgenommen mit Version 17.7.1. Einige Bildschirme sehen in 18.5 anders aus, und die Wartezeit bei der Installation ist im Video gekürzt.

Länge 4:41 · Auf YouTube ansehen

Windows

OpenConstructionERP_18.5.0_x64-setup.execa. 800 MB

Vorab Windows 10 oder 11, 64 Bit. Administratorrechte (die App wird für alle Benutzer installiert). Während der Installation ist kein Internet nötig: Die Fensterkomponente (Microsoft WebView2) steckt im Installer.

Diesen Schritt ansehen:
  1. 1

    Laden Sie OpenConstructionERP_18.5.0_x64-setup.exe von der Release-Seite herunter.

    Sie sehenEine Datei von etwa 800 MB im Ordner Downloads.

  2. 2

    Doppelklicken Sie darauf. Meldet ein blaues Fenster "Der Computer wurde durch Windows geschützt", klicken Sie auf Weitere Informationen, prüfen Sie, dass der Dateiname mit OpenConstructionERP beginnt, und klicken Sie dann auf Trotzdem ausführen.

    Sie sehenWindows fragt nach Administratorrechten. Klicken Sie auf Ja.

  3. 3

    Wählen Sie die Sprache des Installers, akzeptieren Sie die Lizenz und behalten Sie den vorgeschlagenen Ordner C:\Program Files\OpenConstructionERP bei.

    Sie sehenEin Fortschrittsbalken, dann die Abschlussseite.

  4. 4

    Klicken Sie auf Fertigstellen oder starten Sie OpenConstructionERP über das Startmenü.

    Sie sehenEin Ladebildschirm "Anwendung wird gestartet" mit einer Checkliste: Backend wird gestartet, Lokale Datenbank wird gestartet, Datenbank wird vorbereitet, Anwendungsserver wird gestartet, App wird geöffnet.

  5. 5

    Warten Sie beim allerersten Start. Schließen Sie das Fenster nicht.

    Sie sehen"Beim ersten Start wird Ihre lokale Datenbank eingerichtet. Das kann ein bis zwei Minuten dauern, bitte warten Sie." Spätere Starts sind deutlich schneller.

  6. 6

    Wählen Sie, wie die App geöffnet wird: als App-Fenster (empfohlen) oder in Ihrem normalen Browser.

    Sie sehen"Wie möchten Sie OpenConstructionERP öffnen?" und danach die Anmeldeseite.

  7. 7

    Melden Sie sich mit dem Demo-Konto an: E-Mail demo@openconstructionerp.com, Passwort DemoPass1234!. Danach können Sie ein eigenes Konto und eigene Projekte anlegen.

    Sie sehenDie App. Die Demo-Projekte werden beim ersten Start im Hintergrund angelegt, deshalb steht in der Projektliste kurz, dass sie unterwegs sind.

  8. 8

    Bei einer neuen Installation wird der Administrator einmalig gefragt, welche Module Sie nutzen. Haken Sie an, was Sie brauchen, und fahren Sie fort. Später ändern Sie das mit der Schaltfläche Hintergrunddienste in der oberen Leiste.

    Sie sehenEine einmalige Liste der Module mit ihrem Speicherbedarf.

Wenn Sie eine Meldung sehen

InstallationEin blaues Fenster "Der Computer wurde durch Windows geschützt".

Das bedeutet Der Installer ist noch nicht per Code signiert, deshalb kennt Windows den Herausgeber nicht. Das ist eine Warnung, kein Virenfund.

So geht es weiter Klicken Sie auf Weitere Informationen, prüfen Sie, dass der Dateiname mit OpenConstructionERP beginnt, und klicken Sie dann auf Trotzdem ausführen.

InstallationDie Intelligente App-Steuerung (Smart App Control) hat die App blockiert, ohne Schaltfläche zum Fortfahren.

Das bedeutet Die Intelligente App-Steuerung von Windows 11 lässt unsignierte Programme nicht zu.

So geht es weiter Die Intelligente App-Steuerung kann keine einzelne App freigeben. Wenn sie eingeschaltet bleiben soll, betreiben Sie OpenConstructionERP mit Docker Desktop oder in WSL (dem in Windows eingebauten Linux), das die Intelligente App-Steuerung nicht prüft. Schritt-für-Schritt-Anleitung: docs/desktop/WINDOWS_BLOCKED.md im Repository.

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" (die Meldung erscheint nur auf Englisch)Bedeutung: Der Installationspfad darf nur lateinische Buchstaben, Ziffern und Leerzeichen enthalten, da die integrierte Datenbank von keinem anderen Pfad aus starten kann.

Das bedeutet Der gewählte Ordner enthält im Pfad kyrillische, chinesische, akzentuierte oder andere nicht lateinische Buchstaben.

So geht es weiter Behalten Sie den vorgeschlagenen Ordner C:\Program Files\OpenConstructionERP bei oder wählen Sie einen Ordner wie C:\OpenConstructionERP. Eine stille Installation (/S) endet mit Code 3 und schreibt den Grund in %TEMP%\OpenConstructionERP-install-error.log.

InstallationDer Installer bricht mit einem Fehler zu WebView2 ab.

Das bedeutet Windows hat die Installation von Microsoft WebView2 abgelehnt, der Komponente, die das App-Fenster zeichnet. Sie steckt im Installer, es ist also kein Internet nötig; der Fehler kommt von Windows selbst (Richtlinie, ausstehendes Update oder eine beschädigte ältere WebView2).

So geht es weiter Starten Sie den Computer neu und führen Sie den Installer erneut aus. Schlägt es wieder fehl, installieren Sie "Microsoft Edge WebView2 Runtime" von Microsoft und starten Sie danach unseren Installer noch einmal.

InstallationIhr Virenschutz löscht oder isoliert bei der Installation oder beim ersten Start eine Datei.

Das bedeutet Das Programm ist neu und nicht signiert, und manche Virenscanner reagieren darauf misstrauisch.

So geht es weiter Stellen Sie die Datei aus der Quarantäne wieder her und nehmen Sie diese zwei Ordner in die Ausnahmen auf: den Programmordner C:\Program Files\OpenConstructionERP und Ihren Datenordner C:\Users\<your name>\.openestimate. Führen Sie dann den Installer erneut über die bestehende Installation aus. Wenn Sie nicht sicher sind, ob die Datei echt ist, schreiben Sie uns zuerst.

UpdateEin Bildschirm, der fragt, ob die installierte Version überschrieben oder zuerst entfernt werden soll, mit einer Zeile, die das Entfernen vorschlägt.

So geht es weiter Lassen Sie die bereits gewählte Option stehen (überschreiben). Ihre Projekte bleiben erhalten. Der erste Start nach einem Update kann länger dauern, weil sich die Datenbank selbst aktualisiert.

UpdateSie starten OpenConstructionERP außerdem per pip oder im Terminal auf demselben Computer, und es bricht beim Update ab.

Das bedeutet Beide nutzen denselben Ordner .openestimate und dieselbe Datenbank. Der Installer beendet diese Datenbank, um das Programm zu ersetzen. Beim Update von 18.4.0 schließt der alte Deinstaller außerdem jedes Programm mit dem Namen openconstructionerp.exe.

So geht es weiter Beenden Sie die Terminal-Version (Strg+C), bevor Sie installieren oder aktualisieren, und starten Sie sie danach wieder.

StartDer Ladebildschirm bleibt beim allerersten Start eine Minute oder länger stehen.

Das bedeutet Die App legt ihre lokale Datenbank an. Das passiert nur einmal.

So geht es weiter Warten Sie und schließen Sie das Fenster nicht. Bei einer langsamen oder fast vollen Festplatte kann es länger dauern. Spätere Starts gehen schnell.

StartEin Fenster "OpenConstructionERP failed to start", das eine Logdatei nennt.

Das bedeutet Die App konnte ihr Fenster gar nicht öffnen.

So geht es weiter Starten Sie sie noch einmal. Erscheint das Fenster wieder, schicken Sie uns die Logdatei, die darin genannt wird.

Start"The backend started, but the local database is not answering, so the app cannot open."Bedeutung: Der Serverteil wurde gestartet, aber seine lokale Datenbank antwortet nicht, daher lässt sich die App nicht öffnen.

Das bedeutet Die lokale Datenbank ist nicht hochgekommen, oft nach einem Lauf, der nicht sauber beendet wurde.

So geht es weiter Starten Sie den Computer neu und die App erneut. Wiederholt es sich, schicken Sie uns desktop-launcher.log und das Datenbank-Log (siehe Logs).

Start"The backend started, but this installation is missing the application files it serves"Bedeutung: Der Serverteil wurde gestartet, aber in der Installation fehlen die Dateien der Benutzeroberfläche.

Das bedeutet Ein Teil des Programmordners fehlt, meist weil der Virenschutz ihn entfernt hat.

So geht es weiter Prüfen Sie die Quarantäne Ihres Virenschutzes und führen Sie den Installer dann erneut über die bestehende Installation aus. Ihre Projekte werden nicht angefasst.

Start"The application backend did not start in time" oder "The application backend stopped responding while preparing the local database" (oder bei einem anderen Schritt).

Das bedeutet Der Start hat länger gedauert, als die App wartet. Die Meldung nennt den Schritt, bei dem es hing.

So geht es weiter Schließen Sie das Fenster und starten Sie neu. Schaffen Sie vorher etwas Speicherplatz, wenn die Festplatte fast voll ist. Bleibt es beim selben Schritt hängen, schicken Sie uns desktop-launcher.log.

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

Das bedeutet Genau das. Die Meldung nennt den Ordner und den verbleibenden freien Platz.

So geht es weiter Schaffen Sie Platz auf diesem Laufwerk und starten Sie neu.

StartEine Meldung, dass der Ordner der lokalen Datenbank "sits too deep in the filesystem", mit zwei Zahlen.

Das bedeutet Windows begrenzt die Pfadlänge, und der Pfad Ihres Datenordners ist für die Datenbankdateien zu lang. Lange Pfade in Windows einzuschalten hilft nicht.

So geht es weiter Setzen Sie die Benutzer-Umgebungsvariable OE_DATA_DIR auf einen kurzen Pfad wie C:\OpenConstructionERP\data (Start, "Umgebungsvariablen" eintippen, Umgebungsvariablen für dieses Konto bearbeiten, Neu) und starten Sie dann neu.

StartIhr Windows-Benutzername enthält nicht lateinische Buchstaben (zum Beispiel kyrillische oder chinesische) und Sie suchen Ihre Datenbank.

Das bedeutet Die eingebaute Datenbank kann von so einem Pfad nicht laufen, deshalb legt die App sie seit 18.5.0 in C:\ProgramData\OpenConstructionERP\clusters\<id>\pgdata ab. Vor 18.5.0 ließ sich die App für solche Konten gar nicht starten.

So geht es weiter Nichts zu beheben. Die Datei pgdata.location in Ihrem Ordner .openestimate nennt den genauen Datenbankordner. Für Backups kopieren Sie beide Ordner.

Betrieb"The application backend stopped, restarting" und das Fenster lädt neu.

Das bedeutet Der Hintergrundteil der App ist unerwartet stehen geblieben und die App hat ihn neu gestartet. Gespeicherte Arbeit bleibt erhalten. Das passiert höchstens zweimal in 30 Minuten.

So geht es weiter Machen Sie einfach weiter. Wiederholt es sich oder sehen Sie "The application backend has stopped", schicken Sie uns desktop-launcher.log und logs/backend-crash.log.

StartBei jedem Start der App sind Sie abgemeldet und die Sprache steht wieder auf Englisch.

Das bedeutet Ein anderes Programm belegt Port 8732, den Port, den die App normalerweise nutzt. Version 18.5.0 wählt dann bei jedem Start einen zufälligen freien Port, und das Fenster behandelt jeden neuen Port als neue Website, sodass Anmeldung und Sprache nicht gefunden werden.

So geht es weiter Beenden oder ändern Sie das andere Programm, das Port 8732 nutzt (unter Windows zeigt netstat -ano | findstr :8732 im Terminal seine Prozess-ID). Ihre Projekte sind nicht betroffen, nur Anmeldung und Spracheinstellung.

StartSie befürchten, dass die App mit einem PostgreSQL kollidiert, das bei Ihnen schon auf Port 5432 läuft.

Das bedeutet Tut sie nicht. Die eingebaute Datenbank nimmt unter Windows einen zufälligen freien lokalen Port, und unter macOS und Linux lauscht sie nur auf einem lokalen Socket, nicht auf einem TCP-Port.

So geht es weiter Nichts zu tun.

Wo die Logs liegen

  • desktop-launcher.logC:\Users\<your name>\.openestimate\desktop-launcher.logAlles, was die Desktop-App beim Start getan hat. Immer in Ihrem Home-Ordner, auch wenn Sie den Datenordner verschoben haben.
  • backend-crash.logC:\Users\<your name>\.openestimate\logs\backend-crash.logDetails zu einem unerwarteten Stopp. Liegt im Datenordner und zieht daher mit OE_DATA_DIR um.
  • database log folderC:\Users\<your name>\.openestimate\pgdata\log (or <folder from pgdata.location>\log)Warum die eingebaute Datenbank nicht gestartet ist.
  • OpenConstructionERP-install-error.log%TEMP%\OpenConstructionERP-install-error.log (%TEMP% in die Adressleiste des Explorers eingeben)Warum der Windows-Installer den Installationsordner abgelehnt hat.

Um den Ordner zu öffnen, fügen Sie das in die Adressleiste des Explorers ein:

%USERPROFILE%\.openestimate

macOS

OpenConstructionERP_18.5.0_aarch64.dmgca. 640 MB

Vorab Ein Mac mit Apple Silicon (M1 oder neuer). Für Intel-Macs gibt es kein Build; auf einem Intel-Mac nutzen Sie pip oder Docker.

  1. 1

    Laden Sie OpenConstructionERP_18.5.0_aarch64.dmg herunter und öffnen Sie die Datei.

    Sie sehenEin Fenster mit dem App-Symbol von OpenConstructionERP.

  2. 2

    Ziehen Sie OpenConstructionERP in den Ordner Programme.

    Sie sehenDie App erscheint in Ihrem Ordner Programme.

  3. 3

    Öffnen Sie einmal das Terminal und führen Sie aus.

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

    Sie sehenKeine Ausgabe. Das ist richtig. Der Befehl entfernt die Download-Markierung, weil die App von Apple noch nicht notarisiert ist.

  4. 4

    Öffnen Sie OpenConstructionERP aus dem Ordner Programme.

    Sie sehenDer Ladebildschirm "Anwendung wird gestartet". Beim ersten Start wird die lokale Datenbank eingerichtet, das dauert ein bis zwei Minuten.

  5. 5

    Wählen Sie App-Fenster oder Browser.

    Sie sehenDie Anmeldeseite.

  6. 6

    Melden Sie sich mit dem Demo-Konto an: E-Mail demo@openconstructionerp.com, Passwort DemoPass1234!. Danach können Sie ein eigenes Konto und eigene Projekte anlegen.

    Sie sehenDie App. Die Demo-Projekte werden beim ersten Start im Hintergrund angelegt, deshalb steht in der Projektliste kurz, dass sie unterwegs sind.

  7. 7

    Bei einer neuen Installation wird der Administrator einmalig gefragt, welche Module Sie nutzen. Haken Sie an, was Sie brauchen, und fahren Sie fort. Später ändern Sie das mit der Schaltfläche Hintergrunddienste in der oberen Leiste.

    Sie sehenEine einmalige Liste der Module mit ihrem Speicherbedarf.

Wenn Sie eine Meldung sehen

StartDer Ladebildschirm bleibt beim allerersten Start eine Minute oder länger stehen.

Das bedeutet Die App legt ihre lokale Datenbank an. Das passiert nur einmal.

So geht es weiter Warten Sie und schließen Sie das Fenster nicht. Bei einer langsamen oder fast vollen Festplatte kann es länger dauern. Spätere Starts gehen schnell.

Start"The backend started, but the local database is not answering, so the app cannot open."Bedeutung: Der Serverteil wurde gestartet, aber seine lokale Datenbank antwortet nicht, daher lässt sich die App nicht öffnen.

Das bedeutet Die lokale Datenbank ist nicht hochgekommen, oft nach einem Lauf, der nicht sauber beendet wurde.

So geht es weiter Starten Sie den Computer neu und die App erneut. Wiederholt es sich, schicken Sie uns desktop-launcher.log und das Datenbank-Log (siehe Logs).

Start"The backend started, but this installation is missing the application files it serves"Bedeutung: Der Serverteil wurde gestartet, aber in der Installation fehlen die Dateien der Benutzeroberfläche.

Das bedeutet Ein Teil des Programmordners fehlt, meist weil der Virenschutz ihn entfernt hat.

So geht es weiter Prüfen Sie die Quarantäne Ihres Virenschutzes und führen Sie den Installer dann erneut über die bestehende Installation aus. Ihre Projekte werden nicht angefasst.

Start"The application backend did not start in time" oder "The application backend stopped responding while preparing the local database" (oder bei einem anderen Schritt).

Das bedeutet Der Start hat länger gedauert, als die App wartet. Die Meldung nennt den Schritt, bei dem es hing.

So geht es weiter Schließen Sie das Fenster und starten Sie neu. Schaffen Sie vorher etwas Speicherplatz, wenn die Festplatte fast voll ist. Bleibt es beim selben Schritt hängen, schicken Sie uns desktop-launcher.log.

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

Das bedeutet Unter macOS und Linux entpackt die App bei jedem Start ihr Backend. Ein langsames oder volles Laufwerk oder ein Virenschutz, der die Dateien sperrt, verhindert das. (Die Windows-App entpackt sich seit 18.5 nicht mehr.)

So geht es weiter Schaffen Sie Platz auf dem Laufwerk mit Ihrem temporären Ordner oder erlauben Sie die App in Ihrem Virenschutz und starten Sie dann neu.

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

Das bedeutet Genau das. Die Meldung nennt den Ordner und den verbleibenden freien Platz.

So geht es weiter Schaffen Sie Platz auf diesem Laufwerk und starten Sie neu.

Betrieb"The application backend stopped, restarting" und das Fenster lädt neu.

Das bedeutet Der Hintergrundteil der App ist unerwartet stehen geblieben und die App hat ihn neu gestartet. Gespeicherte Arbeit bleibt erhalten. Das passiert höchstens zweimal in 30 Minuten.

So geht es weiter Machen Sie einfach weiter. Wiederholt es sich oder sehen Sie "The application backend has stopped", schicken Sie uns desktop-launcher.log und logs/backend-crash.log.

StartBei jedem Start der App sind Sie abgemeldet und die Sprache steht wieder auf Englisch.

Das bedeutet Ein anderes Programm belegt Port 8732, den Port, den die App normalerweise nutzt. Version 18.5.0 wählt dann bei jedem Start einen zufälligen freien Port, und das Fenster behandelt jeden neuen Port als neue Website, sodass Anmeldung und Sprache nicht gefunden werden.

So geht es weiter Beenden oder ändern Sie das andere Programm, das Port 8732 nutzt (unter Windows zeigt netstat -ano | findstr :8732 im Terminal seine Prozess-ID). Ihre Projekte sind nicht betroffen, nur Anmeldung und Spracheinstellung.

StartSie befürchten, dass die App mit einem PostgreSQL kollidiert, das bei Ihnen schon auf Port 5432 läuft.

Das bedeutet Tut sie nicht. Die eingebaute Datenbank nimmt unter Windows einen zufälligen freien lokalen Port, und unter macOS und Linux lauscht sie nur auf einem lokalen Socket, nicht auf einem TCP-Port.

So geht es weiter Nichts zu tun.

Installation"„OpenConstructionERP“ ist beschädigt und kann nicht geöffnet werden."

Das bedeutet Die App ist von Apple noch nicht notarisiert und trägt noch die Download-Markierung. Die App ist nicht beschädigt.

So geht es weiter Nur das hilft: Führen Sie im Terminal einmal xattr -dr com.apple.quarantine /Applications/OpenConstructionERP.app aus und öffnen Sie die App dann ganz normal.

Installation"„OpenConstructionERP“ kann nicht geöffnet werden, da der Entwickler nicht überprüft werden kann." (oder Apple konnte nicht prüfen, ob sie frei von Schadsoftware ist).

Das bedeutet Die App ist ad hoc signiert, aber von Apple noch nicht notarisiert.

So geht es weiter Führen Sie denselben xattr-Befehl aus oder öffnen Sie Systemeinstellungen, Datenschutz & Sicherheit, scrollen Sie nach unten und klicken Sie auf Trotzdem öffnen. Das ist nur einmal nötig.

InstallationDie App läuft auf Ihrem Mac gar nicht.

Das bedeutet Das Mac-Build gibt es nur für Apple Silicon (M1 und neuer). Ein Intel-Build gibt es nicht.

So geht es weiter Auf einem Intel-Mac nutzen Sie pip (Python 3.12 oder neuer) oder Docker.

Wo die Logs liegen

  • desktop-launcher.log~/.openestimate/desktop-launcher.logAlles, was die Desktop-App beim Start getan hat. Immer in Ihrem Home-Ordner, auch wenn Sie den Datenordner verschoben haben.
  • backend-crash.log~/.openestimate/logs/backend-crash.logDetails zu einem unerwarteten Stopp. Liegt im Datenordner und zieht daher mit OE_DATA_DIR um.
  • database log folder~/.openestimate/pgdata/logWarum die eingebaute Datenbank nicht gestartet ist.

Um den Ordner im Terminal zu öffnen:

open ~/.openestimate

Linux

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

Vorab 64-Bit x86 (amd64). Das Paket braucht libwebkit2gtk-4.1-0, das apt für Sie installiert. Gebaut auf Ubuntu 22.04, daher sind Ubuntu 22.04 oder neuer und Debian 12 oder neuer die sichere Wahl.

  1. 1

    Laden Sie OpenConstructionERP_18.5.0_amd64.deb herunter.

    Sie sehenEine Datei von etwa 830 MB.

  2. 2

    Führen Sie im Terminal im Download-Ordner aus.

    sudo apt install ./OpenConstructionERP_18.5.0_amd64.deb

    Sie sehenapt listet das Paket und die nötigen Bibliotheken auf und installiert sie. Das ./ vor dem Dateinamen ist wichtig.

  3. 3

    Starten Sie OpenConstructionERP aus dem Anwendungsmenü.

    Sie sehenDer Ladebildschirm. Der erste Start dauert ein bis zwei Minuten.

  4. 4

    Melden Sie sich mit dem Demo-Konto an: E-Mail demo@openconstructionerp.com, Passwort DemoPass1234!. Danach können Sie ein eigenes Konto und eigene Projekte anlegen.

    Sie sehenDie App. Die Demo-Projekte werden beim ersten Start im Hintergrund angelegt, deshalb steht in der Projektliste kurz, dass sie unterwegs sind.

  5. 5

    Bei einer neuen Installation wird der Administrator einmalig gefragt, welche Module Sie nutzen. Haken Sie an, was Sie brauchen, und fahren Sie fort. Später ändern Sie das mit der Schaltfläche Hintergrunddienste in der oberen Leiste.

    Sie sehenEine einmalige Liste der Module mit ihrem Speicherbedarf.

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

Vorab 64-Bit x86. Das Paket braucht die Bibliothek WebKitGTK 4.1, die die Paketverwaltung für Sie installiert.

  1. 1

    Laden Sie OpenConstructionERP-18.5.0-1.x86_64.rpm herunter.

    Sie sehenEine Datei von etwa 850 MB.

  2. 2

    Ausführen.

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

    Sie sehendnf löst die Abhängigkeiten auf und installiert.

  3. 3

    Starten Sie OpenConstructionERP aus dem Anwendungsmenü.

    Sie sehenDer Ladebildschirm. Der erste Start dauert ein bis zwei Minuten.

  4. 4

    Melden Sie sich mit dem Demo-Konto an: E-Mail demo@openconstructionerp.com, Passwort DemoPass1234!. Danach können Sie ein eigenes Konto und eigene Projekte anlegen.

    Sie sehenDie App. Die Demo-Projekte werden beim ersten Start im Hintergrund angelegt, deshalb steht in der Projektliste kurz, dass sie unterwegs sind.

  5. 5

    Bei einer neuen Installation wird der Administrator einmalig gefragt, welche Module Sie nutzen. Haken Sie an, was Sie brauchen, und fahren Sie fort. Später ändern Sie das mit der Schaltfläche Hintergrunddienste in der oberen Leiste.

    Sie sehenEine einmalige Liste der Module mit ihrem Speicherbedarf.

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

Vorab 64-Bit x86 und die Bibliothek FUSE 2 (libfuse2; unter Ubuntu 24.04 heißt das Paket libfuse2t64).

  1. 1

    Laden Sie OpenConstructionERP_18.5.0_amd64.AppImage herunter.

    Sie sehenEine Datei von etwa 910 MB.

  2. 2

    Machen Sie sie ausführbar.

    chmod +x OpenConstructionERP_18.5.0_amd64.AppImage

    Sie sehenKeine Ausgabe.

  3. 3

    Starten Sie sie.

    ./OpenConstructionERP_18.5.0_amd64.AppImage

    Sie sehenDer Ladebildschirm. Der erste Start dauert ein bis zwei Minuten.

  4. 4

    Melden Sie sich mit dem Demo-Konto an: E-Mail demo@openconstructionerp.com, Passwort DemoPass1234!. Danach können Sie ein eigenes Konto und eigene Projekte anlegen.

    Sie sehenDie App. Die Demo-Projekte werden beim ersten Start im Hintergrund angelegt, deshalb steht in der Projektliste kurz, dass sie unterwegs sind.

  5. 5

    Bei einer neuen Installation wird der Administrator einmalig gefragt, welche Module Sie nutzen. Haken Sie an, was Sie brauchen, und fahren Sie fort. Später ändern Sie das mit der Schaltfläche Hintergrunddienste in der oberen Leiste.

    Sie sehenEine einmalige Liste der Module mit ihrem Speicherbedarf.

Wenn Sie eine Meldung sehen

StartDer Ladebildschirm bleibt beim allerersten Start eine Minute oder länger stehen.

Das bedeutet Die App legt ihre lokale Datenbank an. Das passiert nur einmal.

So geht es weiter Warten Sie und schließen Sie das Fenster nicht. Bei einer langsamen oder fast vollen Festplatte kann es länger dauern. Spätere Starts gehen schnell.

Start"The backend started, but the local database is not answering, so the app cannot open."Bedeutung: Der Serverteil wurde gestartet, aber seine lokale Datenbank antwortet nicht, daher lässt sich die App nicht öffnen.

Das bedeutet Die lokale Datenbank ist nicht hochgekommen, oft nach einem Lauf, der nicht sauber beendet wurde.

So geht es weiter Starten Sie den Computer neu und die App erneut. Wiederholt es sich, schicken Sie uns desktop-launcher.log und das Datenbank-Log (siehe Logs).

Start"The backend started, but this installation is missing the application files it serves"Bedeutung: Der Serverteil wurde gestartet, aber in der Installation fehlen die Dateien der Benutzeroberfläche.

Das bedeutet Ein Teil des Programmordners fehlt, meist weil der Virenschutz ihn entfernt hat.

So geht es weiter Prüfen Sie die Quarantäne Ihres Virenschutzes und führen Sie den Installer dann erneut über die bestehende Installation aus. Ihre Projekte werden nicht angefasst.

Start"The application backend did not start in time" oder "The application backend stopped responding while preparing the local database" (oder bei einem anderen Schritt).

Das bedeutet Der Start hat länger gedauert, als die App wartet. Die Meldung nennt den Schritt, bei dem es hing.

So geht es weiter Schließen Sie das Fenster und starten Sie neu. Schaffen Sie vorher etwas Speicherplatz, wenn die Festplatte fast voll ist. Bleibt es beim selben Schritt hängen, schicken Sie uns desktop-launcher.log.

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

Das bedeutet Unter macOS und Linux entpackt die App bei jedem Start ihr Backend. Ein langsames oder volles Laufwerk oder ein Virenschutz, der die Dateien sperrt, verhindert das. (Die Windows-App entpackt sich seit 18.5 nicht mehr.)

So geht es weiter Schaffen Sie Platz auf dem Laufwerk mit Ihrem temporären Ordner oder erlauben Sie die App in Ihrem Virenschutz und starten Sie dann neu.

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

Das bedeutet Genau das. Die Meldung nennt den Ordner und den verbleibenden freien Platz.

So geht es weiter Schaffen Sie Platz auf diesem Laufwerk und starten Sie neu.

Betrieb"The application backend stopped, restarting" und das Fenster lädt neu.

Das bedeutet Der Hintergrundteil der App ist unerwartet stehen geblieben und die App hat ihn neu gestartet. Gespeicherte Arbeit bleibt erhalten. Das passiert höchstens zweimal in 30 Minuten.

So geht es weiter Machen Sie einfach weiter. Wiederholt es sich oder sehen Sie "The application backend has stopped", schicken Sie uns desktop-launcher.log und logs/backend-crash.log.

StartBei jedem Start der App sind Sie abgemeldet und die Sprache steht wieder auf Englisch.

Das bedeutet Ein anderes Programm belegt Port 8732, den Port, den die App normalerweise nutzt. Version 18.5.0 wählt dann bei jedem Start einen zufälligen freien Port, und das Fenster behandelt jeden neuen Port als neue Website, sodass Anmeldung und Sprache nicht gefunden werden.

So geht es weiter Beenden oder ändern Sie das andere Programm, das Port 8732 nutzt (unter Windows zeigt netstat -ano | findstr :8732 im Terminal seine Prozess-ID). Ihre Projekte sind nicht betroffen, nur Anmeldung und Spracheinstellung.

StartSie befürchten, dass die App mit einem PostgreSQL kollidiert, das bei Ihnen schon auf Port 5432 läuft.

Das bedeutet Tut sie nicht. Die eingebaute Datenbank nimmt unter Windows einen zufälligen freien lokalen Port, und unter macOS und Linux lauscht sie nur auf einem lokalen Socket, nicht auf einem TCP-Port.

So geht es weiter Nichts zu tun.

InstallationDas .deb verlangt libwebkit2gtk-4.1-0, oder dpkg meldet nicht erfüllte Abhängigkeiten.

Das bedeutet Die App braucht WebKitGTK 4.1, um ihr Fenster zu zeichnen. dpkg -i installiert keine Abhängigkeiten.

So geht es weiter Installieren Sie mit sudo apt install ./OpenConstructionERP_18.5.0_amd64.deb, das die Bibliothek mitholt. Hat Ihre Distribution kein libwebkit2gtk-4.1-0 (Ubuntu vor 22.04, Debian vor 12), nutzen Sie pip.

InstallationBeim Doppelklick auf das AppImage passiert nichts.

Das bedeutet Die Datei ist noch nicht als Programm markiert.

So geht es weiter Führen Sie chmod +x OpenConstructionERP_18.5.0_amd64.AppImage aus und starten Sie es erneut.

InstallationEin AppImage-Fehler, der FUSE oder libfuse.so.2 erwähnt.

Das bedeutet Neuere Distributionen installieren die FUSE-2-Bibliothek, die AppImages brauchen, nicht mehr mit.

So geht es weiter Installieren Sie sie (sudo apt install libfuse2, unter Ubuntu 24.04 sudo apt install libfuse2t64) oder nutzen Sie das .deb, das .rpm oder pip.

Wo die Logs liegen

  • desktop-launcher.log~/.openestimate/desktop-launcher.logAlles, was die Desktop-App beim Start getan hat. Immer in Ihrem Home-Ordner, auch wenn Sie den Datenordner verschoben haben.
  • backend-crash.log~/.openestimate/logs/backend-crash.logDetails zu einem unerwarteten Stopp. Liegt im Datenordner und zieht daher mit OE_DATA_DIR um.
  • database log folder~/.openestimate/pgdata/logWarum die eingebaute Datenbank nicht gestartet ist.

Um den Ordner im Terminal zu öffnen:

xdg-open ~/.openestimate

pip

Paket openconstructionerp

Vorab Python 3.12 oder neuer. Prüfen mit python --version. Kein Docker und keine separate Datenbank: pip bringt ein eingebautes PostgreSQL mit.

Diesen Schritt ansehen:
  1. 1

    Ausführen.

    pip install --upgrade openconstructionerp

    Sie sehenpip lädt das Paket und seine Abhängigkeiten herunter.

  2. 2

    Ausführen.

    openconstructionerp

    Sie sehenEine kurze Begrüßung. Beim ersten Lauf fragt es, ob die Demo-Projekte geladen und ob Ihr Browser geöffnet werden soll.

  3. 3

    Warten Sie, während die lokale Datenbank eingerichtet wird.

    Sie sehen"Database: embedded PostgreSQL 16 (no Docker)", danach startet der Server. Ihr Browser öffnet http://127.0.0.1:8080 (dasselbe wie http://localhost:8080).

  4. 4

    Melden Sie sich an. Mit Demo-Daten können Sie demo@openconstructionerp.com / DemoPass1234! nutzen.

    Sie sehenDas Dashboard.

  5. 5

    Bei einer neuen Installation wird der Administrator einmalig gefragt, welche Module Sie nutzen. Haken Sie an, was Sie brauchen, und fahren Sie fort. Später ändern Sie das mit der Schaltfläche Hintergrunddienste in der oberen Leiste.

    Sie sehenEine einmalige Liste der Module mit ihrem Speicherbedarf.

  6. 6

    Zum Beenden drücken Sie im Terminal Strg+C. Beim nächsten Mal starten Sie einfach wieder openconstructionerp.

    Sie sehenDer Server hält an. Ihre Daten bleiben im Ordner .openestimate in Ihrem Home-Ordner.

Nützliche Befehle

Der Befehl openconstructionerp wird nicht gefunden

python -m openconstructionerp

Etwas funktioniert nicht: prüft Python, den Port, den Datenordner und die Datenbank und sagt, was zu tun ist

openconstructionerp doctor

Port 8080 ist von einem anderen Programm belegt

openconstructionerp serve --port 8081

Andere Computer in Ihrem Netzwerk sollen darauf zugreifen

openconstructionerp serve --host 0.0.0.0 --port 8080

Sie müssen uns Ihre Version nennen

openconstructionerp --version

Wenn Sie eine Meldung sehen

Installationpip meldet, dass keine passende Distribution gefunden wurde oder dass eine andere Python-Version nötig ist.

Das bedeutet OpenConstructionERP braucht Python 3.12 oder neuer.

So geht es weiter Installieren Sie Python 3.12 oder neuer und führen Sie python3.12 -m pip install --upgrade openconstructionerp aus (unter Windows: py -3.12 -m pip install --upgrade openconstructionerp).

Installationerror: externally-managed-environment (Ubuntu 23.04+, Debian 12+).Bedeutung: Ihr Linux-System schützt sein eigenes Python und lehnt die Installation von Paketen darin ab.

Das bedeutet Das System-Python erlaubt pip nicht, dort zu installieren.

So geht es weiter Nutzen Sie pipx install openconstructionerp oder legen Sie zuerst eine virtuelle Umgebung an: python3 -m venv ~/oe && ~/oe/bin/pip install openconstructionerp.

Start"openconstructionerp" is not recognized oder command not found.

Das bedeutet Der Ordner, in den pip Befehle ablegt, steht nicht in Ihrem PATH (unter Windows häufig).

So geht es weiter Führen Sie stattdessen python -m openconstructionerp aus. Das klappt auf jedem System, ohne den PATH anzufassen.

Start"Port 8080 is already in use. Try: openconstructionerp serve --port 8081"Bedeutung: Ein anderes Programm belegt bereits Port 8080. Starten Sie die App daher auf einem anderen Port, zum Beispiel 8081.

Das bedeutet Ein anderes Programm belegt Port 8080.

So geht es weiter Führen Sie den vorgeschlagenen Befehl aus und öffnen Sie die Adresse, die er ausgibt.

Start"Embedded PostgreSQL could not start".Bedeutung: Die integrierte PostgreSQL-Datenbank konnte nicht gestartet werden.

Das bedeutet Die eingebaute Datenbank ließ sich nicht starten. Die Meldung gibt den Pfad ihres Logs aus.

So geht es weiter Führen Sie openconstructionerp doctor aus. Hilft das nicht, installieren Sie mit pip install --upgrade --force-reinstall openconstructionerp neu und schicken Sie uns das Log, das genannt wird.

Wo die Logs liegen

  • terminal outputthe terminal window (pip); docker compose logs app (Docker)Bei pip und Docker kopieren Sie, was das Terminal ausgegeben hat, und die Ausgabe von openconstructionerp doctor.

Docker

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

Vorab Docker mit Docker Compose. Das veröffentlichte Image ist für x86-64 (amd64) gebaut. Auf Apple Silicon oder anderen ARM-Rechnern bauen Sie aus dem Quelltext (make quickstart) oder nutzen pip. Die Befehle unten sind für eine bash-Shell (Linux, macOS oder Git Bash bzw. WSL unter Windows). Windows PowerShell hat kein openssl und schreibt Dateien in einem Format, das Compose nicht lesen kann.

  1. 1

    Laden Sie in einem leeren Ordner die zwei Compose-Dateien herunter.

    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

    Sie sehenZwei Dateien im Ordner.

  2. 2

    Legen Sie die Secrets-Datei einmalig an.

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

    Sie sehenEine Datei .env. Bewahren Sie sie auf: Sie enthält das Datenbankpasswort und das Anmelde-Secret.

  3. 3

    Starten Sie es.

    docker compose pull app && docker compose up -d

    Sie sehenZwei Container starten: postgres und app.

  4. 4

    Öffnen Sie http://localhost:8080 und melden Sie sich mit demo@openconstructionerp.com / DemoPass1234! an.

    Sie sehenDie Anmeldeseite. Der erste Start kann eine Minute dauern, während die Datenbank vorbereitet wird.

  5. 5

    Bei einer neuen Installation wird der Administrator einmalig gefragt, welche Module Sie nutzen. Haken Sie an, was Sie brauchen, und fahren Sie fort. Später ändern Sie das mit der Schaltfläche Hintergrunddienste in der oberen Leiste.

    Sie sehenEine einmalige Liste der Module mit ihrem Speicherbedarf.

Nützliche Befehle

Prüfen, ob beide Container laufen und gesund sind

docker compose ps

Sehen, warum die App nicht startet

docker compose logs app

Port 8080 auf Ihrem Rechner ist belegt

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

Dieses Compose-Setup ist für Tests und lokale Nutzung gedacht. Für einen Produktionsserver siehe docs/INSTALL_LINUX.md und docker-compose.prod.yml im Repository.

Wenn Sie eine Meldung sehen

StartCompose bricht ab mit "POSTGRES_PASSWORD must be set" oder "JWT_SECRET must be set".

Das bedeutet Die Datei .env mit den zwei Secrets fehlt oder liegt nicht im selben Ordner.

So geht es weiter Legen Sie die Datei .env wie in Schritt 2 an, im Ordner mit docker-compose.yml.

Starthttp://localhost:8080 lässt sich nicht öffnen.

Das bedeutet Der Container läuft noch nicht, oder Port 8080 ist belegt.

So geht es weiter Führen Sie docker compose ps und docker compose logs app aus. Für einen anderen Port: OE_PORT=8081 OE_ALLOWED_ORIGINS=http://localhost:8081 docker compose up -d, und öffnen Sie dann http://localhost:8081.

InstallationAuf einem Apple-Silicon-Mac oder einem anderen ARM-Rechner warnt Docker, dass die Image-Plattform linux/amd64 nicht passt, oder die App läuft sehr langsam.

Das bedeutet Das veröffentlichte Image ist nur für x86-64 gebaut.

So geht es weiter Bauen Sie aus dem Quelltext mit make quickstart oder nutzen Sie pip.

Wo die Logs liegen

  • terminal outputthe terminal window (pip); docker compose logs app (Docker)Bei pip und Docker kopieren Sie, was das Terminal ausgegeben hat, und die Ausgabe von openconstructionerp doctor.

Ihre Daten, Updates und Deinstallation

Update

Installieren Sie die neue Version über die alte. Ihr Ordner .openestimate gehört nicht zum Programm, daher bleiben Projekte, Benutzer und Einstellungen erhalten. Der erste Start nach einem Update kann länger dauern, weil sich die Datenbank selbst aktualisiert.

Deinstallation

Beim Deinstallieren wird das Programm entfernt, Ihre Projekte bleiben. Unter Windows bietet der Deinstaller "Delete the application data" an (in der Sprache des Installers): Das entfernt nur die gespeicherte Anmeldung und Sprache des App-Fensters (in %APPDATA% und %LOCALAPPDATA%\io.openconstructionerp.desktop), nicht Ihre Projekte. Um ganz neu zu beginnen, deinstallieren Sie, kopieren .openestimate an einen sicheren Ort und löschen den Ordner dann.

Backup

Schließen Sie die App und kopieren Sie den Ordner .openestimate (und den ProgramData-Ordner, der in pgdata.location steht, falls es einen gibt).

Immer noch Probleme? Wir helfen

Bitte schicken Sie mit:

GitHub Issues GitHub Discussions info@datadrivenconstruction.io

Logdateien können Ihren Benutzernamen und Ordnernamen enthalten. Sehen Sie sie durch, bevor Sie sie öffentlich posten; schicken Sie sie auf Wunsch per E-Mail.

Nächste Schritte nach der Installation

Installiert und angemeldet? Sehen Sie sich diese Videos der Reihe nach an. Jedes ist kurz und zeigt die echte App.

  1. Erste Schritte nach der Installation

    Die zweite Hälfte des Installationsvideos: erster Start, Sprache und Region, Module, Benutzer, Ihr erstes Projekt.

  2. Das ganze Produkt kennenlernen

    Auch nützlich

    Produktrundgang: BOQ, BIM, DWG, PDF-Takeoff und KI-Kalkulation

    12:01 Minuten, mit einer früheren Version aufgenommen. Zeigt auch eine pip-Installation.

    Kurze Tour, 2:37: ein Gebäude, eine verlässliche Datenbasis

  3. Grundlagen der Kalkulation

    Builder's Playbook: Getting Started3 VideosHier beginnen: Kostendatenbank und Einheitspreise, eine Kalkulation Schritt für Schritt, Gemeinkosten, Gewinn und Wagnis (USA).

  4. Ihr Markt, von Anfang bis Ende

    Builder's Playbook UK: Construction in England6 Videos · ENCommercial Management in Großbritannien: Angebotskalkulation nach NRM 2, Angebotsvergleich, JCT-Zahlungen und Sicherheitseinbehalt, Pay-less-Notices, CIS und VAT Reverse Charge, Nachträge.Builder's Playbook: Canada6 Videos · ENKanada/Ontario: Preisbildung, Ausschreibung an Nachunternehmer, CCDC 2 Abschlagszahlungen, zügige Zahlung (prompt payment), Änderungsaufträge, wesentliche Fertigstellung.Builder's Playbook: Québec5 Videos · FRQuébec auf Französisch: Einstieg, Kalkulation, BSDQ-Ausschreibungen, Rechnungsstellung mit Einbehalt und gesetzlicher Hypothek, Abnahme und Mängel.OpenConstructionERP auf Deutsch: vom Projektstart bis zur Übergabe8 Videos · DEDeutsche Reihe vom Projektaufbau über Pläne/RFI, Mengen, BIM-Prüfungen, LV, Einheitspreise, GAEB X83/X84 bis zur Vergabe (nummeriert /12, 8 veröffentlicht).Builder's Playbook Hrvatska: gradnja u Hrvatskoj5 Videos · HRKroatien: Import des Vertrags-BOQ aus Excel, Eingangsrechnungen, Nachunternehmer, Abschlagsrechnungen, Finanzstatus und Zusatzleistungen.

  5. Baustelle führen: Budget, Einkauf, Stunden, Rechnungen

    OpenConstructionERP en français: gérer un chantier4 Videos · FRFranzösische Baustellenführung: Budget, Einkauf und Lager, Stunden und Geräte, Rechnungen und Zahlungen.

Alle Playlists auf dem Kanal der OpenConstruction Academy

Den vollständigen Text gibt es auch auf GitHub auf English, Deutsch und Русский.