安装帮助
安装 OpenConstructionERP
选择您想要的运行方式，按编号步骤操作。如果出现异常，请在下方的问题列表中找到您看到的提示。安装过程中的任何警告都不会危及您的项目。
不确定需要哪一种？
- 您使用 Windows 10 或 11Windows 安装程序（.exe）
- 您有搭载 M1、M2、M3 或 M4 芯片的 MacmacOS（.dmg，Apple Silicon）
- 您有 Intel 芯片的 Macpip 或 Docker（Intel Mac 没有对应的应用）
- 您使用 Ubuntu、Debian 或 Linux MintLinux .deb
- 您使用 Fedora、RHEL 或 Rocky LinuxLinux .rpm
- 您使用其他 Linux 发行版Linux AppImage
- 您已经有 Python 3.12 或更新版本，或者想装在服务器上pip
- 您在用 Docker，或者要为团队部署Docker
先看这里
如何安装 OpenConstructionERP
Windows 上的视频演示，使用 17.7.1 版本录制。18.5 中部分界面有所不同，安装过程中的等待时间在视频里已缩短。
Windows
- 1
从发布页面下载
OpenConstructionERP_18.5.0_x64-setup.exe。您会看到“下载”文件夹里有一个约 800 MB 的文件。
- 2
双击它。如果蓝色窗口显示“Windows 已保护你的电脑”，点击“更多信息”，确认文件名以 OpenConstructionERP 开头，然后点击“仍要运行”。
您会看到Windows 会请求管理员权限。点击“是”。
- 3
选择安装程序语言，接受许可协议，并保留建议的文件夹
C:\Program Files\OpenConstructionERP。您会看到一个进度条，然后是完成页面。
- 4
点击“完成”，或从开始菜单启动 OpenConstructionERP。
您会看到显示“正在启动应用程序”的加载界面和一份清单：正在启动后端、正在启动本地数据库、正在准备数据库、正在启动应用服务器、正在打开应用。
- 5
首次启动请耐心等待，不要关闭窗口。
您会看到“首次运行会设置您的本地数据库，可能需要一两分钟，请稍候。”之后的启动快得多。
- 6
选择打开方式：应用窗口（推荐）或您常用的浏览器。
您会看到“您想如何打开 OpenConstructionERP？”，然后是登录页面。
- 7
用演示账号登录：邮箱 demo@openconstructionerp.com，密码 DemoPass1234!。之后您可以创建自己的账号和项目。
您会看到应用界面。演示项目在首次启动时于后台创建，所以项目列表可能会短暂提示它们正在准备中。
- 8
全新安装时，管理员会被问一次您要使用哪些模块。勾选需要的并继续。之后可以通过顶部栏的“后台服务”按钮更改。
您会看到一次性的模块列表，标明各自所需的内存。
如果您看到提示
安装蓝色窗口“Windows 已保护你的电脑”。
含义 安装程序还没有代码签名，所以 Windows 不认识发布者。这是一条警告，不是发现了病毒。
怎么做 点击“更多信息”，确认文件名以 OpenConstructionERP 开头，然后点击“仍要运行”。
安装智能应用控制（Smart App Control）拦截了应用，而且没有继续的按钮。
含义 Windows 11 的智能应用控制会拒绝未签名的程序。
怎么做 智能应用控制无法单独放行某个应用。如果想保持它开启，请通过 Docker Desktop 或 WSL（Windows 内置的 Linux）运行 OpenConstructionERP，智能应用控制不会检查它们。分步说明见仓库中的 docs/desktop/WINDOWS_BLOCKED.md。
安装"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"（该提示只有英文）含义：安装文件夹的路径只能包含拉丁字母、数字和空格，因为内置数据库无法从其他路径启动。
含义 您选择的文件夹路径中含有西里尔字母、中文、带重音符号的字母或其他非拉丁字符。
怎么做 保留建议的 C:\Program Files\OpenConstructionERP，或选择类似 C:\OpenConstructionERP 的文件夹。静默安装（/S）会以代码 3 退出，并把原因写入 %TEMP%\OpenConstructionERP-install-error.log。
安装安装程序因 WebView2 报错而停止。
含义 Windows 拒绝安装 Microsoft WebView2，这是绘制应用窗口的组件。它已包含在安装程序里，所以不需要联网；失败来自 Windows 本身（策略、待处理的更新，或之前损坏的 WebView2）。
怎么做 重启电脑，再运行一次安装程序。如果仍然失败，请从 Microsoft 安装“Microsoft Edge WebView2 Runtime”，然后再运行我们的安装程序。
安装杀毒软件在安装期间或首次启动时删除文件，或把文件隔离。
含义 该程序是新的且未签名，部分杀毒软件对此比较敏感。
怎么做 从隔离区恢复该文件，并把这两个文件夹加入排除项：程序文件夹 C:\Program Files\OpenConstructionERP 和您的数据文件夹 C:\Users\<your name>\.openestimate。然后在现有安装上再运行一次安装程序。如果不确定文件是否可靠，请先联系我们。
升级一个询问是覆盖已安装的版本还是先卸载的界面，其中有一行建议先卸载。
怎么做 保留已选中的选项（覆盖安装）。您的项目会保留。升级后的首次启动可能更久，因为数据库要自行更新。
升级您还在同一台电脑上用 pip 或终端运行 OpenConstructionERP，并且它在升级时停止了。
含义 两者使用同一个 .openestimate 文件夹和同一个数据库。安装程序为了替换程序会停止该数据库。从 18.4.0 升级时，旧的卸载程序还会关闭所有名为 openconstructionerp.exe 的程序。
怎么做 安装或升级前，先停止终端版本（Ctrl+C），完成后再重新启动。
启动首次启动时加载界面停留一分钟甚至更久。
含义 应用正在创建本地数据库。这只会发生一次。
怎么做 请等待，不要关闭窗口。磁盘较慢或快满时可能更久。之后的启动很快。
启动一个提示“OpenConstructionERP failed to start”并给出日志文件名的对话框。
含义 应用根本无法打开自己的窗口。
怎么做 再启动一次。如果对话框又出现，请把它给出的日志文件发给我们。
启动"The backend started, but the local database is not answering, so the app cannot open."含义：服务器部分已启动，但其本地数据库没有响应，因此无法打开应用。
含义 本地数据库没有起来，通常是在一次未正常关闭的运行之后。
怎么做 重启电脑，再次启动应用。如果重复出现，请把 desktop-launcher.log 和数据库日志发给我们（见“日志”）。
启动"The backend started, but this installation is missing the application files it serves"含义：服务器部分已启动，但安装中缺少用户界面文件。
含义 程序文件夹缺少一部分，通常是被杀毒软件删除了。
怎么做 检查杀毒软件的隔离区，然后在现有安装上再运行一次安装程序。您的项目不受影响。
启动"The application backend did not start in time"，或 "The application backend stopped responding while preparing the local database"（或在其他步骤）。
含义 启动花的时间超过了应用愿意等待的时间。提示会说明当时处于哪一步。
怎么做 关闭窗口后重新启动。如果磁盘快满了，请先腾出一些空间。如果又在同一步停下，请把 desktop-launcher.log 发给我们。
启动"The drive ran out of space while the application was starting" 或 "There is not enough free space to start the application"。
含义 就是字面意思。提示里会写出文件夹和剩余的可用空间。
怎么做 在该磁盘上腾出空间，然后重新启动。
启动一条提示，说本地数据库所在文件夹 "sits too deep in the filesystem"，并附两个数字。
含义 Windows 限制路径长度，而您的数据文件夹路径对数据库文件来说太长。在 Windows 中启用长路径没有用。
怎么做 把用户环境变量 OE_DATA_DIR 设为一个较短的路径，例如 C:\OpenConstructionERP\data（开始，输入“环境变量”，编辑账户的环境变量，新建），然后重新启动。
启动您的 Windows 用户名含有非拉丁字符（例如西里尔字母或中文），而您在找自己的数据库。
含义 内置数据库无法从这样的路径运行，所以自 18.5.0 起应用把数据库放在 C:\ProgramData\OpenConstructionERP\clusters\<id>\pgdata。在 18.5.0 之前，这类账户下应用根本无法启动。
怎么做 无需修复。您的 .openestimate 文件夹中的 pgdata.location 文件写明了数据库文件夹的确切位置。备份时请复制两个文件夹。
运行中"The application backend stopped, restarting"，窗口随后重新加载。
含义 应用的后台部分意外停止，应用已将其重启。已保存的工作不会丢失。30 分钟内最多重启两次。
怎么做 继续使用即可。如果重复出现，或者看到 "The application backend has stopped"，请把 desktop-launcher.log 和 logs/backend-crash.log 发给我们。
启动每次启动应用都会退出登录，语言也变回英语。
含义 另一个程序占用了端口 8732，也就是应用通常使用的端口。此时 18.5.0 版本每次启动都会随机选一个空闲端口，而窗口把每个新端口都当作新网站，所以找不到登录状态和语言设置。
怎么做 关闭或重新配置占用端口 8732 的那个程序（在 Windows 上，可在终端运行 netstat -ano | findstr :8732 查看它的进程 ID）。您的项目不受影响，受影响的只有登录状态和语言选择。
启动您担心应用与已在端口 5432 上运行的 PostgreSQL 冲突。
含义 不会冲突。Windows 上内置数据库使用随机的空闲本地端口，macOS 和 Linux 上它只监听本地套接字，不占用 TCP 端口。
怎么做 无需处理。
日志在哪里
desktop-launcher.logC:\Users\<your name>\.openestimate\desktop-launcher.log桌面应用启动时所做的一切。始终在您的主目录里，即使您移动了数据文件夹。backend-crash.logC:\Users\<your name>\.openestimate\logs\backend-crash.log意外停止的详细信息。它在数据文件夹中，所以会随OE_DATA_DIR一起移动。database log folderC:\Users\<your name>\.openestimate\pgdata\log (or <folder frompgdata.location>\log)内置数据库为什么没有启动。OpenConstructionERP-install-error.log%TEMP%\OpenConstructionERP-install-error.log（在资源管理器的地址栏中输入%TEMP%）Windows 安装程序为什么拒绝了安装文件夹。
要打开该文件夹，请把下面的内容粘贴到资源管理器的地址栏：
%USERPROFILE%\.openestimatemacOS
- 1
下载
OpenConstructionERP_18.5.0_aarch64.dmg并打开。您会看到一个带有 OpenConstructionERP 应用图标的窗口。
- 2
把 OpenConstructionERP 拖到“应用程序”文件夹。
您会看到应用出现在“应用程序”文件夹中。
- 3
打开一次“终端”，运行下面的命令。
xattr -dr com.apple.quarantine /Applications/OpenConstructionERP.app您会看到没有输出。这是正常的。该命令会清除下载标记，因为应用还没有通过 Apple 公证。
- 4
从“应用程序”中打开 OpenConstructionERP。
您会看到加载界面“正在启动应用程序”。首次启动会设置本地数据库，需要一两分钟。
- 5
选择应用窗口或浏览器。
您会看到登录页面。
- 6
用演示账号登录：邮箱 demo@openconstructionerp.com，密码 DemoPass1234!。之后您可以创建自己的账号和项目。
您会看到应用界面。演示项目在首次启动时于后台创建，所以项目列表可能会短暂提示它们正在准备中。
- 7
全新安装时，管理员会被问一次您要使用哪些模块。勾选需要的并继续。之后可以通过顶部栏的“后台服务”按钮更改。
您会看到一次性的模块列表，标明各自所需的内存。
如果您看到提示
启动首次启动时加载界面停留一分钟甚至更久。
含义 应用正在创建本地数据库。这只会发生一次。
怎么做 请等待，不要关闭窗口。磁盘较慢或快满时可能更久。之后的启动很快。
启动"The backend started, but the local database is not answering, so the app cannot open."含义：服务器部分已启动，但其本地数据库没有响应，因此无法打开应用。
含义 本地数据库没有起来，通常是在一次未正常关闭的运行之后。
怎么做 重启电脑，再次启动应用。如果重复出现，请把 desktop-launcher.log 和数据库日志发给我们（见“日志”）。
启动"The backend started, but this installation is missing the application files it serves"含义：服务器部分已启动，但安装中缺少用户界面文件。
含义 程序文件夹缺少一部分，通常是被杀毒软件删除了。
怎么做 检查杀毒软件的隔离区，然后在现有安装上再运行一次安装程序。您的项目不受影响。
启动"The application backend did not start in time"，或 "The application backend stopped responding while preparing the local database"（或在其他步骤）。
含义 启动花的时间超过了应用愿意等待的时间。提示会说明当时处于哪一步。
怎么做 关闭窗口后重新启动。如果磁盘快满了，请先腾出一些空间。如果又在同一步停下，请把 desktop-launcher.log 发给我们。
启动"The application never finished unpacking itself, so its backend never started." 或 "The application could not unpack itself into the temporary folder it uses."
含义 在 macOS 和 Linux 上，应用每次启动都要解包后端。磁盘慢或已满，或杀毒软件锁定文件，都会使解包失败。（Windows 版自 18.5 起不再自行解包。）
怎么做 在放临时文件夹的磁盘上腾出空间，或在杀毒软件中允许该应用，然后重新启动。
启动"The drive ran out of space while the application was starting" 或 "There is not enough free space to start the application"。
含义 就是字面意思。提示里会写出文件夹和剩余的可用空间。
怎么做 在该磁盘上腾出空间，然后重新启动。
运行中"The application backend stopped, restarting"，窗口随后重新加载。
含义 应用的后台部分意外停止，应用已将其重启。已保存的工作不会丢失。30 分钟内最多重启两次。
怎么做 继续使用即可。如果重复出现，或者看到 "The application backend has stopped"，请把 desktop-launcher.log 和 logs/backend-crash.log 发给我们。
启动每次启动应用都会退出登录，语言也变回英语。
含义 另一个程序占用了端口 8732，也就是应用通常使用的端口。此时 18.5.0 版本每次启动都会随机选一个空闲端口，而窗口把每个新端口都当作新网站，所以找不到登录状态和语言设置。
怎么做 关闭或重新配置占用端口 8732 的那个程序（在 Windows 上，可在终端运行 netstat -ano | findstr :8732 查看它的进程 ID）。您的项目不受影响，受影响的只有登录状态和语言选择。
启动您担心应用与已在端口 5432 上运行的 PostgreSQL 冲突。
含义 不会冲突。Windows 上内置数据库使用随机的空闲本地端口，macOS 和 Linux 上它只监听本地套接字，不占用 TCP 端口。
怎么做 无需处理。
安装“OpenConstructionERP”已损坏，无法打开。
含义 应用还没有通过 Apple 公证，仍带着下载标记。应用本身并没有损坏。
怎么做 只有这个办法有效：在“终端”中运行一次 xattr -dr com.apple.quarantine /Applications/OpenConstructionERP.app，然后像平常一样打开应用。
安装无法打开“OpenConstructionERP”，因为无法验证开发者（或 Apple 无法验证其不含恶意软件）。
含义 应用做了临时（ad hoc）签名，但还没有通过 Apple 公证。
怎么做 运行同一条 xattr 命令，或打开“系统设置”，进入“隐私与安全性”，向下滚动并点击“仍要打开”。这只需要做一次。
安装应用在您的 Mac 上完全无法运行。
含义 Mac 版只支持 Apple Silicon（M1 及更新）。没有 Intel 版。
怎么做 Intel Mac 请使用 pip（Python 3.12 或更新）或 Docker。
日志在哪里
desktop-launcher.log~/.openestimate/desktop-launcher.log桌面应用启动时所做的一切。始终在您的主目录里，即使您移动了数据文件夹。backend-crash.log~/.openestimate/logs/backend-crash.log意外停止的详细信息。它在数据文件夹中，所以会随OE_DATA_DIR一起移动。database log folder~/.openestimate/pgdata/log内置数据库为什么没有启动。
要在终端里打开该文件夹：
open ~/.openestimateLinux
Linux: .deb (Ubuntu, Debian, Mint)
- 1
下载
OpenConstructionERP_18.5.0_amd64.deb。您会看到一个约 830 MB 的文件。
- 2
在下载文件夹中打开终端，运行。
sudo apt install ./OpenConstructionERP_18.5.0_amd64.deb您会看到apt 会列出该软件包和所需的库，然后安装它们。文件名前面的 ./ 很重要。
- 3
从应用程序菜单启动 OpenConstructionERP。
您会看到加载界面。首次启动需要一两分钟。
- 4
用演示账号登录：邮箱 demo@openconstructionerp.com，密码 DemoPass1234!。之后您可以创建自己的账号和项目。
您会看到应用界面。演示项目在首次启动时于后台创建，所以项目列表可能会短暂提示它们正在准备中。
- 5
全新安装时，管理员会被问一次您要使用哪些模块。勾选需要的并继续。之后可以通过顶部栏的“后台服务”按钮更改。
您会看到一次性的模块列表，标明各自所需的内存。
Linux: .rpm (Fedora, RHEL, Rocky)
- 1
下载
OpenConstructionERP-18.5.0-1.x86_64.rpm。您会看到一个约 850 MB 的文件。
- 2
运行。
sudo dnf install ./OpenConstructionERP-18.5.0-1.x86_64.rpm您会看到dnf 会解析依赖并安装。
- 3
从应用程序菜单启动 OpenConstructionERP。
您会看到加载界面。首次启动需要一两分钟。
- 4
用演示账号登录：邮箱 demo@openconstructionerp.com，密码 DemoPass1234!。之后您可以创建自己的账号和项目。
您会看到应用界面。演示项目在首次启动时于后台创建，所以项目列表可能会短暂提示它们正在准备中。
- 5
全新安装时，管理员会被问一次您要使用哪些模块。勾选需要的并继续。之后可以通过顶部栏的“后台服务”按钮更改。
您会看到一次性的模块列表，标明各自所需的内存。
Linux: AppImage (any distribution)
- 1
下载
OpenConstructionERP_18.5.0_amd64.AppImage。您会看到一个约 910 MB 的文件。
- 2
让它可执行。
chmod +x OpenConstructionERP_18.5.0_amd64.AppImage您会看到没有输出。
- 3
运行它。
./OpenConstructionERP_18.5.0_amd64.AppImage您会看到加载界面。首次启动需要一两分钟。
- 4
用演示账号登录：邮箱 demo@openconstructionerp.com，密码 DemoPass1234!。之后您可以创建自己的账号和项目。
您会看到应用界面。演示项目在首次启动时于后台创建，所以项目列表可能会短暂提示它们正在准备中。
- 5
全新安装时，管理员会被问一次您要使用哪些模块。勾选需要的并继续。之后可以通过顶部栏的“后台服务”按钮更改。
您会看到一次性的模块列表，标明各自所需的内存。
如果您看到提示
启动首次启动时加载界面停留一分钟甚至更久。
含义 应用正在创建本地数据库。这只会发生一次。
怎么做 请等待，不要关闭窗口。磁盘较慢或快满时可能更久。之后的启动很快。
启动"The backend started, but the local database is not answering, so the app cannot open."含义：服务器部分已启动，但其本地数据库没有响应，因此无法打开应用。
含义 本地数据库没有起来，通常是在一次未正常关闭的运行之后。
怎么做 重启电脑，再次启动应用。如果重复出现，请把 desktop-launcher.log 和数据库日志发给我们（见“日志”）。
启动"The backend started, but this installation is missing the application files it serves"含义：服务器部分已启动，但安装中缺少用户界面文件。
含义 程序文件夹缺少一部分，通常是被杀毒软件删除了。
怎么做 检查杀毒软件的隔离区，然后在现有安装上再运行一次安装程序。您的项目不受影响。
启动"The application backend did not start in time"，或 "The application backend stopped responding while preparing the local database"（或在其他步骤）。
含义 启动花的时间超过了应用愿意等待的时间。提示会说明当时处于哪一步。
怎么做 关闭窗口后重新启动。如果磁盘快满了，请先腾出一些空间。如果又在同一步停下，请把 desktop-launcher.log 发给我们。
启动"The application never finished unpacking itself, so its backend never started." 或 "The application could not unpack itself into the temporary folder it uses."
含义 在 macOS 和 Linux 上，应用每次启动都要解包后端。磁盘慢或已满，或杀毒软件锁定文件，都会使解包失败。（Windows 版自 18.5 起不再自行解包。）
怎么做 在放临时文件夹的磁盘上腾出空间，或在杀毒软件中允许该应用，然后重新启动。
启动"The drive ran out of space while the application was starting" 或 "There is not enough free space to start the application"。
含义 就是字面意思。提示里会写出文件夹和剩余的可用空间。
怎么做 在该磁盘上腾出空间，然后重新启动。
运行中"The application backend stopped, restarting"，窗口随后重新加载。
含义 应用的后台部分意外停止，应用已将其重启。已保存的工作不会丢失。30 分钟内最多重启两次。
怎么做 继续使用即可。如果重复出现，或者看到 "The application backend has stopped"，请把 desktop-launcher.log 和 logs/backend-crash.log 发给我们。
启动每次启动应用都会退出登录，语言也变回英语。
含义 另一个程序占用了端口 8732，也就是应用通常使用的端口。此时 18.5.0 版本每次启动都会随机选一个空闲端口，而窗口把每个新端口都当作新网站，所以找不到登录状态和语言设置。
怎么做 关闭或重新配置占用端口 8732 的那个程序（在 Windows 上，可在终端运行 netstat -ano | findstr :8732 查看它的进程 ID）。您的项目不受影响，受影响的只有登录状态和语言选择。
启动您担心应用与已在端口 5432 上运行的 PostgreSQL 冲突。
含义 不会冲突。Windows 上内置数据库使用随机的空闲本地端口，macOS 和 Linux 上它只监听本地套接字，不占用 TCP 端口。
怎么做 无需处理。
安装.deb 要求 libwebkit2gtk-4.1-0，或者 dpkg 报告依赖未满足。
含义 应用需要 WebKitGTK 4.1 来绘制窗口。dpkg -i 不会安装依赖。
怎么做 用 sudo apt install ./OpenConstructionERP_18.5.0_amd64.deb 安装，它会把库一并装上。如果您的发行版没有 libwebkit2gtk-4.1-0（早于 22.04 的 Ubuntu、早于 12 的 Debian），请使用 pip。
安装双击 AppImage 没有任何反应。
含义 文件还没有被标记为程序。
怎么做 运行 chmod +x OpenConstructionERP_18.5.0_amd64.AppImage，然后再启动一次。
安装提到 FUSE 或 libfuse.so.2 的 AppImage 错误。
含义 较新的发行版不再默认安装 AppImage 所用的 FUSE 2 库。
怎么做 安装它（sudo apt install libfuse2，Ubuntu 24.04 上用 sudo apt install libfuse2t64），或者改用 .deb、.rpm 或 pip。
日志在哪里
desktop-launcher.log~/.openestimate/desktop-launcher.log桌面应用启动时所做的一切。始终在您的主目录里，即使您移动了数据文件夹。backend-crash.log~/.openestimate/logs/backend-crash.log意外停止的详细信息。它在数据文件夹中，所以会随OE_DATA_DIR一起移动。database log folder~/.openestimate/pgdata/log内置数据库为什么没有启动。
要在终端里打开该文件夹：
xdg-open ~/.openestimatepip
- 1
运行。
pip install --upgrade openconstructionerp您会看到pip 会下载软件包及其依赖。
- 2
运行。
openconstructionerp您会看到一段简短的欢迎信息。首次运行时它会询问是否加载演示项目、是否打开浏览器。
- 3
请等待本地数据库设置完成。
您会看到"Database: embedded PostgreSQL 16 (no Docker)"，然后服务器启动。浏览器会打开 http://127.0.0.1:8080（与 http://localhost:8080 相同）。
- 4
登录。使用演示数据时可以用 demo@openconstructionerp.com / DemoPass1234!
您会看到仪表板。
- 5
全新安装时，管理员会被问一次您要使用哪些模块。勾选需要的并继续。之后可以通过顶部栏的“后台服务”按钮更改。
您会看到一次性的模块列表，标明各自所需的内存。
- 6
要停止，请在终端按 Ctrl+C。下次再运行 openconstructionerp 即可。
您会看到服务器停止。您的数据保留在主目录下的
.openestimate文件夹中。
常用命令
找不到 openconstructionerp 命令
python -m openconstructionerp出了问题：检查 Python、端口、数据文件夹和数据库，并告诉您该怎么做
openconstructionerp doctor端口 8080 被其他程序占用
openconstructionerp serve --port 8081您希望网络里的其他电脑也能访问
openconstructionerp serve --host 0.0.0.0 --port 8080您需要告诉我们您的版本
openconstructionerp --version如果您看到提示
安装pip 提示找不到匹配的发行版，或者要求使用其他版本的 Python。
含义 OpenConstructionERP 需要 Python 3.12 或更新版本。
怎么做 安装 Python 3.12 或更新版本，然后运行 python3.12 -m pip install --upgrade openconstructionerp（Windows 上：py -3.12 -m pip install --upgrade openconstructionerp）。
安装error: externally-managed-environment (Ubuntu 23.04+, Debian 12+)。含义：您的 Linux 系统保护其自带的 Python，拒绝向其中安装软件包。
含义 系统自带的 Python 不允许 pip 往里面安装。
怎么做 使用 pipx install openconstructionerp，或者先创建虚拟环境：python3 -m venv ~/oe && ~/oe/bin/pip install openconstructionerp。
启动"openconstructionerp" is not recognized，或 command not found。
含义 pip 存放命令的文件夹不在您的 PATH 里（在 Windows 上很常见）。
怎么做 改为运行 python -m openconstructionerp。它在所有系统上都能用，不必改动 PATH。
启动"Port 8080 is already in use. Try: openconstructionerp serve --port 8081"含义：另一个程序已占用端口 8080，请改用其他端口启动应用，例如 8081。
含义 另一个程序占用了端口 8080。
怎么做 运行它建议的命令，并打开它输出的地址。
启动"Embedded PostgreSQL could not start"。含义：内置的 PostgreSQL 数据库无法启动。
含义 内置数据库启动失败。提示中会打印它的日志路径。
怎么做 运行 openconstructionerp doctor。如果没有帮助，用 pip install --upgrade --force-reinstall openconstructionerp 重新安装，并把它给出的日志发给我们。
日志在哪里
terminal outputthe terminal window (pip);docker compose logs app(Docker)对于 pip 和 Docker，请复制终端打印的内容以及openconstructionerp doctor的输出。
Docker
- 1
在一个空文件夹里下载两个 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.yml您会看到文件夹里有两个文件。
- 2
创建一次密钥文件。
echo "POSTGRES_PASSWORD=$(openssl rand -base64 24)" > .envecho "JWT_SECRET=$(openssl rand -hex 32)" >> .env您会看到一个
.env文件。请保管好：里面有数据库密码和登录密钥。 - 3
启动它。
docker compose pull app && docker compose up -d您会看到两个容器启动：postgres 和 app。
- 4
打开 http://localhost:8080，用 demo@openconstructionerp.com / DemoPass1234! 登录。
您会看到登录页面。首次启动可能要一分钟，用来准备数据库。
- 5
全新安装时，管理员会被问一次您要使用哪些模块。勾选需要的并继续。之后可以通过顶部栏的“后台服务”按钮更改。
您会看到一次性的模块列表，标明各自所需的内存。
常用命令
检查两个容器是否都在运行且状态健康
docker compose ps查看应用为什么没有启动
docker compose logs app您机器上的端口 8080 被占用
OE_PORT=8081 OE_ALLOWED_ORIGINS=http://localhost:8081 docker compose up -d这套 compose 配置用于评估和本地使用。生产服务器请参阅仓库中的 docs/INSTALL_LINUX.md 和 docker-compose.prod.yml。
如果您看到提示
启动Compose 停止并提示 "POSTGRES_PASSWORD must be set" 或 "JWT_SECRET must be set"。
含义 包含两个密钥的 .env 文件不存在，或不在同一文件夹中。
怎么做 按第 2 步创建 .env 文件，放在有 docker-compose.yml 的文件夹里。
启动http://localhost:8080 打不开。
含义 容器还没有运行，或者端口 8080 被占用。
怎么做 运行 docker compose ps 和 docker compose logs app。要换一个端口：OE_PORT=8081 OE_ALLOWED_ORIGINS=http://localhost:8081 docker compose up -d，然后打开 http://localhost:8081。
安装在搭载 Apple Silicon 的 Mac 或其他 ARM 机器上，Docker 警告镜像平台 linux/amd64 不匹配，或者应用运行得很慢。
含义 发布的镜像只为 x86-64 构建。
怎么做 用 make quickstart 从源码构建，或者使用 pip。
日志在哪里
terminal outputthe terminal window (pip);docker compose logs app(Docker)对于 pip 和 Docker，请复制终端打印的内容以及openconstructionerp doctor的输出。
您的数据、升级与卸载
- Windows
C:\Users\<your name>\.openestimate如果您的用户名含有非拉丁字符，还有C:\ProgramData\OpenConstructionERP\clusters\<id>\pgdata；pgdata.location里写明了位置。 - macOS~/
.openestimate（隐藏；在“访达”中按 Cmd+Shift+.） - Linux~/
.openestimate - pip~/
.openestimate，与桌面应用相同的文件夹，除非您传入--data-dir或设置了OE_DATA_DIR - DockerDocker 卷 <folder>_pg_data（数据库）和 <folder>_app_data（文件），其中 <folder> 是放有
docker-compose.yml的文件夹名
升级
直接把新版本安装到旧版本上。您的 .openestimate 文件夹不属于程序本身，所以项目、用户和设置都会保留。升级后的首次启动可能更久，因为数据库要自行更新。
卸载
卸载会删除程序，保留您的项目。在 Windows 上，卸载程序会提供 "Delete the application data"（使用安装程序的语言）：它只删除应用窗口保存的登录状态和语言（位于 %APPDATA% 和 %LOCALAPPDATA%\io.openconstructionerp.desktop），不会删除您的项目。要从头开始，请先卸载，把 .openestimate 复制到安全的地方，再删除它。
备份
关闭应用，复制 .openestimate 文件夹（如果有，还要复制 pgdata.location 中写明的 ProgramData 文件夹）。
还是解决不了？我们来帮您
请附上：
- 版本（在您下载的文件名里；pip：
openconstructionerp --version；Docker：镜像标签）以及您的安装方式（Windows 安装程序、.dmg、.deb、.rpm、AppImage、pip 或 Docker） - 您的系统（Windows：开始，输入
winver；macOS：Apple 菜单，关于本机；Linux：发行版和版本） - 提示的完整文字，或一张截图
- 上面列出的日志文件
日志文件可能包含您的用户名和文件夹名。公开发布前请先检查；也可以改用邮件发送。