Aiuto per l'installazione

Installare OpenConstructionERP

Scegli come vuoi usarlo, segui i passaggi numerati e, se qualcosa non torna, cerca il messaggio che vedi nell'elenco dei problemi più sotto. Nessuno degli avvisi durante l'installazione mette a rischio i tuoi progetti.

Non sai quale ti serve?

Guarda prima

Come installare OpenConstructionERP

Video guida su Windows, registrata con la versione 17.7.1. Alcune schermate sono diverse nella 18.5 e l’attesa durante l’installazione è accorciata nel video.

Durata 4:41 · Guarda su YouTube

Windows

OpenConstructionERP_18.5.0_x64-setup.execirca 800 MB

Prima di iniziare Windows 10 o 11, 64 bit. Permessi di amministratore (l'app si installa per tutti gli utenti). Durante l'installazione non serve internet: il componente per la finestra (Microsoft WebView2) è dentro il programma di installazione.

Guarda questo passaggio:
  1. 1

    Scarica OpenConstructionERP_18.5.0_x64-setup.exe dalla pagina della versione.

    VedraiUn file di circa 800 MB nella cartella Download.

  2. 2

    Fai doppio clic. Se una finestra blu dice "Windows ha protetto il PC", clicca su Ulteriori informazioni, controlla che il nome del file inizi con OpenConstructionERP, poi clicca su Esegui comunque.

    VedraiWindows chiede i permessi di amministratore. Clicca su Sì.

  3. 3

    Scegli la lingua del programma di installazione, accetta la licenza e lascia la cartella proposta C:\Program Files\OpenConstructionERP.

    VedraiUna barra di avanzamento, poi una pagina finale.

  4. 4

    Clicca su Fine, oppure avvia OpenConstructionERP dal menu Start.

    VedraiUna schermata di caricamento "Avvio dell'applicazione" con un elenco: avvio del backend, avvio del database locale, preparazione del database, avvio del server applicativo, apertura dell'app.

  5. 5

    Aspetta al primissimo avvio. Non chiudere la finestra.

    Vedrai"Il primo avvio configura il database locale. Può richiedere uno o due minuti, attendere." Gli avvii successivi sono molto più rapidi.

  6. 6

    Scegli come aprirla: in una finestra dell'app (consigliato) o nel tuo browser abituale.

    Vedrai"Come vuoi aprire OpenConstructionERP?" e poi la pagina di accesso.

  7. 7

    Accedi con l'account demo: email demo@openconstructionerp.com, password DemoPass1234!. Da lì puoi creare il tuo account e i tuoi progetti.

    VedraiL'app. I progetti demo vengono creati in background al primo avvio, quindi per un attimo l'elenco dei progetti può dire che stanno arrivando.

  8. 8

    Con un'installazione nuova all'amministratore viene chiesto una volta quali moduli userai. Spunta quelli che ti servono e continua. Puoi cambiare scelta più tardi con il pulsante Servizi in background nella barra in alto.

    VedraiUn elenco una tantum dei moduli con la memoria che richiedono.

Se vedi un messaggio

InstallazioneUna finestra blu "Windows ha protetto il PC".

Significa Il programma di installazione non è ancora firmato digitalmente, quindi Windows non conosce l'editore. È un avviso, non il rilevamento di un virus.

Cosa fare Clicca su Ulteriori informazioni, controlla che il nome del file inizi con OpenConstructionERP, poi clicca su Esegui comunque.

InstallazioneIl Controllo intelligente delle app (Smart App Control) ha bloccato l'app, senza un pulsante per continuare.

Significa Il Controllo intelligente delle app di Windows 11 rifiuta i programmi non firmati.

Cosa fare Il Controllo intelligente delle app non può consentire una singola app. Per lasciarlo attivo, esegui OpenConstructionERP con Docker Desktop o in WSL (il Linux integrato in Windows), che il Controllo intelligente delle app non controlla. Istruzioni passo passo: docs/desktop/WINDOWS_BLOCKED.md nel repository.

Installazione"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" (il messaggio esiste solo in inglese)Significato: il percorso della cartella di installazione può contenere solo lettere latine, cifre e spazi, perché il database integrato non può avviarsi da nessun altro percorso.

Significa La cartella scelta ha nel percorso lettere cirilliche, cinesi, accentate o di altri alfabeti non latini.

Cosa fare Lascia la cartella proposta C:\Program Files\OpenConstructionERP, oppure scegli una cartella come C:\OpenConstructionERP. Un'installazione silenziosa (/S) termina con il codice 3 e scrive il motivo in %TEMP%\OpenConstructionERP-install-error.log.

InstallazioneIl programma di installazione si ferma con un errore su WebView2.

Significa Windows ha rifiutato di installare Microsoft WebView2, il componente che disegna la finestra dell'app. È incluso nel programma di installazione, quindi non serve internet; l'errore viene da Windows stesso (criteri, un aggiornamento in sospeso o un WebView2 precedente danneggiato).

Cosa fare Riavvia il computer ed esegui di nuovo il programma di installazione. Se fallisce ancora, installa "Microsoft Edge WebView2 Runtime" da Microsoft, poi esegui ancora il nostro programma di installazione.

InstallazioneIl tuo antivirus elimina o mette in quarantena un file durante l'installazione o al primo avvio.

Significa Il programma è nuovo e non firmato, e alcuni antivirus lo trovano sospetto.

Cosa fare Ripristina il file dalla quarantena e aggiungi queste due cartelle alle esclusioni: la cartella del programma C:\Program Files\OpenConstructionERP e la tua cartella dati C:\Users\<your name>\.openestimate. Poi esegui di nuovo il programma di installazione sopra l'installazione esistente. Se non sei sicuro che il file sia autentico, scrivici prima.

AggiornamentoUna schermata che chiede se sovrascrivere la versione installata o rimuoverla prima, con una riga che suggerisce di rimuoverla.

Cosa fare Lascia l'opzione già selezionata (sovrascrivi). I tuoi progetti vengono mantenuti. Il primo avvio dopo un aggiornamento può richiedere di più mentre il database si aggiorna.

AggiornamentoEsegui OpenConstructionERP anche con pip o da un terminale sullo stesso computer, e si ferma durante l'aggiornamento.

Significa Entrambi usano la stessa cartella .openestimate e lo stesso database. Il programma di installazione ferma quel database per sostituire il programma. Aggiornando dalla 18.4.0, il vecchio programma di disinstallazione chiude anche qualsiasi programma chiamato openconstructionerp.exe.

Cosa fare Ferma la versione da terminale (Ctrl+C) prima di installare o aggiornare e riavviala dopo.

AvvioLa schermata di caricamento resta per un minuto o più al primissimo avvio.

Significa L'app sta creando il suo database locale. Succede una volta sola.

Cosa fare Aspetta e non chiudere la finestra. Con un disco lento o quasi pieno può richiedere di più. Gli avvii successivi sono veloci.

AvvioUna finestra "OpenConstructionERP failed to start" che indica un file di log.

Significa L'app non è riuscita ad aprire la sua finestra.

Cosa fare Avviala ancora una volta. Se la finestra ricompare, mandaci il file di log che indica.

Avvio"The backend started, but the local database is not answering, so the app cannot open."Significato: la parte server è stata avviata, ma il suo database locale non risponde, quindi l'app non può aprirsi.

Significa Il database locale non è partito, spesso dopo un'esecuzione che non si è chiusa correttamente.

Cosa fare Riavvia il computer e riavvia l'app. Se si ripete, mandaci desktop-launcher.log e il log del database (vedi Log).

Avvio"The backend started, but this installation is missing the application files it serves"Significato: la parte server è stata avviata, ma nell'installazione mancano i file dell'interfaccia utente.

Significa Manca una parte della cartella del programma, di solito rimossa dall'antivirus.

Cosa fare Controlla la quarantena dell'antivirus, poi esegui di nuovo il programma di installazione sopra l'installazione esistente. I tuoi progetti non vengono toccati.

Avvio"The application backend did not start in time", oppure "The application backend stopped responding while preparing the local database" (o in un altro passaggio).

Significa L'avvio ha richiesto più tempo di quanto l'app aspetti. Il messaggio indica il passaggio in cui si trovava.

Cosa fare Chiudi la finestra e riavvia. Libera prima un po' di spazio sul disco se è quasi pieno. Se si ferma di nuovo allo stesso passaggio, mandaci desktop-launcher.log.

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

Significa Proprio questo. Il messaggio indica la cartella e lo spazio libero rimasto.

Cosa fare Libera spazio su quell'unità e riavvia.

AvvioUn messaggio che dice che la cartella del database locale "sits too deep in the filesystem", con due numeri.

Significa Windows limita la lunghezza dei percorsi e il percorso della tua cartella dati è troppo lungo per i file del database. Attivare i percorsi lunghi in Windows non aiuta.

Cosa fare Imposta la variabile d'ambiente utente OE_DATA_DIR su un percorso breve come C:\OpenConstructionERP\data (Start, scrivi "variabili d'ambiente", Modifica le variabili d'ambiente relative all'account, Nuova), poi riavvia.

AvvioIl tuo nome utente Windows ha lettere non latine (per esempio cirilliche o cinesi) e cerchi il tuo database.

Significa Il database integrato non può funzionare da un percorso così, quindi dalla 18.5.0 l'app tiene il database in C:\ProgramData\OpenConstructionERP\clusters\<id>\pgdata. Prima della 18.5.0 l'app non si avviava affatto con questi account.

Cosa fare Non c'è niente da sistemare. Il file pgdata.location nella tua cartella .openestimate indica la cartella esatta del database. Per i backup copia entrambe le cartelle.

In esecuzione"The application backend stopped, restarting" e la finestra si ricarica.

Significa La parte in background dell'app si è fermata all'improvviso e l'app l'ha riavviata. Il lavoro salvato resta. Succede al massimo due volte in 30 minuti.

Cosa fare Vai avanti. Se si ripete, o vedi "The application backend has stopped", mandaci desktop-launcher.log e logs/backend-crash.log.

AvvioA ogni avvio dell'app vieni disconnesso e la lingua torna all'inglese.

Significa Un altro programma usa la porta 8732, quella che l'app usa normalmente. La versione 18.5.0 sceglie allora una porta libera a caso a ogni avvio, e la finestra tratta ogni nuova porta come un sito nuovo, quindi accesso e lingua non vengono ritrovati.

Cosa fare Chiudi o riconfigura l'altro programma che usa la porta 8732 (su Windows, esegui netstat -ano | findstr :8732 in un terminale per vedere il suo ID processo). I tuoi progetti non sono toccati, solo l'accesso e la scelta della lingua.

AvvioTemi che l'app vada in conflitto con un PostgreSQL che hai già sulla porta 5432.

Significa Non va in conflitto. Su Windows il database integrato prende una porta locale libera a caso, e su macOS e Linux ascolta solo su un socket locale, non su una porta TCP.

Cosa fare Non c'è nulla da fare.

Dove sono i log

  • desktop-launcher.logC:\Users\<your name>\.openestimate\desktop-launcher.logTutto quello che l'app desktop ha fatto all'avvio. Sempre nella tua cartella home, anche se hai spostato la cartella dati.
  • backend-crash.logC:\Users\<your name>\.openestimate\logs\backend-crash.logDettagli di un arresto imprevisto. Sta nella cartella dati, quindi si sposta con OE_DATA_DIR.
  • database log folderC:\Users\<your name>\.openestimate\pgdata\log (or <folder from pgdata.location>\log)Perché il database integrato non è partito.
  • OpenConstructionERP-install-error.log%TEMP%\OpenConstructionERP-install-error.log (digita %TEMP% nella barra degli indirizzi di Esplora risorse)Perché il programma di installazione di Windows ha rifiutato la cartella di installazione.

Per aprire la cartella, incolla questo nella barra degli indirizzi di Esplora file:

%USERPROFILE%\.openestimate

macOS

OpenConstructionERP_18.5.0_aarch64.dmgcirca 640 MB

Prima di iniziare Un Mac con Apple Silicon (M1 o successivo). Non c'è una versione per i Mac Intel; su un Mac Intel usa pip o Docker.

  1. 1

    Scarica OpenConstructionERP_18.5.0_aarch64.dmg e aprilo.

    VedraiUna finestra con l'icona dell'app OpenConstructionERP.

  2. 2

    Trascina OpenConstructionERP in Applicazioni.

    VedraiL'app compare nella cartella Applicazioni.

  3. 3

    Apri Terminale una volta ed esegui.

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

    VedraiNessun output. È corretto. Questo comando toglie il contrassegno di download, perché l'app non è ancora autenticata (notarized) da Apple.

  4. 4

    Apri OpenConstructionERP da Applicazioni.

    VedraiLa schermata di caricamento "Avvio dell'applicazione". Il primo avvio prepara il database locale e richiede uno o due minuti.

  5. 5

    Scegli finestra dell'app o browser.

    VedraiLa pagina di accesso.

  6. 6

    Accedi con l'account demo: email demo@openconstructionerp.com, password DemoPass1234!. Da lì puoi creare il tuo account e i tuoi progetti.

    VedraiL'app. I progetti demo vengono creati in background al primo avvio, quindi per un attimo l'elenco dei progetti può dire che stanno arrivando.

  7. 7

    Con un'installazione nuova all'amministratore viene chiesto una volta quali moduli userai. Spunta quelli che ti servono e continua. Puoi cambiare scelta più tardi con il pulsante Servizi in background nella barra in alto.

    VedraiUn elenco una tantum dei moduli con la memoria che richiedono.

Se vedi un messaggio

AvvioLa schermata di caricamento resta per un minuto o più al primissimo avvio.

Significa L'app sta creando il suo database locale. Succede una volta sola.

Cosa fare Aspetta e non chiudere la finestra. Con un disco lento o quasi pieno può richiedere di più. Gli avvii successivi sono veloci.

Avvio"The backend started, but the local database is not answering, so the app cannot open."Significato: la parte server è stata avviata, ma il suo database locale non risponde, quindi l'app non può aprirsi.

Significa Il database locale non è partito, spesso dopo un'esecuzione che non si è chiusa correttamente.

Cosa fare Riavvia il computer e riavvia l'app. Se si ripete, mandaci desktop-launcher.log e il log del database (vedi Log).

Avvio"The backend started, but this installation is missing the application files it serves"Significato: la parte server è stata avviata, ma nell'installazione mancano i file dell'interfaccia utente.

Significa Manca una parte della cartella del programma, di solito rimossa dall'antivirus.

Cosa fare Controlla la quarantena dell'antivirus, poi esegui di nuovo il programma di installazione sopra l'installazione esistente. I tuoi progetti non vengono toccati.

Avvio"The application backend did not start in time", oppure "The application backend stopped responding while preparing the local database" (o in un altro passaggio).

Significa L'avvio ha richiesto più tempo di quanto l'app aspetti. Il messaggio indica il passaggio in cui si trovava.

Cosa fare Chiudi la finestra e riavvia. Libera prima un po' di spazio sul disco se è quasi pieno. Se si ferma di nuovo allo stesso passaggio, mandaci desktop-launcher.log.

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

Significa Su macOS e Linux l'app decomprime il suo backend a ogni avvio. Un disco lento o pieno, o un antivirus che blocca i file, lo impedisce. (L'app per Windows non si decomprime più dalla 18.5.)

