Nápověda k instalaci

Instalace OpenConstructionERP

Vyberte, jak ho chcete spouštět, projděte očíslované kroky a pokud něco nevypadá správně, najděte zobrazenou zprávu v seznamu problémů níže. Žádné z varování během instalace neohrožuje vaše projekty.

Nevíte, který potřebujete?

Nejdřív se podívejte

Jak nainstalovat OpenConstructionERP

Video návod ve Windows, natočený ve verzi 17.7.1. Některé obrazovky vypadají v 18.5 jinak a čekání při instalaci je ve videu zkráceno.

Délka 4:41 · Pustit na YouTube

Windows

OpenConstructionERP_18.5.0_x64-setup.exeasi 800 MB

Než začnete Windows 10 nebo 11, 64bitový. Oprávnění správce (aplikace se instaluje pro všechny uživatele). Během instalace není potřeba internet: komponenta okna (Microsoft WebView2) je přímo v instalátoru.

Podívejte se na tento krok:
  1. 1

    Stáhněte si OpenConstructionERP_18.5.0_x64-setup.exe ze stránky vydání.

    UvidíteSoubor o velikosti asi 800 MB ve složce Stažené soubory.

  2. 2

    Dvakrát na něj klikněte. Pokud modré okno hlásí "Systém Windows ochránil váš počítač", klikněte na Další informace, zkontrolujte, že název souboru začíná OpenConstructionERP, a klikněte na Přesto spustit.

    UvidíteWindows požádá o oprávnění správce. Klikněte na Ano.

  3. 3

    Vyberte jazyk instalátoru, přijměte licenci a ponechte navrženou složku C:\Program Files\OpenConstructionERP.

    UvidíteUkazatel průběhu a poté závěrečná stránka.

  4. 4

    Klikněte na Dokončit, nebo spusťte OpenConstructionERP z nabídky Start.

    UvidíteÚvodní obrazovka "Spouštění aplikace" se seznamem: spouštění backendu, spouštění místní databáze, příprava databáze, spouštění aplikačního serveru, otevírání aplikace.

  5. 5

    Při úplně prvním spuštění počkejte. Nezavírejte okno.

    Uvidíte"První spuštění nastaví vaši místní databázi. Může to trvat minutu až dvě, počkejte prosím." Další spuštění jsou mnohem rychlejší.

  6. 6

    Vyberte, jak se má otevřít: jako okno aplikace (doporučeno), nebo ve vašem běžném prohlížeči.

    Uvidíte"Jak chcete OpenConstructionERP otevřít?" a poté přihlašovací stránka.

  7. 7

    Přihlaste se demo účtem: e-mail demo@openconstructionerp.com, heslo DemoPass1234!. Odtud si pak můžete vytvořit vlastní účet a projekty.

    UvidíteAplikace. Demo projekty se při prvním spuštění vytvářejí na pozadí, takže seznam projektů může na chvíli hlásit, že jsou na cestě.

  8. 8

    Při nové instalaci se správce jednou zeptá, které moduly budete používat. Zaškrtněte, co potřebujete, a pokračujte. Později to změníte tlačítkem Služby na pozadí v horní liště.

    UvidíteJednorázový seznam modulů s pamětí, kterou potřebují.

Pokud vidíte zprávu

InstalaceModré okno "Systém Windows ochránil váš počítač".

Co to znamená Instalátor zatím není podepsaný kódem, takže Windows nezná vydavatele. Je to varování, ne nález viru.

Co dělat Klikněte na Další informace, zkontrolujte, že název souboru začíná OpenConstructionERP, a klikněte na Přesto spustit.

InstalaceInteligentní řízení aplikací (Smart App Control) aplikaci zablokovalo a není tlačítko pro pokračování.

Co to znamená Inteligentní řízení aplikací ve Windows 11 odmítá nepodepsané programy.

Co dělat Inteligentní řízení aplikací nemůže povolit jedinou aplikaci. Chcete-li ho nechat zapnuté, spouštějte OpenConstructionERP přes Docker Desktop nebo ve WSL (Linux zabudovaný ve Windows), které Inteligentní řízení aplikací nekontroluje. Postup krok za krokem: docs/desktop/WINDOWS_BLOCKED.md v repozitáři.

Instalace"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" (zpráva existuje jen anglicky)Význam: cesta k instalační složce smí obsahovat jen latinská písmena, číslice a mezery, protože vestavěná databáze se z jiné cesty nespustí.

Co to znamená Vybraná složka má v cestě azbuku, čínské znaky, znaky s diakritikou nebo jiné nelatinské znaky.

Co dělat Ponechte navrženou složku C:\Program Files\OpenConstructionERP, nebo vyberte složku jako C:\OpenConstructionERP. Tichá instalace (/S) skončí s kódem 3 a důvod zapíše do %TEMP%\OpenConstructionERP-install-error.log.

InstalaceInstalátor se zastaví s chybou kolem WebView2.

Co to znamená Windows odmítl nainstalovat Microsoft WebView2, komponentu, která kreslí okno aplikace. Je součástí instalátoru, takže internet není potřeba; chyba přichází od samotných Windows (zásady, čekající aktualizace nebo poškozený starší WebView2).

