Ayuda de instalación
Instalar OpenConstructionERP
Elige cómo quieres ejecutarlo, sigue los pasos numerados y, si algo no cuadra, busca el mensaje que ves en la lista de problemas de más abajo. Ninguna de las advertencias durante la instalación pone en riesgo tus proyectos.
¿No sabes cuál necesitas?
- Usas Windows 10 u 11Instalador de Windows (.exe)
- Tienes un Mac con chip M1, M2, M3 o M4macOS (.dmg, Apple Silicon)
- Tienes un Mac con Intelpip o Docker (no hay aplicación para Mac con Intel)
- Usas Ubuntu, Debian o Linux MintLinux .deb
- Usas Fedora, RHEL o Rocky LinuxLinux .rpm
- Usas otra distribución de LinuxLinux AppImage
- Ya tienes Python 3.12 o más reciente, o lo quieres en un servidorpip
- Usas Docker, o lo montas para un equipoDocker
Míralo primero
Cómo instalar OpenConstructionERP
Guía en vídeo en Windows, grabada con la versión 17.7.1. Algunas pantallas se ven distintas en 18.5, y la espera durante la instalación está acortada en el vídeo.
Windows
- 1
Descarga
OpenConstructionERP_18.5.0_x64-setup.exede la página de la versión.VerásUn archivo de unos 800 MB en tu carpeta Descargas.
- 2
Haz doble clic. Si una ventana azul dice "Windows protegió su PC", pulsa Más información, comprueba que el nombre del archivo empieza por OpenConstructionERP y pulsa Ejecutar de todas formas.
VerásWindows pide permiso de administrador. Pulsa Sí.
- 3
Elige el idioma del instalador, acepta la licencia y deja la carpeta propuesta
C:\Program Files\OpenConstructionERP.VerásUna barra de progreso y luego una página final.
- 4
Pulsa Finalizar, o abre OpenConstructionERP desde el menú Inicio.
VerásUna pantalla de carga "Iniciando la aplicación" con una lista: iniciando el backend, iniciando la base de datos local, preparando la base de datos, iniciando el servidor de la aplicación, abriendo la aplicación.
- 5
Espera en el primer arranque. No cierres la ventana.
Verás"El primer arranque configura su base de datos local. Puede tardar uno o dos minutos, espere por favor." Los siguientes arranques son mucho más rápidos.
- 6
Elige cómo abrirla: en una ventana de aplicación (recomendado) o en tu navegador habitual.
Verás"¿Cómo quiere abrir OpenConstructionERP?" y después la página de inicio de sesión.
- 7
Inicia sesión con la cuenta de demostración: correo demo@openconstructionerp.com, contraseña DemoPass1234!. Desde ahí puedes crear tu propia cuenta y tus proyectos.
VerásLa aplicación. Los proyectos de demostración se crean en segundo plano en el primer arranque, así que la lista de proyectos puede decir un momento que están en camino.
- 8
En una instalación nueva se le pregunta una vez al administrador qué módulos vas a usar. Marca lo que necesites y continúa. Puedes cambiarlo después con el botón Servicios en segundo plano de la barra superior.
VerásUna lista única de módulos con la memoria que necesitan.
Si ves un mensaje
InstalaciónUna ventana azul "Windows protegió su PC".
Significa El instalador todavía no está firmado con código, así que Windows no conoce al editor. Es una advertencia, no la detección de un virus.
Qué hacer Pulsa Más información, comprueba que el nombre del archivo empieza por OpenConstructionERP y pulsa Ejecutar de todas formas.
InstalaciónEl Control inteligente de aplicaciones (Smart App Control) bloqueó la aplicación, sin botón para continuar.
Significa El Control inteligente de aplicaciones de Windows 11 rechaza los programas sin firmar.
Qué hacer El Control inteligente de aplicaciones no puede permitir una sola aplicación. Para dejarlo activado, ejecuta OpenConstructionERP con Docker Desktop o en WSL (el Linux integrado de Windows), que el Control inteligente de aplicaciones no revisa. Instrucciones paso a paso: docs/desktop/WINDOWS_BLOCKED.md en el repositorio.
Instalación"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" (el mensaje solo existe en inglés)Significado: la ruta de la carpeta de instalación solo puede contener letras latinas, números y espacios, porque la base de datos integrada no puede arrancar desde ninguna otra ruta.
Significa La carpeta elegida tiene en su ruta letras cirílicas, chinas, con acentos u otras no latinas.
Qué hacer Deja la carpeta propuesta C:\Program Files\OpenConstructionERP, o elige una carpeta como C:\OpenConstructionERP. Una instalación silenciosa (/S) termina con el código 3 y escribe el motivo en %TEMP%\OpenConstructionERP-install-error.log.
InstalaciónEl instalador se detiene con un error sobre WebView2.
Significa Windows rechazó instalar Microsoft WebView2, el componente que dibuja la ventana de la aplicación. Va incluido en el instalador, así que no hace falta internet; el fallo viene de Windows (una directiva, una actualización pendiente o un WebView2 anterior dañado).
Qué hacer Reinicia el equipo y vuelve a ejecutar el instalador. Si falla otra vez, instala "Microsoft Edge WebView2 Runtime" desde Microsoft y ejecuta de nuevo nuestro instalador.
InstalaciónTu antivirus borra o pone en cuarentena un archivo durante la instalación o en el primer arranque.
Significa El programa es nuevo y no está firmado, y algunos antivirus desconfían de eso.
Qué hacer Restaura el archivo desde la cuarentena y añade estas dos carpetas como exclusiones: la carpeta del programa C:\Program Files\OpenConstructionERP y tu carpeta de datos C:\Users\<your name>\.openestimate. Después vuelve a ejecutar el instalador sobre la instalación existente. Si no estás seguro de que el archivo sea auténtico, escríbenos antes.
ActualizaciónUna pantalla que pregunta si sobrescribir la versión instalada o quitarla antes, con una línea que sugiere quitarla.
Qué hacer Deja la opción que ya está marcada (sobrescribir). Tus proyectos se conservan. El primer arranque tras una actualización puede tardar más mientras la base de datos se actualiza.
ActualizaciónTambién ejecutas OpenConstructionERP con pip o desde una terminal en el mismo equipo, y se detiene durante la actualización.
Significa Ambos usan la misma carpeta .openestimate y la misma base de datos. El instalador detiene esa base de datos para reemplazar el programa. Al actualizar desde la 18.4.0, el desinstalador antiguo también cierra cualquier programa llamado openconstructionerp.exe.
Qué hacer Detén la versión de la terminal (Ctrl+C) antes de instalar o actualizar y vuelve a iniciarla después.
ArranqueLa pantalla de carga se queda un minuto o más en el primer arranque.
Significa La aplicación está creando su base de datos local. Esto pasa una sola vez.
Qué hacer Espera y no cierres la ventana. En un disco lento o casi lleno puede tardar más. Los siguientes arranques son rápidos.
ArranqueUn cuadro "OpenConstructionERP failed to start" que indica un archivo de registro.
Significa La aplicación no pudo abrir su ventana.
Qué hacer Ábrela una vez más. Si el cuadro vuelve, envíanos el archivo de registro que indica.
Arranque"The backend started, but the local database is not answering, so the app cannot open."Significado: la parte del servidor ha arrancado, pero su base de datos local no responde, por lo que la aplicación no se puede abrir.
Significa La base de datos local no arrancó, a menudo tras una ejecución que no se cerró bien.
Qué hacer Reinicia el equipo y abre la aplicación otra vez. Si se repite, envíanos desktop-launcher.log y el registro de la base de datos (mira Registros).
Arranque"The backend started, but this installation is missing the application files it serves"Significado: la parte del servidor ha arrancado, pero a la instalación le faltan los archivos de la interfaz de usuario.
Significa Falta una parte de la carpeta del programa, normalmente borrada por el antivirus.
Qué hacer Revisa la cuarentena de tu antivirus y vuelve a ejecutar el instalador sobre la instalación existente. Tus proyectos no se tocan.
Arranque"The application backend did not start in time", o "The application backend stopped responding while preparing the local database" (o en otro paso).
Significa El arranque tardó más de lo que la aplicación espera. El mensaje indica el paso en el que estaba.
Qué hacer Cierra la ventana y vuelve a abrir. Antes libera espacio en el disco si está casi lleno. Si se detiene otra vez en el mismo paso, envíanos desktop-launcher.log.
Arranque"The drive ran out of space while the application was starting" o "There is not enough free space to start the application".
Significa Justo eso. El mensaje indica la carpeta y el espacio libre que queda.
Qué hacer Libera espacio en esa unidad y vuelve a abrir.
ArranqueUn mensaje que dice que la carpeta de la base de datos local "sits too deep in the filesystem", con dos números.
Significa Windows limita la longitud de las rutas y la ruta de tu carpeta de datos es demasiado larga para los archivos de la base de datos. Activar las rutas largas en Windows no ayuda.
Qué hacer Define la variable de entorno de usuario OE_DATA_DIR con una ruta corta como C:\OpenConstructionERP\data (Inicio, escribe "variables de entorno", Editar las variables de entorno de esta cuenta, Nueva) y vuelve a abrir.
ArranqueTu nombre de usuario de Windows tiene letras no latinas (por ejemplo cirílicas o chinas) y buscas tu base de datos.
Significa La base de datos integrada no puede funcionar desde una ruta así, por eso desde la 18.5.0 la aplicación la guarda en C:\ProgramData\OpenConstructionERP\clusters\<id>\pgdata. Antes de la 18.5.0 la aplicación no podía arrancar en absoluto con esas cuentas.
Qué hacer No hay nada que arreglar. El archivo pgdata.location de tu carpeta .openestimate indica la carpeta exacta de la base de datos. Para las copias de seguridad, copia las dos carpetas.
En marcha"The application backend stopped, restarting" y la ventana se recarga.
Significa La parte de fondo de la aplicación se detuvo de forma inesperada y la aplicación la reinició. El trabajo guardado se conserva. Lo hace como máximo dos veces en 30 minutos.
Qué hacer Sigue trabajando. Si se repite, o ves "The application backend has stopped", envíanos desktop-launcher.log y logs/backend-crash.log.
ArranqueCada vez que abres la aplicación se cierra tu sesión y el idioma vuelve a inglés.
Significa Otro programa usa el puerto 8732, el que la aplicación usa normalmente. La versión 18.5.0 elige entonces un puerto libre al azar en cada arranque, y la ventana trata cada puerto nuevo como un sitio nuevo, así que no encuentra el inicio de sesión ni el idioma.
Qué hacer Cierra o reconfigura el otro programa que usa el puerto 8732 (en Windows, ejecuta netstat -ano | findstr :8732 en una terminal para ver su ID de proceso). Tus proyectos no se ven afectados, solo el inicio de sesión y el idioma.
ArranqueTe preocupa que la aplicación choque con un PostgreSQL que ya tienes en el puerto 5432.
Significa No choca. La base de datos integrada en Windows toma un puerto local libre al azar, y en macOS y Linux escucha solo en un socket local, no en un puerto TCP.
Qué hacer No hay que hacer nada.
Dónde están los registros
desktop-launcher.logC:\Users\<your name>\.openestimate\desktop-launcher.logTodo lo que hizo la aplicación de escritorio al arrancar. Siempre en tu carpeta personal, aunque hayas movido la carpeta de datos.backend-crash.logC:\Users\<your name>\.openestimate\logs\backend-crash.logDetalles de una parada inesperada. Está en la carpeta de datos, así que se mueve conOE_DATA_DIR.database log folderC:\Users\<your name>\.openestimate\pgdata\log (or <folder frompgdata.location>\log)Por qué no arrancó la base de datos integrada.OpenConstructionERP-install-error.log%TEMP%\OpenConstructionERP-install-error.log(escribe%TEMP%en la barra de direcciones del Explorador)Por qué el instalador de Windows rechazó la carpeta de instalación.
Para abrir la carpeta, pega esto en la barra de direcciones del Explorador:
%USERPROFILE%\.openestimatemacOS
- 1
Descarga
OpenConstructionERP_18.5.0_aarch64.dmgy ábrelo.VerásUna ventana con el icono de la aplicación OpenConstructionERP.
- 2
Arrastra OpenConstructionERP a Aplicaciones.
VerásLa aplicación aparece en tu carpeta Aplicaciones.
- 3
Abre Terminal una vez y ejecuta.
xattr -dr com.apple.quarantine /Applications/OpenConstructionERP.appVerásSin salida. Es correcto. Esto quita la marca de descarga, porque la aplicación aún no está notarizada por Apple.
- 4
Abre OpenConstructionERP desde Aplicaciones.
VerásLa pantalla de carga "Iniciando la aplicación". El primer arranque prepara la base de datos local y tarda uno o dos minutos.
- 5
Elige ventana de aplicación o navegador.
VerásLa página de inicio de sesión.
- 6
Inicia sesión con la cuenta de demostración: correo demo@openconstructionerp.com, contraseña DemoPass1234!. Desde ahí puedes crear tu propia cuenta y tus proyectos.
VerásLa aplicación. Los proyectos de demostración se crean en segundo plano en el primer arranque, así que la lista de proyectos puede decir un momento que están en camino.
- 7
En una instalación nueva se le pregunta una vez al administrador qué módulos vas a usar. Marca lo que necesites y continúa. Puedes cambiarlo después con el botón Servicios en segundo plano de la barra superior.
VerásUna lista única de módulos con la memoria que necesitan.
Si ves un mensaje
ArranqueLa pantalla de carga se queda un minuto o más en el primer arranque.
Significa La aplicación está creando su base de datos local. Esto pasa una sola vez.
Qué hacer Espera y no cierres la ventana. En un disco lento o casi lleno puede tardar más. Los siguientes arranques son rápidos.
Arranque"The backend started, but the local database is not answering, so the app cannot open."Significado: la parte del servidor ha arrancado, pero su base de datos local no responde, por lo que la aplicación no se puede abrir.
Significa La base de datos local no arrancó, a menudo tras una ejecución que no se cerró bien.
Qué hacer Reinicia el equipo y abre la aplicación otra vez. Si se repite, envíanos desktop-launcher.log y el registro de la base de datos (mira Registros).
Arranque"The backend started, but this installation is missing the application files it serves"Significado: la parte del servidor ha arrancado, pero a la instalación le faltan los archivos de la interfaz de usuario.
Significa Falta una parte de la carpeta del programa, normalmente borrada por el antivirus.
Qué hacer Revisa la cuarentena de tu antivirus y vuelve a ejecutar el instalador sobre la instalación existente. Tus proyectos no se tocan.
Arranque"The application backend did not start in time", o "The application backend stopped responding while preparing the local database" (o en otro paso).
Significa El arranque tardó más de lo que la aplicación espera. El mensaje indica el paso en el que estaba.
Qué hacer Cierra la ventana y vuelve a abrir. Antes libera espacio en el disco si está casi lleno. Si se detiene otra vez en el mismo paso, envíanos desktop-launcher.log.
Arranque"The application never finished unpacking itself, so its backend never started." o "The application could not unpack itself into the temporary folder it uses."
Significa En macOS y Linux la aplicación descomprime su backend en cada arranque. Un disco lento o lleno, o un antivirus que bloquea los archivos, lo impide. (La aplicación de Windows ya no se descomprime desde la 18.5.)
Qué hacer Libera espacio en la unidad de tu carpeta temporal, o permite la aplicación en tu antivirus, y vuelve a abrir.
Arranque"The drive ran out of space while the application was starting" o "There is not enough free space to start the application".
Significa Justo eso. El mensaje indica la carpeta y el espacio libre que queda.
Qué hacer Libera espacio en esa unidad y vuelve a abrir.
En marcha"The application backend stopped, restarting" y la ventana se recarga.
Significa La parte de fondo de la aplicación se detuvo de forma inesperada y la aplicación la reinició. El trabajo guardado se conserva. Lo hace como máximo dos veces en 30 minutos.
Qué hacer Sigue trabajando. Si se repite, o ves "The application backend has stopped", envíanos desktop-launcher.log y logs/backend-crash.log.
ArranqueCada vez que abres la aplicación se cierra tu sesión y el idioma vuelve a inglés.
Significa Otro programa usa el puerto 8732, el que la aplicación usa normalmente. La versión 18.5.0 elige entonces un puerto libre al azar en cada arranque, y la ventana trata cada puerto nuevo como un sitio nuevo, así que no encuentra el inicio de sesión ni el idioma.
Qué hacer Cierra o reconfigura el otro programa que usa el puerto 8732 (en Windows, ejecuta netstat -ano | findstr :8732 en una terminal para ver su ID de proceso). Tus proyectos no se ven afectados, solo el inicio de sesión y el idioma.
ArranqueTe preocupa que la aplicación choque con un PostgreSQL que ya tienes en el puerto 5432.
Significa No choca. La base de datos integrada en Windows toma un puerto local libre al azar, y en macOS y Linux escucha solo en un socket local, no en un puerto TCP.
Qué hacer No hay que hacer nada.
Instalación"“OpenConstructionERP” está dañada y no se puede abrir."
Significa La aplicación todavía no está notarizada por Apple y aún lleva la marca de descarga. La aplicación no está dañada.
Qué hacer Solo esto ayuda: en Terminal ejecuta una vez xattr -dr com.apple.quarantine /Applications/OpenConstructionERP.app y luego abre la aplicación con normalidad.
Instalación"No se puede abrir “OpenConstructionERP” porque no se puede verificar el desarrollador" (o Apple no pudo comprobar que está libre de software malicioso).
Significa La aplicación tiene firma ad hoc, pero aún no está notarizada por Apple.
Qué hacer Ejecuta el mismo comando xattr, o abre Ajustes del Sistema, Privacidad y seguridad, baja hasta el final y pulsa Abrir igualmente. Solo hace falta una vez.
InstalaciónLa aplicación no se ejecuta en tu Mac.
Significa La versión para Mac es solo para Apple Silicon (M1 y posteriores). No hay versión para Intel.
Qué hacer En un Mac con Intel usa pip (Python 3.12 o más reciente) o Docker.
Dónde están los registros
desktop-launcher.log~/.openestimate/desktop-launcher.logTodo lo que hizo la aplicación de escritorio al arrancar. Siempre en tu carpeta personal, aunque hayas movido la carpeta de datos.backend-crash.log~/.openestimate/logs/backend-crash.logDetalles de una parada inesperada. Está en la carpeta de datos, así que se mueve conOE_DATA_DIR.database log folder~/.openestimate/pgdata/logPor qué no arrancó la base de datos integrada.
Para abrir la carpeta desde una terminal:
open ~/.openestimateLinux
Linux: .deb (Ubuntu, Debian, Mint)
- 1
Descarga
OpenConstructionERP_18.5.0_amd64.deb.VerásUn archivo de unos 830 MB.
- 2
En una terminal, en la carpeta de descargas, ejecuta.
sudo apt install ./OpenConstructionERP_18.5.0_amd64.debVerásapt lista el paquete y las bibliotecas que necesita, y los instala. El ./ delante del nombre del archivo es importante.
- 3
Abre OpenConstructionERP desde el menú de aplicaciones.
VerásLa pantalla de carga. El primer arranque tarda uno o dos minutos.
- 4
Inicia sesión con la cuenta de demostración: correo demo@openconstructionerp.com, contraseña DemoPass1234!. Desde ahí puedes crear tu propia cuenta y tus proyectos.
VerásLa aplicación. Los proyectos de demostración se crean en segundo plano en el primer arranque, así que la lista de proyectos puede decir un momento que están en camino.
- 5
En una instalación nueva se le pregunta una vez al administrador qué módulos vas a usar. Marca lo que necesites y continúa. Puedes cambiarlo después con el botón Servicios en segundo plano de la barra superior.
VerásUna lista única de módulos con la memoria que necesitan.
Linux: .rpm (Fedora, RHEL, Rocky)
- 1
Descarga
OpenConstructionERP-18.5.0-1.x86_64.rpm.VerásUn archivo de unos 850 MB.
- 2
Ejecuta.
sudo dnf install ./OpenConstructionERP-18.5.0-1.x86_64.rpmVerásdnf resuelve las dependencias e instala.
- 3
Abre OpenConstructionERP desde el menú de aplicaciones.
VerásLa pantalla de carga. El primer arranque tarda uno o dos minutos.
- 4
Inicia sesión con la cuenta de demostración: correo demo@openconstructionerp.com, contraseña DemoPass1234!. Desde ahí puedes crear tu propia cuenta y tus proyectos.
VerásLa aplicación. Los proyectos de demostración se crean en segundo plano en el primer arranque, así que la lista de proyectos puede decir un momento que están en camino.
- 5
En una instalación nueva se le pregunta una vez al administrador qué módulos vas a usar. Marca lo que necesites y continúa. Puedes cambiarlo después con el botón Servicios en segundo plano de la barra superior.
VerásUna lista única de módulos con la memoria que necesitan.
Linux: AppImage (any distribution)
- 1
Descarga
OpenConstructionERP_18.5.0_amd64.AppImage.VerásUn archivo de unos 910 MB.
- 2
Hazlo ejecutable.
chmod +x OpenConstructionERP_18.5.0_amd64.AppImageVerásSin salida.
- 3
Ejecútalo.
./OpenConstructionERP_18.5.0_amd64.AppImageVerásLa pantalla de carga. El primer arranque tarda uno o dos minutos.
- 4
Inicia sesión con la cuenta de demostración: correo demo@openconstructionerp.com, contraseña DemoPass1234!. Desde ahí puedes crear tu propia cuenta y tus proyectos.
VerásLa aplicación. Los proyectos de demostración se crean en segundo plano en el primer arranque, así que la lista de proyectos puede decir un momento que están en camino.
- 5
En una instalación nueva se le pregunta una vez al administrador qué módulos vas a usar. Marca lo que necesites y continúa. Puedes cambiarlo después con el botón Servicios en segundo plano de la barra superior.
VerásUna lista única de módulos con la memoria que necesitan.
Si ves un mensaje
ArranqueLa pantalla de carga se queda un minuto o más en el primer arranque.
Significa La aplicación está creando su base de datos local. Esto pasa una sola vez.
Qué hacer Espera y no cierres la ventana. En un disco lento o casi lleno puede tardar más. Los siguientes arranques son rápidos.
Arranque"The backend started, but the local database is not answering, so the app cannot open."Significado: la parte del servidor ha arrancado, pero su base de datos local no responde, por lo que la aplicación no se puede abrir.
Significa La base de datos local no arrancó, a menudo tras una ejecución que no se cerró bien.
Qué hacer Reinicia el equipo y abre la aplicación otra vez. Si se repite, envíanos desktop-launcher.log y el registro de la base de datos (mira Registros).
Arranque"The backend started, but this installation is missing the application files it serves"Significado: la parte del servidor ha arrancado, pero a la instalación le faltan los archivos de la interfaz de usuario.
Significa Falta una parte de la carpeta del programa, normalmente borrada por el antivirus.
Qué hacer Revisa la cuarentena de tu antivirus y vuelve a ejecutar el instalador sobre la instalación existente. Tus proyectos no se tocan.
Arranque"The application backend did not start in time", o "The application backend stopped responding while preparing the local database" (o en otro paso).
Significa El arranque tardó más de lo que la aplicación espera. El mensaje indica el paso en el que estaba.
Qué hacer Cierra la ventana y vuelve a abrir. Antes libera espacio en el disco si está casi lleno. Si se detiene otra vez en el mismo paso, envíanos desktop-launcher.log.
Arranque"The application never finished unpacking itself, so its backend never started." o "The application could not unpack itself into the temporary folder it uses."
Significa En macOS y Linux la aplicación descomprime su backend en cada arranque. Un disco lento o lleno, o un antivirus que bloquea los archivos, lo impide. (La aplicación de Windows ya no se descomprime desde la 18.5.)
Qué hacer Libera espacio en la unidad de tu carpeta temporal, o permite la aplicación en tu antivirus, y vuelve a abrir.
Arranque"The drive ran out of space while the application was starting" o "There is not enough free space to start the application".
Significa Justo eso. El mensaje indica la carpeta y el espacio libre que queda.
Qué hacer Libera espacio en esa unidad y vuelve a abrir.
En marcha"The application backend stopped, restarting" y la ventana se recarga.
Significa La parte de fondo de la aplicación se detuvo de forma inesperada y la aplicación la reinició. El trabajo guardado se conserva. Lo hace como máximo dos veces en 30 minutos.
Qué hacer Sigue trabajando. Si se repite, o ves "The application backend has stopped", envíanos desktop-launcher.log y logs/backend-crash.log.
ArranqueCada vez que abres la aplicación se cierra tu sesión y el idioma vuelve a inglés.
Significa Otro programa usa el puerto 8732, el que la aplicación usa normalmente. La versión 18.5.0 elige entonces un puerto libre al azar en cada arranque, y la ventana trata cada puerto nuevo como un sitio nuevo, así que no encuentra el inicio de sesión ni el idioma.
Qué hacer Cierra o reconfigura el otro programa que usa el puerto 8732 (en Windows, ejecuta netstat -ano | findstr :8732 en una terminal para ver su ID de proceso). Tus proyectos no se ven afectados, solo el inicio de sesión y el idioma.
ArranqueTe preocupa que la aplicación choque con un PostgreSQL que ya tienes en el puerto 5432.
Significa No choca. La base de datos integrada en Windows toma un puerto local libre al azar, y en macOS y Linux escucha solo en un socket local, no en un puerto TCP.
Qué hacer No hay que hacer nada.
InstalaciónEl .deb pide libwebkit2gtk-4.1-0, o dpkg informa de dependencias sin resolver.
Significa La aplicación necesita WebKitGTK 4.1 para dibujar su ventana. dpkg -i no instala dependencias.
Qué hacer Instala con sudo apt install ./OpenConstructionERP_18.5.0_amd64.deb, que trae la biblioteca. Si tu distribución no tiene libwebkit2gtk-4.1-0 (Ubuntu anterior a 22.04, Debian anterior a 12), usa pip.
InstalaciónEl AppImage no hace nada al hacer doble clic.
Significa El archivo todavía no está marcado como programa.
Qué hacer Ejecuta chmod +x OpenConstructionERP_18.5.0_amd64.AppImage y ábrelo otra vez.
InstalaciónUn error de AppImage que menciona FUSE o libfuse.so.2.
Significa Las distribuciones nuevas ya no instalan la biblioteca FUSE 2 que usan los AppImage.
Qué hacer Instálala (sudo apt install libfuse2, en Ubuntu 24.04 sudo apt install libfuse2t64), o usa el .deb, el .rpm o pip.
Dónde están los registros
desktop-launcher.log~/.openestimate/desktop-launcher.logTodo lo que hizo la aplicación de escritorio al arrancar. Siempre en tu carpeta personal, aunque hayas movido la carpeta de datos.backend-crash.log~/.openestimate/logs/backend-crash.logDetalles de una parada inesperada. Está en la carpeta de datos, así que se mueve conOE_DATA_DIR.database log folder~/.openestimate/pgdata/logPor qué no arrancó la base de datos integrada.
Para abrir la carpeta desde una terminal:
xdg-open ~/.openestimatepip
- 1
Ejecuta.
pip install --upgrade openconstructionerpVeráspip descarga el paquete y sus dependencias.
- 2
Ejecuta.
openconstructionerpVerásUna breve bienvenida. En la primera ejecución pregunta si cargar los proyectos de demostración y si abrir el navegador.
- 3
Espera mientras prepara la base de datos local.
Verás"Database: embedded PostgreSQL 16 (no Docker)" y después arranca el servidor. Tu navegador abre http://127.0.0.1:8080 (es lo mismo que http://localhost:8080).
- 4
Inicia sesión. Con los datos de demostración puedes usar demo@openconstructionerp.com / DemoPass1234!
VerásEl panel.
- 5
En una instalación nueva se le pregunta una vez al administrador qué módulos vas a usar. Marca lo que necesites y continúa. Puedes cambiarlo después con el botón Servicios en segundo plano de la barra superior.
VerásUna lista única de módulos con la memoria que necesitan.
- 6
Para detenerlo, pulsa Ctrl+C en la terminal. La próxima vez ejecuta de nuevo openconstructionerp.
VerásEl servidor se detiene. Tus datos quedan en la carpeta
.openestimatede tu carpeta personal.
Comandos útiles
No se encuentra el comando openconstructionerp
python -m openconstructionerpAlgo no funciona: revisa Python, el puerto, la carpeta de datos y la base de datos, y dice qué hacer
openconstructionerp doctorEl puerto 8080 está ocupado por otro programa
openconstructionerp serve --port 8081Otros equipos de tu red deben poder acceder
openconstructionerp serve --host 0.0.0.0 --port 8080Tienes que decirnos tu versión
openconstructionerp --versionSi ves un mensaje
Instalaciónpip dice que no se encontró ninguna distribución compatible, o que necesita otra versión de Python.
Significa OpenConstructionERP necesita Python 3.12 o más reciente.
Qué hacer Instala Python 3.12 o más reciente y ejecuta python3.12 -m pip install --upgrade openconstructionerp (en Windows: py -3.12 -m pip install --upgrade openconstructionerp).
Instalaciónerror: externally-managed-environment (Ubuntu 23.04+, Debian 12+).Significado: su sistema Linux protege su propio Python y se niega a instalar paquetes en él.
Significa El Python del sistema no permite que pip instale en él.
Qué hacer Usa pipx install openconstructionerp, o crea antes un entorno virtual: python3 -m venv ~/oe && ~/oe/bin/pip install openconstructionerp.
Arranque"openconstructionerp" is not recognized, o command not found.
Significa La carpeta donde pip pone los comandos no está en tu PATH (frecuente en Windows).
Qué hacer Ejecuta mejor python -m openconstructionerp. Funciona en cualquier sistema sin tocar el PATH.
Arranque"Port 8080 is already in use. Try: openconstructionerp serve --port 8081"Significado: otro programa ya está usando el puerto 8080, así que inicie la aplicación en otro puerto, por ejemplo 8081.
Significa Otro programa usa el puerto 8080.
Qué hacer Ejecuta el comando sugerido y abre la dirección que muestra.
Arranque"Embedded PostgreSQL could not start".Significado: no se ha podido iniciar la base de datos PostgreSQL integrada.
Significa La base de datos integrada no pudo arrancar. El mensaje muestra la ruta de su registro.
Qué hacer Ejecuta openconstructionerp doctor. Si no ayuda, reinstala con pip install --upgrade --force-reinstall openconstructionerp y envíanos el registro que indica.
Dónde están los registros
terminal outputthe terminal window (pip);docker compose logs app(Docker)Para pip y Docker, copia lo que mostró la terminal y la salida deopenconstructionerp doctor.
Docker
- 1
En una carpeta vacía, descarga los dos archivos 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.ymlVerásDos archivos en la carpeta.
- 2
Crea el archivo de secretos una vez.
echo "POSTGRES_PASSWORD=$(openssl rand -base64 24)" > .envecho "JWT_SECRET=$(openssl rand -hex 32)" >> .envVerásUn archivo
.env. Consérvalo: contiene la contraseña de la base de datos y el secreto de inicio de sesión. - 3
Ejecútalo.
docker compose pull app && docker compose up -dVerásArrancan dos contenedores: postgres y app.
- 4
Abre http://localhost:8080 e inicia sesión con demo@openconstructionerp.com / DemoPass1234!
VerásLa página de inicio de sesión. El primer arranque puede tardar un minuto mientras se prepara la base de datos.
- 5
En una instalación nueva se le pregunta una vez al administrador qué módulos vas a usar. Marca lo que necesites y continúa. Puedes cambiarlo después con el botón Servicios en segundo plano de la barra superior.
VerásUna lista única de módulos con la memoria que necesitan.
Comandos útiles
Comprobar que los dos contenedores funcionan y están sanos
docker compose psVer por qué no arranca la aplicación
docker compose logs appEl puerto 8080 de tu equipo está ocupado
OE_PORT=8081 OE_ALLOWED_ORIGINS=http://localhost:8081 docker compose up -dEsta configuración compose es para evaluación y uso local. Para un servidor de producción mira docs/INSTALL_LINUX.md y docker-compose.prod.yml en el repositorio.
Si ves un mensaje
ArranqueCompose se detiene con "POSTGRES_PASSWORD must be set" o "JWT_SECRET must be set".
Significa Falta el archivo .env con los dos secretos, o no está en la misma carpeta.
Qué hacer Crea el archivo .env como en el paso 2, en la carpeta con docker-compose.yml.
Arranquehttp://localhost:8080 no se abre.
Significa El contenedor aún no está en marcha, o el puerto 8080 está ocupado.
Qué hacer Ejecuta docker compose ps y docker compose logs app. Para usar otro puerto: OE_PORT=8081 OE_ALLOWED_ORIGINS=http://localhost:8081 docker compose up -d y abre http://localhost:8081.
InstalaciónEn un Mac con Apple Silicon u otra máquina ARM, Docker avisa de que la plataforma de la imagen linux/amd64 no coincide, o la aplicación va muy lenta.
Significa La imagen publicada está construida solo para x86-64.
Qué hacer Compila desde el código fuente con make quickstart, o usa pip.
Dónde están los registros
terminal outputthe terminal window (pip);docker compose logs app(Docker)Para pip y Docker, copia lo que mostró la terminal y la salida deopenconstructionerp doctor.
Tus datos, actualizaciones y desinstalación
- Windows
C:\Users\<your name>\.openestimateMásC:\ProgramData\OpenConstructionERP\clusters\<id>\pgdatasi tu nombre de usuario tiene letras no latinas;pgdata.locationlo indica. - macOS~/
.openestimate(oculta; pulsa Cmd+Mayús+. en el Finder) - Linux~/
.openestimate - pip~/
.openestimate, la misma carpeta que usa la aplicación de escritorio, salvo que pases--data-diro definasOE_DATA_DIR - Dockerlos volúmenes de Docker <folder>_pg_data (base de datos) y <folder>_app_data (archivos), donde <folder> es el nombre de la carpeta con
docker-compose.yml
Actualización
Instala la versión nueva sobre la anterior. Tu carpeta .openestimate no forma parte del programa, así que proyectos, usuarios y ajustes se conservan. El primer arranque tras una actualización puede tardar más mientras la base de datos se actualiza.
Desinstalación
Al desinstalar se quita el programa y se conservan tus proyectos. En Windows el desinstalador ofrece "Delete the application data" (en el idioma del instalador): eso borra solo el inicio de sesión y el idioma guardados por la ventana de la aplicación (en %APPDATA% y %LOCALAPPDATA%\io.openconstructionerp.desktop), no tus proyectos. Para empezar de cero, desinstala, copia .openestimate a un lugar seguro y bórrala.
Copia de seguridad
Cierra la aplicación y copia la carpeta .openestimate (y la carpeta de ProgramData indicada en pgdata.location, si hay una).
¿Sigues atascado? Te ayudamos
Incluye, por favor:
- la versión (está en el nombre del archivo que descargaste; pip:
openconstructionerp --version; Docker: la etiqueta de la imagen) y cómo instalaste (instalador de Windows, .dmg, .deb, .rpm, AppImage, pip o Docker) - tu sistema (Windows: Inicio, escribe
winver; macOS: menú Apple, Acerca de este Mac; Linux: la distribución y la versión) - el texto exacto del mensaje, o una captura de pantalla
- los archivos de registro indicados arriba
Los archivos de registro pueden contener tu nombre de usuario y nombres de carpetas. Revísalos antes de publicarlos; envíalos por correo si prefieres.
Próximos pasos tras instalar
El texto completo también está en GitHub en English, Deutsch y Русский.