Cosa fare Libera spazio sull'unità con la tua cartella temporanea, oppure consenti l'app nel tuo antivirus, poi riavvia.

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

Significa Proprio questo. Il messaggio indica la cartella e lo spazio libero rimasto.

Cosa fare Libera spazio su quell'unità e riavvia.

In esecuzione"The application backend stopped, restarting" e la finestra si ricarica.

Significa La parte in background dell'app si è fermata all'improvviso e l'app l'ha riavviata. Il lavoro salvato resta. Succede al massimo due volte in 30 minuti.

Cosa fare Vai avanti. Se si ripete, o vedi "The application backend has stopped", mandaci desktop-launcher.log e logs/backend-crash.log.

AvvioA ogni avvio dell'app vieni disconnesso e la lingua torna all'inglese.

Significa Un altro programma usa la porta 8732, quella che l'app usa normalmente. La versione 18.5.0 sceglie allora una porta libera a caso a ogni avvio, e la finestra tratta ogni nuova porta come un sito nuovo, quindi accesso e lingua non vengono ritrovati.

Cosa fare Chiudi o riconfigura l'altro programma che usa la porta 8732 (su Windows, esegui netstat -ano | findstr :8732 in un terminale per vedere il suo ID processo). I tuoi progetti non sono toccati, solo l'accesso e la scelta della lingua.