Co dělat Restartujte počítač a spusťte instalátor znovu. Pokud to znovu selže, nainstalujte od Microsoftu "Microsoft Edge WebView2 Runtime" a pak náš instalátor spusťte ještě jednou.

InstalaceVáš antivirus během instalace nebo při prvním spuštění smaže soubor nebo ho dá do karantény.

Co to znamená Program je nový a nepodepsaný a některé antiviry se k tomu staví podezřívavě.

Co dělat Obnovte soubor z karantény a přidejte tyto dvě složky do výjimek: složku programu C:\Program Files\OpenConstructionERP a svou datovou složku C:\Users\<your name>\.openestimate. Pak spusťte instalátor znovu přes stávající instalaci. Pokud si nejste jisti, že je soubor pravý, napište nám nejdřív.

AktualizaceObrazovka, která se ptá, zda přepsat nainstalovanou verzi, nebo ji nejdřív odebrat, s řádkem doporučujícím odebrání.

Co dělat Ponechte už vybranou možnost (přepsat). Vaše projekty zůstanou. První spuštění po aktualizaci může trvat déle, než se databáze sama aktualizuje.

AktualizaceOpenConstructionERP spouštíte také přes pip nebo v terminálu na stejném počítači a při aktualizaci se zastaví.

Co to znamená Obě verze používají stejnou složku .openestimate a stejnou databázi. Instalátor tuto databázi zastaví, aby mohl program vyměnit. Při aktualizaci z verze 18.4.0 starý odinstalátor zavře také každý program s názvem openconstructionerp.exe.

Co dělat Před instalací nebo aktualizací zastavte verzi v terminálu (Ctrl+C) a poté ji znovu spusťte.

SpuštěníÚvodní obrazovka při úplně prvním spuštění zůstane minutu nebo déle.

Co to znamená Aplikace vytváří svou místní databázi. Stane se to jen jednou.

Co dělat Počkejte a nezavírejte okno. Na pomalém nebo téměř plném disku to může trvat déle. Další spuštění jsou rychlá.

SpuštěníOkno "OpenConstructionERP failed to start", které uvádí soubor protokolu.

Co to znamená Aplikace vůbec nedokázala otevřít své okno.

Co dělat Spusťte ji ještě jednou. Pokud se okno vrátí, pošlete nám soubor protokolu, který uvádí.

Spuštění"The backend started, but the local database is not answering, so the app cannot open."Význam: serverová část se spustila, ale její místní databáze neodpovídá, a aplikaci proto nelze otevřít.

Co to znamená Místní databáze nenaběhla, často po běhu, který se neukončil čistě.

Co dělat Restartujte počítač a spusťte aplikaci znovu. Pokud se to opakuje, pošlete nám desktop-launcher.log a protokol databáze (viz Protokoly).

Spuštění"The backend started, but this installation is missing the application files it serves"Význam: serverová část se spustila, ale v instalaci chybí soubory uživatelského rozhraní.

Co to znamená Chybí část složky programu, obvykle ji odstranil antivirus.

Co dělat Zkontrolujte karanténu antiviru a pak spusťte instalátor znovu přes stávající instalaci. Vašich projektů se to nedotkne.

Spuštění"The application backend did not start in time" nebo "The application backend stopped responding while preparing the local database" (nebo u jiného kroku).

Co to znamená Spuštění trvalo déle, než aplikace čeká. Zpráva uvádí krok, ve kterém to bylo.

Co dělat Zavřete okno a spusťte znovu. Pokud je disk skoro plný, nejdřív uvolněte místo. Když se to zastaví na stejném kroku znovu, pošlete nám desktop-launcher.log.

Spuštění"The drive ran out of space while the application was starting" nebo "There is not enough free space to start the application".

Co to znamená Přesně to. Zpráva uvádí složku a zbývající volné místo.

Co dělat Uvolněte místo na tom disku a spusťte znovu.

SpuštěníZpráva, že složka místní databáze "sits too deep in the filesystem", se dvěma čísly.

Co to znamená Windows omezuje délku cesty a cesta k vaší datové složce je pro soubory databáze příliš dlouhá. Zapnutí dlouhých cest ve Windows nepomůže.

Co dělat Nastavte uživatelskou proměnnou prostředí OE_DATA_DIR na krátkou cestu, například C:\OpenConstructionERP\data (Start, napište "proměnné prostředí", Upravit proměnné prostředí pro váš účet, Nová) a spusťte znovu.

SpuštěníVaše uživatelské jméno ve Windows má nelatinské znaky (například azbuku nebo čínštinu) a hledáte svou databázi.

Co to znamená Vestavěná databáze z takové cesty běžet nemůže, proto ji aplikace od verze 18.5.0 drží v C:\ProgramData\OpenConstructionERP\clusters\<id>\pgdata. Před verzí 18.5.0 se aplikace pro takové účty nespustila vůbec.

Co dělat Není co opravovat. Soubor pgdata.location ve vaší složce .openestimate uvádí přesnou složku databáze. Pro zálohu zkopírujte obě složky.

