Ajuda de instalação
Instalar o OpenConstructionERP
Escolha como quer executá-lo, siga os passos numerados e, se algo parecer errado, procure a mensagem que vê na lista de problemas mais abaixo. Nenhum dos avisos durante a instalação põe os seus projetos em risco.
Não sabe qual precisa?
- Usa Windows 10 ou 11Instalador para Windows (.exe)
- Tem um Mac com chip M1, M2, M3 ou M4macOS (.dmg, Apple Silicon)
- Tem um Mac Intelpip ou Docker (não existe aplicação para Mac Intel)
- Usa Ubuntu, Debian ou Linux MintLinux .deb
- Usa Fedora, RHEL ou Rocky LinuxLinux .rpm
- Usa outra distribuição LinuxLinux AppImage
- Já tem Python 3.12 ou mais recente, ou quer instalá-lo num servidorpip
- Usa Docker, ou está a configurá-lo para uma equipaDocker
Veja primeiro
Como instalar o OpenConstructionERP
Guia em vídeo no Windows, gravado com a versão 17.7.1. Alguns ecrãs são diferentes na 18.5 e a espera durante a instalação está encurtada no vídeo.
Windows
- 1
Descarregue
OpenConstructionERP_18.5.0_x64-setup.exea partir da página da versão.VêUm ficheiro de cerca de 800 MB na pasta Transferências.
- 2
Faça duplo clique. Se uma janela azul disser "O Windows protegeu o seu PC", clique em Mais informações, confirme que o nome do ficheiro começa por OpenConstructionERP e clique em Executar mesmo assim.
VêO Windows pede permissão de administrador. Clique em Sim.
- 3
Escolha o idioma do instalador, aceite a licença e mantenha a pasta sugerida
C:\Program Files\OpenConstructionERP.VêUma barra de progresso e depois uma página final.
- 4
Clique em Concluir, ou inicie o OpenConstructionERP a partir do menu Iniciar.
VêUm ecrã de carregamento "A iniciar a aplicação" com uma lista: a iniciar o backend, a iniciar a base de dados local, a preparar a base de dados, a iniciar o servidor da aplicação, a abrir a aplicação.
- 5
Aguarde no primeiríssimo arranque. Não feche a janela.
Vê"O primeiro arranque configura a sua base de dados local. Pode demorar um ou dois minutos, aguarde por favor." Os arranques seguintes são muito mais rápidos.
- 6
Escolha como a abrir: numa janela de aplicação (recomendado) ou no seu navegador habitual.
Vê"Como pretende abrir o OpenConstructionERP?" e depois a página de início de sessão.
- 7
Inicie sessão com a conta de demonstração: e-mail demo@openconstructionerp.com, palavra-passe DemoPass1234!. A partir daí pode criar a sua própria conta e os seus projetos.
VêA aplicação. Os projetos de demonstração são criados em segundo plano no primeiro arranque, por isso a lista de projetos pode dizer, por um instante, que estão a caminho.
- 8
Numa instalação nova, o administrador é questionado uma vez sobre os módulos que vai usar. Marque o que precisa e continue. Pode alterar mais tarde com o botão Serviços em segundo plano na barra superior.
VêUma lista única de módulos com a memória de que precisam.
Se vir uma mensagem
InstalaçãoUma janela azul "O Windows protegeu o seu PC".
Significa O instalador ainda não está assinado digitalmente, por isso o Windows não conhece o editor. É um aviso, não a deteção de um vírus.
O que fazer Clique em Mais informações, confirme que o nome do ficheiro começa por OpenConstructionERP e clique em Executar mesmo assim.
InstalaçãoO Controlo de Aplicações Inteligente (Smart App Control) bloqueou a aplicação, sem botão para continuar.
Significa O Controlo de Aplicações Inteligente do Windows 11 recusa programas não assinados.
O que fazer O Controlo de Aplicações Inteligente não consegue permitir uma única aplicação. Para o manter ligado, execute o OpenConstructionERP com o Docker Desktop ou no WSL (o Linux integrado no Windows), que o Controlo de Aplicações Inteligente não verifica. Instruções passo a passo: docs/desktop/WINDOWS_BLOCKED.md no repositório.
Instalação"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" (a mensagem só existe em inglês)Significado: o caminho da pasta de instalação só pode conter letras latinas, números e espaços, porque a base de dados integrada não consegue iniciar a partir de nenhum outro caminho.
Significa A pasta escolhida tem no caminho letras cirílicas, chinesas, acentuadas ou de outros alfabetos não latinos.
O que fazer Mantenha a pasta sugerida C:\Program Files\OpenConstructionERP, ou escolha uma pasta como C:\OpenConstructionERP. Uma instalação silenciosa (/S) termina com o código 3 e escreve o motivo em %TEMP%\OpenConstructionERP-install-error.log.
InstalaçãoO instalador pára com um erro sobre o WebView2.
Significa O Windows recusou instalar o Microsoft WebView2, o componente que desenha a janela da aplicação. Vem incluído no instalador, por isso não é preciso internet; a falha vem do próprio Windows (política, uma atualização pendente ou um WebView2 anterior danificado).
O que fazer Reinicie o computador e execute o instalador outra vez. Se falhar de novo, instale o "Microsoft Edge WebView2 Runtime" a partir da Microsoft e execute o nosso instalador mais uma vez.
InstalaçãoO seu antivírus apaga ou põe em quarentena um ficheiro durante a instalação ou no primeiro arranque.
Significa O programa é novo e não está assinado, e alguns antivírus desconfiam disso.
O que fazer Restaure o ficheiro da quarentena e adicione estas duas pastas às exclusões: a pasta do programa C:\Program Files\OpenConstructionERP e a sua pasta de dados C:\Users\<your name>\.openestimate. Depois execute o instalador outra vez por cima da instalação existente. Se não tiver a certeza de que o ficheiro é genuíno, escreva-nos primeiro.
AtualizaçãoUm ecrã que pergunta se deve substituir a versão instalada ou removê-la primeiro, com uma linha a sugerir a remoção.
O que fazer Mantenha a opção que já está selecionada (substituir). Os seus projetos são mantidos. O primeiro arranque depois de uma atualização pode demorar mais enquanto a base de dados se atualiza.
AtualizaçãoTambém executa o OpenConstructionERP com pip ou num terminal no mesmo computador, e ele pára durante a atualização.
Significa Ambos usam a mesma pasta .openestimate e a mesma base de dados. O instalador pára essa base de dados para substituir o programa. Ao atualizar a partir da 18.4.0, o desinstalador antigo fecha também qualquer programa chamado openconstructionerp.exe.
O que fazer Pare a versão do terminal (Ctrl+C) antes de instalar ou atualizar e volte a iniciá-la depois.
ArranqueO ecrã de carregamento fica um minuto ou mais no primeiríssimo arranque.
Significa A aplicação está a criar a sua base de dados local. Isto acontece uma só vez.
O que fazer Aguarde e não feche a janela. Num disco lento ou quase cheio pode demorar mais. Os arranques seguintes são rápidos.
ArranqueUma caixa "OpenConstructionERP failed to start" que indica um ficheiro de registo.
Significa A aplicação não conseguiu abrir a janela.
O que fazer Inicie-a mais uma vez. Se a caixa voltar, envie-nos o ficheiro de registo que indica.
Arranque"The backend started, but the local database is not answering, so the app cannot open."Significado: a parte do servidor iniciou, mas a sua base de dados local não responde, por isso a aplicação não consegue abrir.
Significa A base de dados local não arrancou, muitas vezes depois de uma execução que não terminou bem.
O que fazer Reinicie o computador e inicie a aplicação outra vez. Se se repetir, envie-nos desktop-launcher.log e o registo da base de dados (veja Registos).
Arranque"The backend started, but this installation is missing the application files it serves"Significado: a parte do servidor iniciou, mas faltam na instalação os ficheiros da interface do utilizador.
Significa Falta uma parte da pasta do programa, normalmente removida pelo antivírus.
O que fazer Verifique a quarentena do antivírus e execute o instalador outra vez por cima da instalação existente. Os seus projetos não são tocados.
Arranque"The application backend did not start in time", ou "The application backend stopped responding while preparing the local database" (ou noutro passo).
Significa O arranque demorou mais do que a aplicação espera. A mensagem indica o passo em que estava.
O que fazer Feche a janela e inicie de novo. Liberte primeiro algum espaço em disco se o disco estiver quase cheio. Se parar outra vez no mesmo passo, envie-nos desktop-launcher.log.
Arranque"The drive ran out of space while the application was starting" ou "There is not enough free space to start the application".
Significa É exatamente isso. A mensagem indica a pasta e o espaço livre que resta.
O que fazer Liberte espaço nessa unidade e inicie de novo.
ArranqueUma mensagem a dizer que a pasta da base de dados local "sits too deep in the filesystem", com dois números.
Significa O Windows limita o comprimento dos caminhos e o caminho da sua pasta de dados é demasiado longo para os ficheiros da base de dados. Ativar caminhos longos no Windows não ajuda.
O que fazer Defina a variável de ambiente de utilizador OE_DATA_DIR com um caminho curto como C:\OpenConstructionERP\data (Iniciar, escreva "variáveis de ambiente", Editar as variáveis de ambiente da sua conta, Nova) e inicie de novo.
ArranqueO seu nome de utilizador do Windows tem letras não latinas (por exemplo cirílicas ou chinesas) e procura a sua base de dados.
Significa A base de dados integrada não consegue funcionar a partir de um caminho assim, por isso, desde a 18.5.0, a aplicação guarda-a em C:\ProgramData\OpenConstructionERP\clusters\<id>\pgdata. Antes da 18.5.0 a aplicação não arrancava de todo com essas contas.
O que fazer Não há nada para corrigir. O ficheiro pgdata.location na sua pasta .openestimate indica a pasta exata da base de dados. Para cópias de segurança, copie as duas pastas.
Em execução"The application backend stopped, restarting" e a janela recarrega.
Significa A parte de fundo da aplicação parou inesperadamente e a aplicação reiniciou-a. O trabalho guardado mantém-se. Faz isto no máximo duas vezes em 30 minutos.
O que fazer Continue. Se se repetir, ou se vir "The application backend has stopped", envie-nos desktop-launcher.log e logs/backend-crash.log.
ArranqueSempre que inicia a aplicação, a sessão é terminada e o idioma volta a inglês.
Significa Outro programa usa a porta 8732, a que a aplicação usa normalmente. A versão 18.5.0 escolhe então uma porta livre ao acaso em cada arranque, e a janela trata cada porta nova como um site novo, por isso não encontra o início de sessão nem o idioma.
O que fazer Feche ou reconfigure o outro programa que usa a porta 8732 (no Windows, execute netstat -ano | findstr :8732 num terminal para ver o ID do processo). Os seus projetos não são afetados, apenas o início de sessão e a escolha do idioma.
ArranqueReceia que a aplicação entre em conflito com um PostgreSQL que já tem na porta 5432.
Significa Não entra. No Windows, a base de dados integrada usa uma porta local livre ao acaso e, no macOS e no Linux, escuta apenas num socket local, não numa porta TCP.
O que fazer Não há nada a fazer.
Onde estão os registos
desktop-launcher.logC:\Users\<your name>\.openestimate\desktop-launcher.logTudo o que a aplicação de ambiente de trabalho fez ao arrancar. Fica sempre na sua pasta pessoal, mesmo que tenha movido a pasta de dados.backend-crash.logC:\Users\<your name>\.openestimate\logs\backend-crash.logDetalhes de uma paragem inesperada. Fica na pasta de dados, por isso acompanha oOE_DATA_DIR.database log folderC:\Users\<your name>\.openestimate\pgdata\log (or <folder frompgdata.location>\log)Porque é que a base de dados integrada não arrancou.OpenConstructionERP-install-error.log%TEMP%\OpenConstructionERP-install-error.log(escreva%TEMP%na barra de endereços do Explorador)Porque é que o instalador do Windows recusou a pasta de instalação.
Para abrir a pasta, cole isto na barra de endereços do Explorador:
%USERPROFILE%\.openestimatemacOS
- 1
Descarregue
OpenConstructionERP_18.5.0_aarch64.dmge abra-o.VêUma janela com o ícone da aplicação OpenConstructionERP.
- 2
Arraste o OpenConstructionERP para Aplicações.
VêA aplicação aparece na pasta Aplicações.
- 3
Abra o Terminal uma vez e execute.
xattr -dr com.apple.quarantine /Applications/OpenConstructionERP.appVêSem resultado. Está correto. Isto retira a marca de descarga, porque a aplicação ainda não está notarizada pela Apple.
- 4
Abra o OpenConstructionERP a partir de Aplicações.
VêO ecrã de carregamento "A iniciar a aplicação". O primeiro arranque prepara a base de dados local e demora um ou dois minutos.
- 5
Escolha janela de aplicação ou navegador.
VêA página de início de sessão.
- 6
Inicie sessão com a conta de demonstração: e-mail demo@openconstructionerp.com, palavra-passe DemoPass1234!. A partir daí pode criar a sua própria conta e os seus projetos.
VêA aplicação. Os projetos de demonstração são criados em segundo plano no primeiro arranque, por isso a lista de projetos pode dizer, por um instante, que estão a caminho.
- 7
Numa instalação nova, o administrador é questionado uma vez sobre os módulos que vai usar. Marque o que precisa e continue. Pode alterar mais tarde com o botão Serviços em segundo plano na barra superior.
VêUma lista única de módulos com a memória de que precisam.
Se vir uma mensagem
ArranqueO ecrã de carregamento fica um minuto ou mais no primeiríssimo arranque.
Significa A aplicação está a criar a sua base de dados local. Isto acontece uma só vez.
O que fazer Aguarde e não feche a janela. Num disco lento ou quase cheio pode demorar mais. Os arranques seguintes são rápidos.
Arranque"The backend started, but the local database is not answering, so the app cannot open."Significado: a parte do servidor iniciou, mas a sua base de dados local não responde, por isso a aplicação não consegue abrir.
Significa A base de dados local não arrancou, muitas vezes depois de uma execução que não terminou bem.
O que fazer Reinicie o computador e inicie a aplicação outra vez. Se se repetir, envie-nos desktop-launcher.log e o registo da base de dados (veja Registos).
Arranque"The backend started, but this installation is missing the application files it serves"Significado: a parte do servidor iniciou, mas faltam na instalação os ficheiros da interface do utilizador.
Significa Falta uma parte da pasta do programa, normalmente removida pelo antivírus.
O que fazer Verifique a quarentena do antivírus e execute o instalador outra vez por cima da instalação existente. Os seus projetos não são tocados.
Arranque"The application backend did not start in time", ou "The application backend stopped responding while preparing the local database" (ou noutro passo).
Significa O arranque demorou mais do que a aplicação espera. A mensagem indica o passo em que estava.
O que fazer Feche a janela e inicie de novo. Liberte primeiro algum espaço em disco se o disco estiver quase cheio. Se parar outra vez no mesmo passo, envie-nos desktop-launcher.log.
Arranque"The application never finished unpacking itself, so its backend never started." ou "The application could not unpack itself into the temporary folder it uses."
Significa No macOS e no Linux a aplicação descompacta o backend em cada arranque. Um disco lento ou cheio, ou um antivírus a bloquear os ficheiros, impede isso. (A aplicação para Windows já não se descompacta desde a 18.5.)
O que fazer Liberte espaço na unidade da sua pasta temporária, ou permita a aplicação no antivírus, e inicie de novo.
Arranque"The drive ran out of space while the application was starting" ou "There is not enough free space to start the application".
Significa É exatamente isso. A mensagem indica a pasta e o espaço livre que resta.
O que fazer Liberte espaço nessa unidade e inicie de novo.
Em execução"The application backend stopped, restarting" e a janela recarrega.
Significa A parte de fundo da aplicação parou inesperadamente e a aplicação reiniciou-a. O trabalho guardado mantém-se. Faz isto no máximo duas vezes em 30 minutos.
O que fazer Continue. Se se repetir, ou se vir "The application backend has stopped", envie-nos desktop-launcher.log e logs/backend-crash.log.
ArranqueSempre que inicia a aplicação, a sessão é terminada e o idioma volta a inglês.
Significa Outro programa usa a porta 8732, a que a aplicação usa normalmente. A versão 18.5.0 escolhe então uma porta livre ao acaso em cada arranque, e a janela trata cada porta nova como um site novo, por isso não encontra o início de sessão nem o idioma.
O que fazer Feche ou reconfigure o outro programa que usa a porta 8732 (no Windows, execute netstat -ano | findstr :8732 num terminal para ver o ID do processo). Os seus projetos não são afetados, apenas o início de sessão e a escolha do idioma.
ArranqueReceia que a aplicação entre em conflito com um PostgreSQL que já tem na porta 5432.
Significa Não entra. No Windows, a base de dados integrada usa uma porta local livre ao acaso e, no macOS e no Linux, escuta apenas num socket local, não numa porta TCP.
O que fazer Não há nada a fazer.
Instalação"“OpenConstructionERP” está danificada e não pode ser aberta."
Significa A aplicação ainda não está notarizada pela Apple e ainda tem a marca de descarga. A aplicação não está danificada.
O que fazer Só isto resolve: no Terminal execute uma vez xattr -dr com.apple.quarantine /Applications/OpenConstructionERP.app e depois abra a aplicação normalmente.
Instalação"Não é possível abrir “OpenConstructionERP” porque não é possível verificar o programador" (ou a Apple não conseguiu verificar que está livre de software malicioso).
Significa A aplicação tem assinatura ad hoc, mas ainda não está notarizada pela Apple.
O que fazer Execute o mesmo comando xattr, ou abra as Definições do Sistema, Privacidade e Segurança, desça até ao fim e clique em Abrir Mesmo Assim. Só precisa de o fazer uma vez.
InstalaçãoA aplicação não funciona de todo no seu Mac.
Significa A versão para Mac é só para Apple Silicon (M1 e mais recentes). Não existe versão Intel.
O que fazer Num Mac Intel use pip (Python 3.12 ou mais recente) ou Docker.
Onde estão os registos
desktop-launcher.log~/.openestimate/desktop-launcher.logTudo o que a aplicação de ambiente de trabalho fez ao arrancar. Fica sempre na sua pasta pessoal, mesmo que tenha movido a pasta de dados.backend-crash.log~/.openestimate/logs/backend-crash.logDetalhes de uma paragem inesperada. Fica na pasta de dados, por isso acompanha oOE_DATA_DIR.database log folder~/.openestimate/pgdata/logPorque é que a base de dados integrada não arrancou.
Para abrir a pasta a partir de um terminal:
open ~/.openestimateLinux
Linux: .deb (Ubuntu, Debian, Mint)
- 1
Descarregue
OpenConstructionERP_18.5.0_amd64.deb.VêUm ficheiro de cerca de 830 MB.
- 2
Num terminal, na pasta de descargas, execute.
sudo apt install ./OpenConstructionERP_18.5.0_amd64.debVêO apt lista o pacote e as bibliotecas de que precisa e depois instala-os. O ./ antes do nome do ficheiro é importante.
- 3
Inicie o OpenConstructionERP a partir do menu de aplicações.
VêO ecrã de carregamento. O primeiro arranque demora um ou dois minutos.
- 4
Inicie sessão com a conta de demonstração: e-mail demo@openconstructionerp.com, palavra-passe DemoPass1234!. A partir daí pode criar a sua própria conta e os seus projetos.
VêA aplicação. Os projetos de demonstração são criados em segundo plano no primeiro arranque, por isso a lista de projetos pode dizer, por um instante, que estão a caminho.
- 5
Numa instalação nova, o administrador é questionado uma vez sobre os módulos que vai usar. Marque o que precisa e continue. Pode alterar mais tarde com o botão Serviços em segundo plano na barra superior.
VêUma lista única de módulos com a memória de que precisam.
Linux: .rpm (Fedora, RHEL, Rocky)
- 1
Descarregue
OpenConstructionERP-18.5.0-1.x86_64.rpm.VêUm ficheiro de cerca de 850 MB.
- 2
Execute.
sudo dnf install ./OpenConstructionERP-18.5.0-1.x86_64.rpmVêO dnf resolve as dependências e instala.
- 3
Inicie o OpenConstructionERP a partir do menu de aplicações.
VêO ecrã de carregamento. O primeiro arranque demora um ou dois minutos.
- 4
Inicie sessão com a conta de demonstração: e-mail demo@openconstructionerp.com, palavra-passe DemoPass1234!. A partir daí pode criar a sua própria conta e os seus projetos.
VêA aplicação. Os projetos de demonstração são criados em segundo plano no primeiro arranque, por isso a lista de projetos pode dizer, por um instante, que estão a caminho.
- 5
Numa instalação nova, o administrador é questionado uma vez sobre os módulos que vai usar. Marque o que precisa e continue. Pode alterar mais tarde com o botão Serviços em segundo plano na barra superior.
VêUma lista única de módulos com a memória de que precisam.
Linux: AppImage (any distribution)
- 1
Descarregue
OpenConstructionERP_18.5.0_amd64.AppImage.VêUm ficheiro de cerca de 910 MB.
- 2
Torne-o executável.
chmod +x OpenConstructionERP_18.5.0_amd64.AppImageVêSem resultado.
- 3
Execute-o.
./OpenConstructionERP_18.5.0_amd64.AppImageVêO ecrã de carregamento. O primeiro arranque demora um ou dois minutos.
- 4
Inicie sessão com a conta de demonstração: e-mail demo@openconstructionerp.com, palavra-passe DemoPass1234!. A partir daí pode criar a sua própria conta e os seus projetos.
VêA aplicação. Os projetos de demonstração são criados em segundo plano no primeiro arranque, por isso a lista de projetos pode dizer, por um instante, que estão a caminho.
- 5
Numa instalação nova, o administrador é questionado uma vez sobre os módulos que vai usar. Marque o que precisa e continue. Pode alterar mais tarde com o botão Serviços em segundo plano na barra superior.
VêUma lista única de módulos com a memória de que precisam.
Se vir uma mensagem
ArranqueO ecrã de carregamento fica um minuto ou mais no primeiríssimo arranque.
Significa A aplicação está a criar a sua base de dados local. Isto acontece uma só vez.
O que fazer Aguarde e não feche a janela. Num disco lento ou quase cheio pode demorar mais. Os arranques seguintes são rápidos.
Arranque"The backend started, but the local database is not answering, so the app cannot open."Significado: a parte do servidor iniciou, mas a sua base de dados local não responde, por isso a aplicação não consegue abrir.
Significa A base de dados local não arrancou, muitas vezes depois de uma execução que não terminou bem.
O que fazer Reinicie o computador e inicie a aplicação outra vez. Se se repetir, envie-nos desktop-launcher.log e o registo da base de dados (veja Registos).
Arranque"The backend started, but this installation is missing the application files it serves"Significado: a parte do servidor iniciou, mas faltam na instalação os ficheiros da interface do utilizador.
Significa Falta uma parte da pasta do programa, normalmente removida pelo antivírus.
O que fazer Verifique a quarentena do antivírus e execute o instalador outra vez por cima da instalação existente. Os seus projetos não são tocados.
Arranque"The application backend did not start in time", ou "The application backend stopped responding while preparing the local database" (ou noutro passo).
Significa O arranque demorou mais do que a aplicação espera. A mensagem indica o passo em que estava.
O que fazer Feche a janela e inicie de novo. Liberte primeiro algum espaço em disco se o disco estiver quase cheio. Se parar outra vez no mesmo passo, envie-nos desktop-launcher.log.
Arranque"The application never finished unpacking itself, so its backend never started." ou "The application could not unpack itself into the temporary folder it uses."
Significa No macOS e no Linux a aplicação descompacta o backend em cada arranque. Um disco lento ou cheio, ou um antivírus a bloquear os ficheiros, impede isso. (A aplicação para Windows já não se descompacta desde a 18.5.)
O que fazer Liberte espaço na unidade da sua pasta temporária, ou permita a aplicação no antivírus, e inicie de novo.
Arranque"The drive ran out of space while the application was starting" ou "There is not enough free space to start the application".
Significa É exatamente isso. A mensagem indica a pasta e o espaço livre que resta.
O que fazer Liberte espaço nessa unidade e inicie de novo.
Em execução"The application backend stopped, restarting" e a janela recarrega.
Significa A parte de fundo da aplicação parou inesperadamente e a aplicação reiniciou-a. O trabalho guardado mantém-se. Faz isto no máximo duas vezes em 30 minutos.
O que fazer Continue. Se se repetir, ou se vir "The application backend has stopped", envie-nos desktop-launcher.log e logs/backend-crash.log.
ArranqueSempre que inicia a aplicação, a sessão é terminada e o idioma volta a inglês.
Significa Outro programa usa a porta 8732, a que a aplicação usa normalmente. A versão 18.5.0 escolhe então uma porta livre ao acaso em cada arranque, e a janela trata cada porta nova como um site novo, por isso não encontra o início de sessão nem o idioma.
O que fazer Feche ou reconfigure o outro programa que usa a porta 8732 (no Windows, execute netstat -ano | findstr :8732 num terminal para ver o ID do processo). Os seus projetos não são afetados, apenas o início de sessão e a escolha do idioma.
ArranqueReceia que a aplicação entre em conflito com um PostgreSQL que já tem na porta 5432.
Significa Não entra. No Windows, a base de dados integrada usa uma porta local livre ao acaso e, no macOS e no Linux, escuta apenas num socket local, não numa porta TCP.
O que fazer Não há nada a fazer.
InstalaçãoO .deb pede libwebkit2gtk-4.1-0, ou o dpkg indica dependências por satisfazer.
Significa A aplicação precisa do WebKitGTK 4.1 para desenhar a janela. O dpkg -i não instala dependências.
O que fazer Instale com sudo apt install ./OpenConstructionERP_18.5.0_amd64.deb, que traz a biblioteca. Se a sua distribuição não tiver libwebkit2gtk-4.1-0 (Ubuntu anterior à 22.04, Debian anterior à 12), use pip.
InstalaçãoO AppImage não faz nada quando faz duplo clique.
Significa O ficheiro ainda não está marcado como programa.
O que fazer Execute chmod +x OpenConstructionERP_18.5.0_amd64.AppImage e inicie-o outra vez.
InstalaçãoUm erro do AppImage que menciona FUSE ou libfuse.so.2.
Significa As distribuições mais recentes já não instalam a biblioteca FUSE 2 que os AppImage usam.
O que fazer Instale-a (sudo apt install libfuse2, no Ubuntu 24.04 sudo apt install libfuse2t64), ou use o .deb, o .rpm ou pip.
Onde estão os registos
desktop-launcher.log~/.openestimate/desktop-launcher.logTudo o que a aplicação de ambiente de trabalho fez ao arrancar. Fica sempre na sua pasta pessoal, mesmo que tenha movido a pasta de dados.backend-crash.log~/.openestimate/logs/backend-crash.logDetalhes de uma paragem inesperada. Fica na pasta de dados, por isso acompanha oOE_DATA_DIR.database log folder~/.openestimate/pgdata/logPorque é que a base de dados integrada não arrancou.
Para abrir a pasta a partir de um terminal:
xdg-open ~/.openestimatepip
- 1
Execute.
pip install --upgrade openconstructionerpVêO pip descarrega o pacote e as suas dependências.
- 2
Execute.
openconstructionerpVêUma breve mensagem de boas-vindas. Na primeira execução pergunta se deve carregar os projetos de demonstração e abrir o navegador.
- 3
Aguarde enquanto prepara a base de dados local.
Vê"Database: embedded PostgreSQL 16 (no Docker)" e depois o servidor arranca. O navegador abre http://127.0.0.1:8080 (é o mesmo que http://localhost:8080).
- 4
Inicie sessão. Com os dados de demonstração pode usar demo@openconstructionerp.com / DemoPass1234!
VêO painel.
- 5
Numa instalação nova, o administrador é questionado uma vez sobre os módulos que vai usar. Marque o que precisa e continue. Pode alterar mais tarde com o botão Serviços em segundo plano na barra superior.
VêUma lista única de módulos com a memória de que precisam.
- 6
Para parar, prima Ctrl+C no terminal. Da próxima vez, execute novamente openconstructionerp.
VêO servidor pára. Os seus dados ficam na pasta
.openestimateda sua pasta pessoal.
Comandos úteis
O comando openconstructionerp não é encontrado
python -m openconstructionerpAlgo não funciona: verifica o Python, a porta, a pasta de dados e a base de dados e diz o que fazer
openconstructionerp doctorA porta 8080 está ocupada por outro programa
openconstructionerp serve --port 8081Outros computadores da sua rede devem conseguir aceder
openconstructionerp serve --host 0.0.0.0 --port 8080Tem de nos dizer a sua versão
openconstructionerp --versionSe vir uma mensagem
InstalaçãoO pip diz que não foi encontrada nenhuma distribuição compatível, ou que precisa de outra versão do Python.
Significa O OpenConstructionERP precisa de Python 3.12 ou mais recente.
O que fazer Instale o Python 3.12 ou mais recente e execute python3.12 -m pip install --upgrade openconstructionerp (no Windows: py -3.12 -m pip install --upgrade openconstructionerp).
Instalaçãoerror: externally-managed-environment (Ubuntu 23.04+, Debian 12+).Significado: o seu sistema Linux protege o seu próprio Python e recusa instalar pacotes nele.
Significa O Python do sistema não deixa o pip instalar nele.
O que fazer Use pipx install openconstructionerp, ou crie primeiro um ambiente virtual: python3 -m venv ~/oe && ~/oe/bin/pip install openconstructionerp.
Arranque"openconstructionerp" is not recognized, ou command not found.
Significa A pasta onde o pip coloca os comandos não está no seu PATH (comum no Windows).
O que fazer Execute antes python -m openconstructionerp. Funciona em qualquer sistema sem mexer no PATH.
Arranque"Port 8080 is already in use. Try: openconstructionerp serve --port 8081"Significado: outro programa já está a usar a porta 8080, por isso inicie a aplicação noutra porta, por exemplo 8081.
Significa Outro programa usa a porta 8080.
O que fazer Execute o comando sugerido e abra o endereço que ele mostra.
Arranque"Embedded PostgreSQL could not start".Significado: não foi possível iniciar a base de dados PostgreSQL integrada.
Significa A base de dados integrada não arrancou. A mensagem mostra o caminho do respetivo registo.
O que fazer Execute openconstructionerp doctor. Se não ajudar, reinstale com pip install --upgrade --force-reinstall openconstructionerp e envie-nos o registo indicado.
Onde estão os registos
terminal outputthe terminal window (pip);docker compose logs app(Docker)Para pip e Docker, copie o que o terminal mostrou e o resultado deopenconstructionerp doctor.
Docker
- 1
Numa pasta vazia, descarregue os dois ficheiros compose.
curl -fsSL https://raw.githubusercontent.com/datadrivenconstruction/OpenConstructionERP/main/docker-compose.quickstart.yml -o docker-compose.ymlcurl -fsSL https://raw.githubusercontent.com/datadrivenconstruction/OpenConstructionERP/main/docker-compose.quickstart.image.yml -o docker-compose.override.ymlVêDois ficheiros na pasta.
- 2
Crie uma vez o ficheiro de segredos.
echo "POSTGRES_PASSWORD=$(openssl rand -base64 24)" > .envecho "JWT_SECRET=$(openssl rand -hex 32)" >> .envVêUm ficheiro
.env. Guarde-o: contém a palavra-passe da base de dados e o segredo do início de sessão. - 3
Inicie-o.
docker compose pull app && docker compose up -dVêArrancam dois contentores: postgres e app.
- 4
Abra http://localhost:8080 e inicie sessão com demo@openconstructionerp.com / DemoPass1234!
VêA página de início de sessão. O primeiro arranque pode demorar um minuto enquanto a base de dados é preparada.
- 5
Numa instalação nova, o administrador é questionado uma vez sobre os módulos que vai usar. Marque o que precisa e continue. Pode alterar mais tarde com o botão Serviços em segundo plano na barra superior.
VêUma lista única de módulos com a memória de que precisam.
Comandos úteis
Verificar se os dois contentores estão a funcionar e saudáveis
docker compose psVer porque é que a aplicação não arranca
docker compose logs appA porta 8080 no seu computador está ocupada
OE_PORT=8081 OE_ALLOWED_ORIGINS=http://localhost:8081 docker compose up -dEsta configuração compose serve para avaliação e uso local. Para um servidor de produção veja docs/INSTALL_LINUX.md e docker-compose.prod.yml no repositório.
Se vir uma mensagem
ArranqueO Compose pára com "POSTGRES_PASSWORD must be set" ou "JWT_SECRET must be set".
Significa O ficheiro .env com os dois segredos não existe ou não está na mesma pasta.
O que fazer Crie o ficheiro .env como no passo 2, na pasta com docker-compose.yml.
ArranqueO http://localhost:8080 não abre.
Significa O contentor ainda não está a funcionar, ou a porta 8080 está ocupada.
O que fazer Execute docker compose ps e docker compose logs app. Para usar outra porta: OE_PORT=8081 OE_ALLOWED_ORIGINS=http://localhost:8081 docker compose up -d e abra http://localhost:8081.
InstalaçãoNum Mac com Apple Silicon ou outra máquina ARM, o Docker avisa que a plataforma da imagem linux/amd64 não corresponde, ou a aplicação fica muito lenta.
Significa A imagem publicada é compilada apenas para x86-64.
O que fazer Compile a partir do código-fonte com make quickstart, ou use pip.
Onde estão os registos
terminal outputthe terminal window (pip);docker compose logs app(Docker)Para pip e Docker, copie o que o terminal mostrou e o resultado deopenconstructionerp doctor.
Os seus dados, atualizações e desinstalação
- Windows
C:\Users\<your name>\.openestimateMaisC:\ProgramData\OpenConstructionERP\clusters\<id>\pgdatase o seu nome de utilizador tiver letras não latinas; opgdata.locationindica-o. - macOS~/
.openestimate(oculta; prima Cmd+Maiúsculas+. no Finder) - Linux~/
.openestimate - pip~/
.openestimate, a mesma pasta da aplicação de ambiente de trabalho, a não ser que passe--data-dirou definaOE_DATA_DIR - Dockeros volumes Docker <folder>_pg_data (base de dados) e <folder>_app_data (ficheiros), onde <folder> é o nome da pasta com
docker-compose.yml
Atualização
Instale a nova versão por cima da antiga. A sua pasta .openestimate não faz parte do programa, por isso projetos, utilizadores e definições mantêm-se. O primeiro arranque depois de uma atualização pode demorar mais enquanto a base de dados se atualiza.
Desinstalação
Desinstalar remove o programa e mantém os seus projetos. No Windows, o desinstalador oferece "Delete the application data" (no idioma do instalador): isso remove apenas o início de sessão e o idioma guardados pela janela da aplicação (em %APPDATA% e %LOCALAPPDATA%\io.openconstructionerp.desktop), não os seus projetos. Para começar do zero, desinstale, copie .openestimate para um local seguro e depois apague-a.
Cópia de segurança
Feche a aplicação e copie a pasta .openestimate (e a pasta ProgramData indicada em pgdata.location, se existir).
Continua com problemas? Ajudamos
Inclua, por favor:
- a versão (está no nome do ficheiro que descarregou; pip:
openconstructionerp --version; Docker: a etiqueta da imagem) e como instalou (instalador Windows, .dmg, .deb, .rpm, AppImage, pip ou Docker) - o seu sistema (Windows: Iniciar, escreva
winver; macOS: menu Apple, Acerca deste Mac; Linux: a distribuição e a versão) - o texto exato da mensagem, ou uma captura de ecrã
- os ficheiros de registo indicados acima
Os ficheiros de registo podem conter o seu nome de utilizador e nomes de pastas. Reveja-os antes de os publicar; envie-os por e-mail se preferir.
Próximos passos depois de instalar
O texto completo também está no GitHub em English, Deutsch e Русский.