AvvioTemi che l'app vada in conflitto con un PostgreSQL che hai già sulla porta 5432.

Significa Non va in conflitto. Su Windows il database integrato prende una porta locale libera a caso, e su macOS e Linux ascolta solo su un socket locale, non su una porta TCP.

Cosa fare Non c'è nulla da fare.

Installazione"“OpenConstructionERP” è danneggiato e non può essere aperto."

Significa L'app non è ancora autenticata (notarized) da Apple e porta ancora il contrassegno di download. L'app non è danneggiata.

Cosa fare Serve solo questo: in Terminale esegui una volta xattr -dr com.apple.quarantine /Applications/OpenConstructionERP.app, poi apri l'app normalmente.

Installazione"Impossibile aprire “OpenConstructionERP” perché lo sviluppatore non può essere verificato" (oppure Apple non ha potuto verificare che sia privo di malware).

Significa L'app ha una firma ad hoc ma non è ancora autenticata (notarized) da Apple.

Cosa fare Esegui lo stesso comando xattr, oppure apri Impostazioni di Sistema, Privacy e sicurezza, scorri in basso e clicca su Apri comunque. Lo fai solo una volta.

InstallazioneL'app non si avvia affatto sul tuo Mac.

Significa La versione per Mac è solo per Apple Silicon (M1 e successivi). Non c'è una versione Intel.