Za provozu"The application backend stopped, restarting" a okno se znovu načte.

Co to znamená Část aplikace běžící na pozadí se neočekávaně zastavila a aplikace ji restartovala. Uložená práce zůstane. Dělá to nejvýš dvakrát za 30 minut.

Co dělat Pokračujte. Pokud se to opakuje, nebo uvidíte "The application backend has stopped", pošlete nám desktop-launcher.log a logs/backend-crash.log.

SpuštěníPři každém spuštění aplikace jste odhlášeni a jazyk se vrátí na angličtinu.

Co to znamená Jiný program používá port 8732, který aplikace běžně používá. Verze 18.5.0 pak při každém spuštění vybere náhodný volný port a okno bere každý nový port jako nový web, takže se přihlášení a jazyk nenajdou.

Co dělat Zavřete nebo překonfigurujte druhý program, který používá port 8732 (ve Windows spusťte v terminálu netstat -ano | findstr :8732 a uvidíte jeho ID procesu). Vaše projekty to neovlivní, jen přihlášení a volbu jazyka.

SpuštěníObáváte se, že aplikace koliduje s PostgreSQL, který už máte na portu 5432.

Co to znamená Nekoliduje. Vestavěná databáze si ve Windows bere náhodný volný místní port a v macOS a Linuxu naslouchá jen na místním socketu, ne na portu TCP.

Co dělat Není co dělat.

Kde jsou protokoly

  • desktop-launcher.logC:\Users\<your name>\.openestimate\desktop-launcher.logVše, co desktopová aplikace dělala při spouštění. Vždy ve vaší domovské složce, i když jste datovou složku přesunuli.
  • backend-crash.logC:\Users\<your name>\.openestimate\logs\backend-crash.logPodrobnosti o neočekávaném zastavení. Leží v datové složce, takže se přesouvá s OE_DATA_DIR.
  • database log folderC:\Users\<your name>\.openestimate\pgdata\log (or <folder from pgdata.location>\log)Proč se vestavěná databáze nespustila.
  • OpenConstructionERP-install-error.log%TEMP%\OpenConstructionERP-install-error.log (zadejte %TEMP% do adresního řádku Průzkumníka)Proč instalátor pro Windows odmítl instalační složku.

Složku otevřete tak, že tohle vložíte do adresního řádku Průzkumníka:

%USERPROFILE%\.openestimate

macOS

OpenConstructionERP_18.5.0_aarch64.dmgasi 640 MB

Než začnete Mac s Apple Silicon (M1 nebo novější). Sestavení pro Mac s Intelem neexistuje; na Macu s Intelem použijte pip nebo Docker.

  1. 1

    Stáhněte si OpenConstructionERP_18.5.0_aarch64.dmg a otevřete ho.

    UvidíteOkno s ikonou aplikace OpenConstructionERP.

  2. 2

    Přetáhněte OpenConstructionERP do Aplikací.

    UvidíteAplikace se objeví ve složce Aplikace.

  3. 3

    Jednou otevřete Terminál a spusťte.

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

    UvidíteŽádný výstup. To je správně. Příkaz odstraní značku stažení, protože aplikace zatím není notarizovaná Applem.

  4. 4

    Otevřete OpenConstructionERP z Aplikací.

    UvidíteÚvodní obrazovka "Spouštění aplikace". První spuštění nastaví místní databázi a trvá minutu až dvě.

  5. 5

    Vyberte okno aplikace nebo prohlížeč.

    UvidítePřihlašovací stránka.

  6. 6

    Přihlaste se demo účtem: e-mail demo@openconstructionerp.com, heslo DemoPass1234!. Odtud si pak můžete vytvořit vlastní účet a projekty.

    UvidíteAplikace. Demo projekty se při prvním spuštění vytvářejí na pozadí, takže seznam projektů může na chvíli hlásit, že jsou na cestě.

  7. 7

    Při nové instalaci se správce jednou zeptá, které moduly budete používat. Zaškrtněte, co potřebujete, a pokračujte. Později to změníte tlačítkem Služby na pozadí v horní liště.

    UvidíteJednorázový seznam modulů s pamětí, kterou potřebují.

Pokud vidíte zprávu

SpuštěníÚvodní obrazovka při úplně prvním spuštění zůstane minutu nebo déle.

Co to znamená Aplikace vytváří svou místní databázi. Stane se to jen jednou.

Co dělat Počkejte a nezavírejte okno. Na pomalém nebo téměř plném disku to může trvat déle. Další spuštění jsou rychlá.

Spuštění"The backend started, but the local database is not answering, so the app cannot open."Význam: serverová část se spustila, ale její místní databáze neodpovídá, a aplikaci proto nelze otevřít.

Co to znamená Místní databáze nenaběhla, často po běhu, který se neukončil čistě.

Co dělat Restartujte počítač a spusťte aplikaci znovu. Pokud se to opakuje, pošlete nám desktop-launcher.log a protokol databáze (viz Protokoly).

Spuštění"The backend started, but this installation is missing the application files it serves"Význam: serverová část se spustila, ale v instalaci chybí soubory uživatelského rozhraní.

Co to znamená Chybí část složky programu, obvykle ji odstranil antivirus.

Co dělat Zkontrolujte karanténu antiviru a pak spusťte instalátor znovu přes stávající instalaci. Vašich projektů se to nedotkne.

Spuštění"The application backend did not start in time" nebo "The application backend stopped responding while preparing the local database" (nebo u jiného kroku).

Co to znamená Spuštění trvalo déle, než aplikace čeká. Zpráva uvádí krok, ve kterém to bylo.

Co dělat Zavřete okno a spusťte znovu. Pokud je disk skoro plný, nejdřív uvolněte místo. Když se to zastaví na stejném kroku znovu, pošlete nám desktop-launcher.log.

Spuštění"The application never finished unpacking itself, so its backend never started." nebo "The application could not unpack itself into the temporary folder it uses."

Co to znamená V macOS a Linuxu aplikace při každém spuštění rozbaluje svůj backend. Zabrání tomu pomalý nebo plný disk, nebo antivirus, který soubory zamyká. (Aplikace pro Windows se od verze 18.5 už sama nerozbaluje.)

Co dělat Uvolněte místo na disku s dočasnou složkou, nebo aplikaci povolte v antiviru, a spusťte znovu.

Spuštění"The drive ran out of space while the application was starting" nebo "There is not enough free space to start the application".

Co to znamená Přesně to. Zpráva uvádí složku a zbývající volné místo.

Co dělat Uvolněte místo na tom disku a spusťte znovu.

Za provozu"The application backend stopped, restarting" a okno se znovu načte.

Co to znamená Část aplikace běžící na pozadí se neočekávaně zastavila a aplikace ji restartovala. Uložená práce zůstane. Dělá to nejvýš dvakrát za 30 minut.

Co dělat Pokračujte. Pokud se to opakuje, nebo uvidíte "The application backend has stopped", pošlete nám desktop-launcher.log a logs/backend-crash.log.

SpuštěníPři každém spuštění aplikace jste odhlášeni a jazyk se vrátí na angličtinu.

Co to znamená Jiný program používá port 8732, který aplikace běžně používá. Verze 18.5.0 pak při každém spuštění vybere náhodný volný port a okno bere každý nový port jako nový web, takže se přihlášení a jazyk nenajdou.

Co dělat Zavřete nebo překonfigurujte druhý program, který používá port 8732 (ve Windows spusťte v terminálu netstat -ano | findstr :8732 a uvidíte jeho ID procesu). Vaše projekty to neovlivní, jen přihlášení a volbu jazyka.

SpuštěníObáváte se, že aplikace koliduje s PostgreSQL, který už máte na portu 5432.

Co to znamená Nekoliduje. Vestavěná databáze si ve Windows bere náhodný volný místní port a v macOS a Linuxu naslouchá jen na místním socketu, ne na portu TCP.

Co dělat Není co dělat.

Instalace"Aplikace „OpenConstructionERP“ je poškozená a nelze ji otevřít."

Co to znamená Aplikace zatím není notarizovaná Applem a stále nese značku stažení. Aplikace není poškozená.

Co dělat Pomůže jen tohle: v Terminálu jednou spusťte xattr -dr com.apple.quarantine /Applications/OpenConstructionERP.app a pak aplikaci otevřete normálně.

Instalace"Aplikaci „OpenConstructionERP“ nelze otevřít, protože nelze ověřit vývojáře" (nebo Apple nemohl ověřit, že neobsahuje malware).

Co to znamená Aplikace je podepsaná ad hoc, ale zatím není notarizovaná Applem.

Co dělat Spusťte stejný příkaz xattr, nebo otevřete Nastavení systému, Soukromí a zabezpečení, posuňte se dolů a klikněte na Přesto otevřít. Uděláte to jen jednou.

InstalaceAplikace na vašem Macu vůbec neběží.

Co to znamená Sestavení pro Mac je jen pro Apple Silicon (M1 a novější). Sestavení pro Intel neexistuje.

Co dělat Na Macu s Intelem použijte pip (Python 3.12 nebo novější) nebo Docker.

Kde jsou protokoly

  • desktop-launcher.log~/.openestimate/desktop-launcher.logVše, co desktopová aplikace dělala při spouštění. Vždy ve vaší domovské složce, i když jste datovou složku přesunuli.
  • backend-crash.log~/.openestimate/logs/backend-crash.logPodrobnosti o neočekávaném zastavení. Leží v datové složce, takže se přesouvá s OE_DATA_DIR.
  • database log folder~/.openestimate/pgdata/logProč se vestavěná databáze nespustila.

Složku otevřete z terminálu takto:

open ~/.openestimate

Linux

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