Cosa fare Su un Mac Intel usa pip (Python 3.12 o più recente) o Docker.

Dove sono i log

  • desktop-launcher.log~/.openestimate/desktop-launcher.logTutto quello che l'app desktop ha fatto all'avvio. Sempre nella tua cartella home, anche se hai spostato la cartella dati.
  • backend-crash.log~/.openestimate/logs/backend-crash.logDettagli di un arresto imprevisto. Sta nella cartella dati, quindi si sposta con OE_DATA_DIR.
  • database log folder~/.openestimate/pgdata/logPerché il database integrato non è partito.

Per aprire la cartella da un terminale:

open ~/.openestimate

Linux

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

Prima di iniziare x86 a 64 bit (amd64). Il pacchetto richiede libwebkit2gtk-4.1-0, che apt installa per te. Compilato su Ubuntu 22.04, quindi Ubuntu 22.04 o successivo e Debian 12 o successivo sono la scelta sicura.

  1. 1

    Scarica OpenConstructionERP_18.5.0_amd64.deb.

    VedraiUn file di circa 830 MB.

  2. 2

    In un terminale, nella cartella dei download, esegui.

    sudo apt install ./OpenConstructionERP_18.5.0_amd64.deb

    Vedraiapt elenca il pacchetto e le librerie che servono, poi li installa. Il ./ davanti al nome del file è importante.

  3. 3

    Avvia OpenConstructionERP dal menu delle applicazioni.

    VedraiLa schermata di caricamento. Il primo avvio richiede uno o due minuti.

  4. 4

    Accedi con l'account demo: email demo@openconstructionerp.com, password DemoPass1234!. Da lì puoi creare il tuo account e i tuoi progetti.

    VedraiL'app. I progetti demo vengono creati in background al primo avvio, quindi per un attimo l'elenco dei progetti può dire che stanno arrivando.

  5. 5

    Con un'installazione nuova all'amministratore viene chiesto una volta quali moduli userai. Spunta quelli che ti servono e continua. Puoi cambiare scelta più tardi con il pulsante Servizi in background nella barra in alto.

    VedraiUn elenco una tantum dei moduli con la memoria che richiedono.

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

Prima di iniziare x86 a 64 bit. Il pacchetto richiede la libreria WebKitGTK 4.1, che il gestore di pacchetti installa per te.

  1. 1

    Scarica OpenConstructionERP-18.5.0-1.x86_64.rpm.

    VedraiUn file di circa 850 MB.

  2. 2

    Esegui.

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

    Vedraidnf risolve le dipendenze e installa.

  3. 3

    Avvia OpenConstructionERP dal menu delle applicazioni.

    VedraiLa schermata di caricamento. Il primo avvio richiede uno o due minuti.

  4. 4

    Accedi con l'account demo: email demo@openconstructionerp.com, password DemoPass1234!. Da lì puoi creare il tuo account e i tuoi progetti.

    VedraiL'app. I progetti demo vengono creati in background al primo avvio, quindi per un attimo l'elenco dei progetti può dire che stanno arrivando.

  5. 5

    Con un'installazione nuova all'amministratore viene chiesto una volta quali moduli userai. Spunta quelli che ti servono e continua. Puoi cambiare scelta più tardi con il pulsante Servizi in background nella barra in alto.

    VedraiUn elenco una tantum dei moduli con la memoria che richiedono.

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

Prima di iniziare x86 a 64 bit e la libreria FUSE 2 (libfuse2; su Ubuntu 24.04 il pacchetto è libfuse2t64).

  1. 1

    Scarica OpenConstructionERP_18.5.0_amd64.AppImage.

    VedraiUn file di circa 910 MB.

  2. 2

    Rendilo eseguibile.

    chmod +x OpenConstructionERP_18.5.0_amd64.AppImage

    VedraiNessun output.

  3. 3

    Eseguilo.

    ./OpenConstructionERP_18.5.0_amd64.AppImage

    VedraiLa schermata di caricamento. Il primo avvio richiede uno o due minuti.

  4. 4

    Accedi con l'account demo: email demo@openconstructionerp.com, password DemoPass1234!. Da lì puoi creare il tuo account e i tuoi progetti.

    VedraiL'app. I progetti demo vengono creati in background al primo avvio, quindi per un attimo l'elenco dei progetti può dire che stanno arrivando.

  5. 5

    Con un'installazione nuova all'amministratore viene chiesto una volta quali moduli userai. Spunta quelli che ti servono e continua. Puoi cambiare scelta più tardi con il pulsante Servizi in background nella barra in alto.

    VedraiUn elenco una tantum dei moduli con la memoria che richiedono.

Se vedi un messaggio

AvvioLa schermata di caricamento resta per un minuto o più al primissimo avvio.

Significa L'app sta creando il suo database locale. Succede una volta sola.

Cosa fare Aspetta e non chiudere la finestra. Con un disco lento o quasi pieno può richiedere di più. Gli avvii successivi sono veloci.

Avvio"The backend started, but the local database is not answering, so the app cannot open."Significato: la parte server è stata avviata, ma il suo database locale non risponde, quindi l'app non può aprirsi.

Significa Il database locale non è partito, spesso dopo un'esecuzione che non si è chiusa correttamente.

Cosa fare Riavvia il computer e riavvia l'app. Se si ripete, mandaci desktop-launcher.log e il log del database (vedi Log).

Avvio"The backend started, but this installation is missing the application files it serves"Significato: la parte server è stata avviata, ma nell'installazione mancano i file dell'interfaccia utente.

Significa Manca una parte della cartella del programma, di solito rimossa dall'antivirus.

Cosa fare Controlla la quarantena dell'antivirus, poi esegui di nuovo il programma di installazione sopra l'installazione esistente. I tuoi progetti non vengono toccati.

Avvio"The application backend did not start in time", oppure "The application backend stopped responding while preparing the local database" (o in un altro passaggio).