Než začnete 64bitový x86 (amd64). Balíček potřebuje libwebkit2gtk-4.1-0, který za vás nainstaluje apt. Sestaveno na Ubuntu 22.04, takže jistá volba je Ubuntu 22.04 nebo novější a Debian 12 nebo novější.

  1. 1

    Stáhněte si OpenConstructionERP_18.5.0_amd64.deb.

    UvidíteSoubor o velikosti asi 830 MB.

  2. 2

    V terminálu ve složce se staženým souborem spusťte.

    sudo apt install ./OpenConstructionERP_18.5.0_amd64.deb

    Uvidíteapt vypíše balíček a potřebné knihovny a nainstaluje je. Důležité je ./ před názvem souboru.

  3. 3

    Spusťte OpenConstructionERP z nabídky aplikací.

    UvidíteÚvodní obrazovka. První spuštění trvá minutu až dvě.

  4. 4

    Přihlaste se demo účtem: e-mail demo@openconstructionerp.com, heslo DemoPass1234!. Odtud si pak můžete vytvořit vlastní účet a projekty.

    UvidíteAplikace. Demo projekty se při prvním spuštění vytvářejí na pozadí, takže seznam projektů může na chvíli hlásit, že jsou na cestě.

  5. 5

    Při nové instalaci se správce jednou zeptá, které moduly budete používat. Zaškrtněte, co potřebujete, a pokračujte. Později to změníte tlačítkem Služby na pozadí v horní liště.

    UvidíteJednorázový seznam modulů s pamětí, kterou potřebují.

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

Než začnete 64bitový x86. Balíček potřebuje knihovnu WebKitGTK 4.1, kterou za vás nainstaluje správce balíčků.

  1. 1

    Stáhněte si OpenConstructionERP-18.5.0-1.x86_64.rpm.

    UvidíteSoubor o velikosti asi 850 MB.

  2. 2

    Spusťte.

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

    Uvidítednf vyřeší závislosti a nainstaluje.

  3. 3

    Spusťte OpenConstructionERP z nabídky aplikací.

    UvidíteÚvodní obrazovka. První spuštění trvá minutu až dvě.

  4. 4

    Přihlaste se demo účtem: e-mail demo@openconstructionerp.com, heslo DemoPass1234!. Odtud si pak můžete vytvořit vlastní účet a projekty.

    UvidíteAplikace. Demo projekty se při prvním spuštění vytvářejí na pozadí, takže seznam projektů může na chvíli hlásit, že jsou na cestě.

  5. 5

    Při nové instalaci se správce jednou zeptá, které moduly budete používat. Zaškrtněte, co potřebujete, a pokračujte. Později to změníte tlačítkem Služby na pozadí v horní liště.

    UvidíteJednorázový seznam modulů s pamětí, kterou potřebují.

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

Než začnete 64bitový x86 a knihovna FUSE 2 (libfuse2; v Ubuntu 24.04 se balíček jmenuje libfuse2t64).

  1. 1

    Stáhněte si OpenConstructionERP_18.5.0_amd64.AppImage.

    UvidíteSoubor o velikosti asi 910 MB.

  2. 2

    Nastavte ho jako spustitelný.

    chmod +x OpenConstructionERP_18.5.0_amd64.AppImage

    UvidíteŽádný výstup.

  3. 3

    Spusťte ho.

    ./OpenConstructionERP_18.5.0_amd64.AppImage

    UvidíteÚvodní obrazovka. První spuštění trvá minutu až dvě.

  4. 4

    Přihlaste se demo účtem: e-mail demo@openconstructionerp.com, heslo DemoPass1234!. Odtud si pak můžete vytvořit vlastní účet a projekty.

    UvidíteAplikace. Demo projekty se při prvním spuštění vytvářejí na pozadí, takže seznam projektů může na chvíli hlásit, že jsou na cestě.

  5. 5

    Při nové instalaci se správce jednou zeptá, které moduly budete používat. Zaškrtněte, co potřebujete, a pokračujte. Později to změníte tlačítkem Služby na pozadí v horní liště.

    UvidíteJednorázový seznam modulů s pamětí, kterou potřebují.

Pokud vidíte zprávu

SpuštěníÚvodní obrazovka při úplně prvním spuštění zůstane minutu nebo déle.

Co to znamená Aplikace vytváří svou místní databázi. Stane se to jen jednou.

Co dělat Počkejte a nezavírejte okno. Na pomalém nebo téměř plném disku to může trvat déle. Další spuštění jsou rychlá.

Spuštění"The backend started, but the local database is not answering, so the app cannot open."Význam: serverová část se spustila, ale její místní databáze neodpovídá, a aplikaci proto nelze otevřít.

Co to znamená Místní databáze nenaběhla, často po běhu, který se neukončil čistě.

Co dělat Restartujte počítač a spusťte aplikaci znovu. Pokud se to opakuje, pošlete nám desktop-launcher.log a protokol databáze (viz Protokoly).

Spuštění"The backend started, but this installation is missing the application files it serves"Význam: serverová část se spustila, ale v instalaci chybí soubory uživatelského rozhraní.

Co to znamená Chybí část složky programu, obvykle ji odstranil antivirus.

Co dělat Zkontrolujte karanténu antiviru a pak spusťte instalátor znovu přes stávající instalaci. Vašich projektů se to nedotkne.

Spuštění"The application backend did not start in time" nebo "The application backend stopped responding while preparing the local database" (nebo u jiného kroku).

Co to znamená Spuštění trvalo déle, než aplikace čeká. Zpráva uvádí krok, ve kterém to bylo.