Significa L'avvio ha richiesto più tempo di quanto l'app aspetti. Il messaggio indica il passaggio in cui si trovava.

Cosa fare Chiudi la finestra e riavvia. Libera prima un po' di spazio sul disco se è quasi pieno. Se si ferma di nuovo allo stesso passaggio, mandaci desktop-launcher.log.

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

Significa Su macOS e Linux l'app decomprime il suo backend a ogni avvio. Un disco lento o pieno, o un antivirus che blocca i file, lo impedisce. (L'app per Windows non si decomprime più dalla 18.5.)

Cosa fare Libera spazio sull'unità con la tua cartella temporanea, oppure consenti l'app nel tuo antivirus, poi riavvia.

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

Significa Proprio questo. Il messaggio indica la cartella e lo spazio libero rimasto.

Cosa fare Libera spazio su quell'unità e riavvia.

In esecuzione"The application backend stopped, restarting" e la finestra si ricarica.

Significa La parte in background dell'app si è fermata all'improvviso e l'app l'ha riavviata. Il lavoro salvato resta. Succede al massimo due volte in 30 minuti.

Cosa fare Vai avanti. Se si ripete, o vedi "The application backend has stopped", mandaci desktop-launcher.log e logs/backend-crash.log.

AvvioA ogni avvio dell'app vieni disconnesso e la lingua torna all'inglese.

Significa Un altro programma usa la porta 8732, quella che l'app usa normalmente. La versione 18.5.0 sceglie allora una porta libera a caso a ogni avvio, e la finestra tratta ogni nuova porta come un sito nuovo, quindi accesso e lingua non vengono ritrovati.

Cosa fare Chiudi o riconfigura l'altro programma che usa la porta 8732 (su Windows, esegui netstat -ano | findstr :8732 in un terminale per vedere il suo ID processo). I tuoi progetti non sono toccati, solo l'accesso e la scelta della lingua.

AvvioTemi che l'app vada in conflitto con un PostgreSQL che hai già sulla porta 5432.

Significa Non va in conflitto. Su Windows il database integrato prende una porta locale libera a caso, e su macOS e Linux ascolta solo su un socket locale, non su una porta TCP.

Cosa fare Non c'è nulla da fare.

InstallazioneIl .deb chiede libwebkit2gtk-4.1-0, oppure dpkg segnala dipendenze non soddisfatte.

Significa L'app ha bisogno di WebKitGTK 4.1 per disegnare la sua finestra. dpkg -i non installa le dipendenze.

Cosa fare Installa con sudo apt install ./OpenConstructionERP_18.5.0_amd64.deb, che porta con sé la libreria. Se la tua distribuzione non ha libwebkit2gtk-4.1-0 (Ubuntu precedente alla 22.04, Debian precedente alla 12), usa pip.

InstallazioneL'AppImage non fa niente quando fai doppio clic.

Significa Il file non è ancora contrassegnato come programma.

Cosa fare Esegui chmod +x OpenConstructionERP_18.5.0_amd64.AppImage e avvialo di nuovo.

InstallazioneUn errore di AppImage che cita FUSE o libfuse.so.2.

Significa Le distribuzioni recenti non installano più la libreria FUSE 2 che usano le AppImage.

Cosa fare Installala (sudo apt install libfuse2, su Ubuntu 24.04 sudo apt install libfuse2t64), oppure usa il .deb, il .rpm o pip.

Dove sono i log

  • desktop-launcher.log~/.openestimate/desktop-launcher.logTutto quello che l'app desktop ha fatto all'avvio. Sempre nella tua cartella home, anche se hai spostato la cartella dati.
  • backend-crash.log~/.openestimate/logs/backend-crash.logDettagli di un arresto imprevisto. Sta nella cartella dati, quindi si sposta con OE_DATA_DIR.
  • database log folder~/.openestimate/pgdata/logPerché il database integrato non è partito.

Per aprire la cartella da un terminale:

xdg-open ~/.openestimate

pip

Pacchetto openconstructionerp

Prima di iniziare Python 3.12 o più recente. Controlla con python --version. Niente Docker e nessun database separato: pip porta con sé un PostgreSQL integrato.

Guarda questo passaggio:
  1. 1

    Esegui.

    pip install --upgrade openconstructionerp

    Vedraipip scarica il pacchetto e le sue dipendenze.

  2. 2

    Esegui.

    openconstructionerp

    VedraiUn breve benvenuto. Alla prima esecuzione chiede se caricare i progetti demo e se aprire il browser.

  3. 3

    Aspetta mentre prepara il database locale.

    Vedrai"Database: embedded PostgreSQL 16 (no Docker)" e poi parte il server. Il browser apre http://127.0.0.1:8080 (è lo stesso di http://localhost:8080).

  4. 4

    Accedi. Con i dati demo puoi usare demo@openconstructionerp.com / DemoPass1234!

    VedraiLa dashboard.

  5. 5

    Con un'installazione nuova all'amministratore viene chiesto una volta quali moduli userai. Spunta quelli che ti servono e continua. Puoi cambiare scelta più tardi con il pulsante Servizi in background nella barra in alto.

    VedraiUn elenco una tantum dei moduli con la memoria che richiedono.

  6. 6

    Per fermarlo, premi Ctrl+C nel terminale. La volta dopo esegui di nuovo openconstructionerp.

    VedraiIl server si ferma. I tuoi dati restano nella cartella .openestimate della tua cartella home.

Comandi utili

Il comando openconstructionerp non viene trovato

python -m openconstructionerp

Qualcosa non funziona: controlla Python, la porta, la cartella dati e il database e dice cosa fare

openconstructionerp doctor

La porta 8080 è occupata da un altro programma

openconstructionerp serve --port 8081

Gli altri computer della tua rete devono poterlo raggiungere

openconstructionerp serve --host 0.0.0.0 --port 8080

Devi dirci la tua versione

openconstructionerp --version

Se vedi un messaggio

Installazionepip dice che non è stata trovata nessuna distribuzione corrispondente, oppure che serve un'altra versione di Python.

Significa OpenConstructionERP richiede Python 3.12 o più recente.

Cosa fare Installa Python 3.12 o più recente ed esegui python3.12 -m pip install --upgrade openconstructionerp (su Windows: py -3.12 -m pip install --upgrade openconstructionerp).

Installazioneerror: externally-managed-environment (Ubuntu 23.04+, Debian 12+).Significato: il tuo sistema Linux protegge il proprio Python e rifiuta di installarvi pacchetti.

Significa Il Python di sistema non permette a pip di installare al suo interno.

Cosa fare Usa pipx install openconstructionerp, oppure crea prima un ambiente virtuale: python3 -m venv ~/oe && ~/oe/bin/pip install openconstructionerp.

Avvio"openconstructionerp" is not recognized, oppure command not found.

Significa La cartella dove pip mette i comandi non è nel tuo PATH (frequente su Windows).

Cosa fare Esegui invece python -m openconstructionerp. Funziona su qualsiasi sistema senza toccare il PATH.

Avvio"Port 8080 is already in use. Try: openconstructionerp serve --port 8081"Significato: un altro programma sta già usando la porta 8080, quindi avvia l'app su un'altra porta, ad esempio 8081.

Significa Un altro programma usa la porta 8080.

Cosa fare Esegui il comando suggerito e apri l'indirizzo che mostra.

Avvio"Embedded PostgreSQL could not start".Significato: non è stato possibile avviare il database PostgreSQL integrato.

Significa Il database integrato non è partito. Il messaggio mostra il percorso del suo log.

Cosa fare Esegui openconstructionerp doctor. Se non basta, reinstalla con pip install --upgrade --force-reinstall openconstructionerp e mandaci il log indicato.

Dove sono i log

  • terminal outputthe terminal window (pip); docker compose logs app (Docker)Per pip e Docker, copia ciò che ha stampato il terminale e l'output di openconstructionerp doctor.

Docker

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

Prima di iniziare Docker con Docker Compose. L'immagine pubblicata è costruita per x86-64 (amd64). Su Apple Silicon o altre macchine ARM, compila dal sorgente (make quickstart) o usa pip. I comandi qui sotto sono per una shell bash (Linux, macOS, oppure Git Bash o WSL su Windows). Windows PowerShell non ha openssl e scrive i file in un formato che compose non sa leggere.

  1. 1

    In una cartella vuota, scarica i due file 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

    VedraiDue file nella cartella.

  2. 2

    Crea una volta il file dei segreti.

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

    VedraiUn file .env. Conservalo: contiene la password del database e il segreto di accesso.

  3. 3

    Avvialo.

    docker compose pull app && docker compose up -d

    VedraiPartono due container: postgres e app.

  4. 4

    Apri http://localhost:8080 e accedi con demo@openconstructionerp.com / DemoPass1234!

    VedraiLa pagina di accesso. Il primo avvio può richiedere un minuto mentre si prepara il database.

  5. 5

    Con un'installazione nuova all'amministratore viene chiesto una volta quali moduli userai. Spunta quelli che ti servono e continua. Puoi cambiare scelta più tardi con il pulsante Servizi in background nella barra in alto.

    VedraiUn elenco una tantum dei moduli con la memoria che richiedono.

Comandi utili

Controlla che entrambi i container siano in esecuzione e sani

docker compose ps

Vedi perché l'app non parte

docker compose logs app

La porta 8080 sul tuo computer è occupata

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

Questa configurazione compose è per la valutazione e l'uso locale. Per un server di produzione vedi docs/INSTALL_LINUX.md e docker-compose.prod.yml nel repository.

Se vedi un messaggio