Co dělat Zavřete okno a spusťte znovu. Pokud je disk skoro plný, nejdřív uvolněte místo. Když se to zastaví na stejném kroku znovu, pošlete nám desktop-launcher.log.

Spuštění"The application never finished unpacking itself, so its backend never started." nebo "The application could not unpack itself into the temporary folder it uses."

Co to znamená V macOS a Linuxu aplikace při každém spuštění rozbaluje svůj backend. Zabrání tomu pomalý nebo plný disk, nebo antivirus, který soubory zamyká. (Aplikace pro Windows se od verze 18.5 už sama nerozbaluje.)

Co dělat Uvolněte místo na disku s dočasnou složkou, nebo aplikaci povolte v antiviru, a spusťte znovu.

Spuštění"The drive ran out of space while the application was starting" nebo "There is not enough free space to start the application".

Co to znamená Přesně to. Zpráva uvádí složku a zbývající volné místo.

Co dělat Uvolněte místo na tom disku a spusťte znovu.

Za provozu"The application backend stopped, restarting" a okno se znovu načte.

Co to znamená Část aplikace běžící na pozadí se neočekávaně zastavila a aplikace ji restartovala. Uložená práce zůstane. Dělá to nejvýš dvakrát za 30 minut.

Co dělat Pokračujte. Pokud se to opakuje, nebo uvidíte "The application backend has stopped", pošlete nám desktop-launcher.log a logs/backend-crash.log.

SpuštěníPři každém spuštění aplikace jste odhlášeni a jazyk se vrátí na angličtinu.

Co to znamená Jiný program používá port 8732, který aplikace běžně používá. Verze 18.5.0 pak při každém spuštění vybere náhodný volný port a okno bere každý nový port jako nový web, takže se přihlášení a jazyk nenajdou.

Co dělat Zavřete nebo překonfigurujte druhý program, který používá port 8732 (ve Windows spusťte v terminálu netstat -ano | findstr :8732 a uvidíte jeho ID procesu). Vaše projekty to neovlivní, jen přihlášení a volbu jazyka.

SpuštěníObáváte se, že aplikace koliduje s PostgreSQL, který už máte na portu 5432.

Co to znamená Nekoliduje. Vestavěná databáze si ve Windows bere náhodný volný místní port a v macOS a Linuxu naslouchá jen na místním socketu, ne na portu TCP.

Co dělat Není co dělat.

InstalaceBalíček .deb si říká o libwebkit2gtk-4.1-0, nebo dpkg hlásí nesplněné závislosti.

Co to znamená Aplikace potřebuje WebKitGTK 4.1 ke kreslení svého okna. dpkg -i závislosti neinstaluje.

Co dělat Instalujte přes sudo apt install ./OpenConstructionERP_18.5.0_amd64.deb, což knihovnu stáhne. Pokud vaše distribuce nemá libwebkit2gtk-4.1-0 (Ubuntu starší než 22.04, Debian starší než 12), použijte pip.

InstalaceAppImage po dvojkliku nic neudělá.

Co to znamená Soubor ještě není označený jako program.

Co dělat Spusťte chmod +x OpenConstructionERP_18.5.0_amd64.AppImage a spusťte ho znovu.

InstalaceChyba AppImage, která zmiňuje FUSE nebo libfuse.so.2.

Co to znamená Novější distribuce už neinstalují knihovnu FUSE 2, kterou AppImage používají.

Co dělat Nainstalujte ji (sudo apt install libfuse2, v Ubuntu 24.04 sudo apt install libfuse2t64), nebo použijte .deb, .rpm či pip.

Kde jsou protokoly

  • desktop-launcher.log~/.openestimate/desktop-launcher.logVše, co desktopová aplikace dělala při spouštění. Vždy ve vaší domovské složce, i když jste datovou složku přesunuli.
  • backend-crash.log~/.openestimate/logs/backend-crash.logPodrobnosti o neočekávaném zastavení. Leží v datové složce, takže se přesouvá s OE_DATA_DIR.
  • database log folder~/.openestimate/pgdata/logProč se vestavěná databáze nespustila.

Složku otevřete z terminálu takto:

xdg-open ~/.openestimate

pip

Balíček openconstructionerp

Než začnete Python 3.12 nebo novější. Ověřte pomocí python --version. Bez Dockeru a bez samostatné databáze: pip přinese vestavěný PostgreSQL.

Podívejte se na tento krok:
  1. 1

    Spusťte.

    pip install --upgrade openconstructionerp

    Uvidítepip stáhne balíček a jeho závislosti.

  2. 2

    Spusťte.

    openconstructionerp

    UvidíteKrátké uvítání. Při prvním spuštění se zeptá, zda načíst demo projekty a zda otevřít prohlížeč.

  3. 3

    Počkejte, než se nastaví místní databáze.

    Uvidíte"Database: embedded PostgreSQL 16 (no Docker)" a pak se spustí server. Prohlížeč otevře http://127.0.0.1:8080 (totéž jako http://localhost:8080).

  4. 4

    Přihlaste se. S demo daty můžete použít demo@openconstructionerp.com / DemoPass1234!

    UvidítePřehled.

  5. 5

    Při nové instalaci se správce jednou zeptá, které moduly budete používat. Zaškrtněte, co potřebujete, a pokračujte. Později to změníte tlačítkem Služby na pozadí v horní liště.

    UvidíteJednorázový seznam modulů s pamětí, kterou potřebují.

  6. 6

    Zastavíte ho stisknutím Ctrl+C v terminálu. Příště stačí znovu spustit openconstructionerp.

    UvidíteServer se zastaví. Vaše data zůstanou ve složce .openestimate ve vaší domovské složce.

Užitečné příkazy

Příkaz openconstructionerp se nenašel

python -m openconstructionerp

Něco nefunguje: zkontroluje Python, port, datovou složku a databázi a řekne, co dělat

openconstructionerp doctor

Port 8080 je obsazený jiným programem

openconstructionerp serve --port 8081

Ostatní počítače ve vaší síti se k tomu mají dostat

openconstructionerp serve --host 0.0.0.0 --port 8080

Musíte nám sdělit svou verzi

openconstructionerp --version

Pokud vidíte zprávu

Instalacepip hlásí, že nebyla nalezena odpovídající distribuce, nebo že vyžaduje jiný Python.

Co to znamená OpenConstructionERP vyžaduje Python 3.12 nebo novější.

Co dělat Nainstalujte Python 3.12 nebo novější a spusťte python3.12 -m pip install --upgrade openconstructionerp (ve Windows: py -3.12 -m pip install --upgrade openconstructionerp).

Instalaceerror: externally-managed-environment (Ubuntu 23.04+, Debian 12+).Význam: váš systém Linux chrání svůj vlastní Python a odmítá do něj instalovat balíčky.

Co to znamená Systémový Python nedovoluje pipu instalovat do sebe.

Co dělat Použijte pipx install openconstructionerp, nebo nejdřív vytvořte virtuální prostředí: python3 -m venv ~/oe && ~/oe/bin/pip install openconstructionerp.

Spuštění"openconstructionerp" is not recognized, nebo command not found.

Co to znamená Složka, kam pip ukládá příkazy, není ve vaší proměnné PATH (ve Windows časté).

Co dělat Spusťte místo toho python -m openconstructionerp. Funguje v každém systému, aniž byste sahali na PATH.

Spuštění"Port 8080 is already in use. Try: openconstructionerp serve --port 8081"Význam: port 8080 už používá jiný program, spusťte proto aplikaci na jiném portu, například 8081.

Co to znamená Jiný program používá port 8080.

Co dělat Spusťte navržený příkaz a otevřete adresu, kterou vypíše.

Spuštění"Embedded PostgreSQL could not start".Význam: vestavěnou databázi PostgreSQL se nepodařilo spustit.

Co to znamená Vestavěná databáze se nespustila. Zpráva vypíše cestu k jejímu protokolu.

Co dělat Spusťte openconstructionerp doctor. Pokud to nepomůže, přeinstalujte pomocí pip install --upgrade --force-reinstall openconstructionerp a pošlete nám protokol, který uvede.

Kde jsou protokoly

  • terminal outputthe terminal window (pip); docker compose logs app (Docker)U pipu a Dockeru zkopírujte, co terminál vypsal, a výstup příkazu openconstructionerp doctor.

Docker

Balíček ghcr.io/datadrivenconstruction/openconstructionerp (tags 18.5.0, 18.5, latest; linux/amd64)

Než začnete Docker s Docker Compose. Publikovaný image je sestavený pro x86-64 (amd64). Na Apple Silicon nebo jiných strojích ARM sestavte ze zdrojů (make quickstart) nebo použijte pip. Příkazy níže jsou pro shell bash (Linux, macOS, nebo Git Bash či WSL ve Windows). Windows PowerShell nemá openssl a zapisuje soubory ve formátu, který compose nepřečte.

  1. 1

    V prázdné složce stáhněte dva soubory compose.

    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

    UvidíteDva soubory ve složce.

  2. 2

    Jednou vytvořte soubor s tajnými klíči.

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

    UvidíteSoubor .env. Uschovejte ho: obsahuje heslo k databázi a tajný klíč přihlášení.

  3. 3

    Spusťte to.

    docker compose pull app && docker compose up -d

    UvidíteSpustí se dva kontejnery: postgres a app.

  4. 4

    Otevřete http://localhost:8080 a přihlaste se jako demo@openconstructionerp.com / DemoPass1234!

    UvidítePřihlašovací stránka. První spuštění může trvat minutu, než se připraví databáze.

  5. 5

    Při nové instalaci se správce jednou zeptá, které moduly budete používat. Zaškrtněte, co potřebujete, a pokračujte. Později to změníte tlačítkem Služby na pozadí v horní liště.

    UvidíteJednorázový seznam modulů s pamětí, kterou potřebují.

Užitečné příkazy

Ověřte, že oba kontejnery běží a jsou v pořádku

docker compose ps

Zjistěte, proč se aplikace nespustí

docker compose logs app

Port 8080 na vašem počítači je obsazený

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

Toto nastavení compose je pro vyzkoušení a lokální použití. Pro produkční server viz docs/INSTALL_LINUX.md a docker-compose.prod.yml v repozitáři.