AvvioCompose si ferma con "POSTGRES_PASSWORD must be set" oppure "JWT_SECRET must be set".

Significa Il file .env con i due segreti manca o non è nella stessa cartella.

Cosa fare Crea il file .env come al passaggio 2, nella cartella con docker-compose.yml.

Avviohttp://localhost:8080 non si apre.

Significa Il container non è ancora in esecuzione, oppure la porta 8080 è occupata.

Cosa fare Esegui docker compose ps e docker compose logs app. Per usare un'altra porta: OE_PORT=8081 OE_ALLOWED_ORIGINS=http://localhost:8081 docker compose up -d, poi apri http://localhost:8081.

InstallazioneSu un Mac con Apple Silicon o un'altra macchina ARM, Docker avvisa che la piattaforma dell'immagine linux/amd64 non corrisponde, oppure l'app è molto lenta.

Significa L'immagine pubblicata è costruita solo per x86-64.

Cosa fare Compila dal sorgente con make quickstart, oppure usa pip.

Dove sono i log

  • terminal outputthe terminal window (pip); docker compose logs app (Docker)Per pip e Docker, copia ciò che ha stampato il terminale e l'output di openconstructionerp doctor.

I tuoi dati, aggiornamenti e disinstallazione

Aggiornamento

Installa la nuova versione sopra la vecchia. La cartella .openestimate non fa parte del programma, quindi progetti, utenti e impostazioni restano. Il primo avvio dopo un aggiornamento può richiedere di più mentre il database si aggiorna.

Disinstallazione

Disinstallando si rimuove il programma e si mantengono i progetti. Su Windows il programma di disinstallazione offre "Delete the application data" (nella lingua del programma di installazione): rimuove solo l'accesso e la lingua salvati dalla finestra dell'app (in %APPDATA% e %LOCALAPPDATA%\io.openconstructionerp.desktop), non i tuoi progetti. Per ripartire da zero, disinstalla, copia .openestimate in un posto sicuro, poi eliminala.

Backup

Chiudi l'app e copia la cartella .openestimate (e la cartella ProgramData indicata in pgdata.location, se c'è).

Sei ancora bloccato? Ti aiutiamo

Indica per favore:

GitHub Issues GitHub Discussions info@datadrivenconstruction.io

I file di log possono contenere il tuo nome utente e i nomi delle cartelle. Controllali prima di pubblicarli; mandali per email se preferisci.

Passaggi successivi dopo l’installazione

Installato e autenticato? Guarda questi video in ordine. Ognuno è breve e mostra l’app vera.

  1. Primi passi dopo l’installazione

    La seconda metà del video di installazione: primo avvio, lingua e regione, moduli, utenti, il tuo primo progetto.

  2. Scopri tutto il prodotto

    Utile anche

    Panoramica del prodotto: BOQ, BIM, DWG, computo da PDF e stima con AI

    12:01 minuti, registrato con una versione precedente. Mostra anche un’installazione con pip.

    Tour breve, 2:37: un edificio, un’unica fonte di verità

  3. Le basi del preventivo

    Builder's Playbook: Getting Started3 videoParti da qui: database dei costi e prezzi unitari, un preventivo passo dopo passo, spese generali, utile e imprevisti (USA).

  4. Il tuo mercato, dall’inizio alla fine

    Builder's Playbook UK: Construction in England6 video · ENGestione commerciale nel Regno Unito: formazione dei prezzi in gara NRM 2, confronto delle offerte, pagamenti JCT e ritenute, pay less notices, CIS e reverse charge IVA, varianti.Builder's Playbook: Canada6 video · ENCanada/Ontario: prezzi, gare per i subappalti, acconti CCDC 2, pagamento tempestivo (prompt payment), ordini di modifica, completamento sostanziale.Builder's Playbook: Québec5 video · FRQuébec in francese: primi passi, preventivi, gare BSDQ, fatturazione con trattenuta e ipoteca legale, collaudo e difetti.OpenConstructionERP auf Deutsch: vom Projektstart bis zur Übergabe8 video · DESerie tedesca dall’impostazione del progetto a disegni/RFI, quantità, controlli BIM, LV, prezzi unitari, GAEB X83/X84 e aggiudicazione (numerata /12, 8 pubblicati).Builder's Playbook Hrvatska: gradnja u Hrvatskoj5 video · HRCroazia: importazione del BOQ contrattuale da Excel, fatture passive, subappaltatori, SAL, stato finanziario e lavori extra.

  5. Gestire il cantiere: budget, acquisti, ore, fatture

    OpenConstructionERP en français: gérer un chantier4 video · FRGestione di cantiere in francese: budget, acquisti e magazzino, ore e attrezzature, fatture e pagamenti.

Tutte le playlist sul canale di OpenConstruction Academy

Il testo completo è anche su GitHub in English, Deutsch e Русский.