Pokud vidíte zprávu

SpuštěníCompose se zastaví s hláškou "POSTGRES_PASSWORD must be set" nebo "JWT_SECRET must be set".

Co to znamená Soubor .env se dvěma tajnými klíči chybí, nebo není ve stejné složce.

Co dělat Vytvořte soubor .env jako v kroku 2, ve složce s docker-compose.yml.

Spuštěníhttp://localhost:8080 se neotevře.

Co to znamená Kontejner ještě neběží, nebo je obsazený port 8080.

Co dělat Spusťte docker compose ps a docker compose logs app. Pro jiný port: OE_PORT=8081 OE_ALLOWED_ORIGINS=http://localhost:8081 docker compose up -d a pak otevřete http://localhost:8081.

InstalaceNa Macu s Apple Silicon nebo jiném stroji ARM Docker upozorní, že platforma image linux/amd64 nesouhlasí, nebo aplikace běží velmi pomalu.

Co to znamená Publikovaný image je sestavený jen pro x86-64.

Co dělat Sestavte ze zdrojů pomocí make quickstart, nebo použijte pip.

Kde jsou protokoly

  • terminal outputthe terminal window (pip); docker compose logs app (Docker)U pipu a Dockeru zkopírujte, co terminál vypsal, a výstup příkazu openconstructionerp doctor.

Vaše data, aktualizace a odinstalace

Aktualizace

Novou verzi nainstalujte přes starou. Složka .openestimate není součástí programu, takže projekty, uživatelé a nastavení zůstanou. První spuštění po aktualizaci může trvat déle, než se databáze sama aktualizuje.

Odinstalace

Odinstalace odstraní program a vaše projekty nechá. Ve Windows nabízí odinstalátor "Delete the application data" (v jazyce instalátoru): to smaže jen přihlášení a jazyk uložené oknem aplikace (v %APPDATA% a %LOCALAPPDATA%\io.openconstructionerp.desktop), ne vaše projekty. Chcete-li začít od nuly, odinstalujte, zkopírujte .openestimate na bezpečné místo a pak složku smažte.

Záloha

Zavřete aplikaci a zkopírujte složku .openestimate (a složku ProgramData uvedenou v pgdata.location, pokud existuje).

Pořád nevíte? Pomůžeme vám

Přiložte prosím:

GitHub Issues GitHub Discussions info@datadrivenconstruction.io

Soubory protokolů mohou obsahovat vaše uživatelské jméno a názvy složek. Než je zveřejníte, projděte je; pokud chcete, pošlete je e-mailem.

Další kroky po instalaci

Nainstalováno a přihlášeno? Pusťte si tato videa popořadě. Každé je krátké a ukazuje skutečnou aplikaci.

  1. První kroky po instalaci

    Druhá polovina videa o instalaci: první spuštění, jazyk a region, moduly, uživatelé, váš první projekt.

  2. Celý produkt

    Také se hodí

    Prohlídka produktu: BOQ, BIM, DWG, výkaz výměr z PDF a rozpočtování s AI

    12:01 minuty, natočeno s dřívější verzí. Ukazuje i instalaci přes pip.

    Krátká prohlídka, 2:37: jedna budova, jeden zdroj pravdy

  3. Základy rozpočtování

    Builder's Playbook: Getting Started3 videaZačněte tady: databáze nákladů a jednotkové ceny, rozpočet krok za krokem, režie, zisk a rezerva (USA).

  4. Váš trh od začátku do konce

    Builder's Playbook UK: Construction in England6 videí · ENObchodní řízení ve Spojeném království: oceňování nabídky podle NRM 2, porovnání nabídek, platby JCT a zádržné, pay less notices, CIS a přenesená daňová povinnost u DPH, změny.Builder's Playbook: Canada6 videí · ENKanada/Ontario: oceňování, poptávková řízení na subdodávky, dílčí platby CCDC 2, včasná platba (prompt payment), změnové příkazy, podstatné dokončení.Builder's Playbook: Québec5 videí · FRQuébec ve francouzštině: první kroky, rozpočtování, soutěže BSDQ, fakturace se zádržným a zákonným zástavním právem, převzetí a vady.OpenConstructionERP auf Deutsch: vom Projektstart bis zur Übergabe8 videí · DENěmecká řada od nastavení projektu přes výkresy/RFI, výměry, kontroly BIM, LV, jednotkové ceny a GAEB X83/X84 až po zadání zakázky (číslováno /12, zveřejněno 8).Builder's Playbook Hrvatska: gradnja u Hrvatskoj5 videí · HRChorvatsko: import smluvního BOQ z Excelu, přijaté faktury, subdodavatelé, průběžné fakturace, finanční stav a vícepráce.

  5. Řízení stavby: rozpočet, nákup, hodiny, faktury

    OpenConstructionERP en français: gérer un chantier4 videa · FRŘízení stavby ve francouzštině: rozpočet, nákup a sklad, hodiny a technika, faktury a platby.

Všechny playlisty na kanálu OpenConstruction Academy

Úplný text je také na GitHubu v jazycích English, Deutsch a Русский.