OpenConstructionERP のインストール

意味 インストーラーにはまだコード署名がないため、Windows は発行元を判断できません。これは警告であり、ウイルスが見つかったわけではありません。

対処 「詳細情報」をクリックし、ファイル名が OpenConstructionERP で始まっていることを確認して、「実行」をクリックします。

意味 Windows 11 のスマート アプリ コントロールは、署名のないプログラムを拒否します。

対処 スマート アプリ コントロールでは、アプリを 1 つだけ許可することはできません。オンのまま使いたい場合は、スマート アプリ コントロールの対象外である Docker Desktop または WSL（Windows 内蔵の Linux）で OpenConstructionERP を実行してください。手順はリポジトリの docs/desktop/WINDOWS_BLOCKED.md にあります。

意味 選んだフォルダーのパスに、キリル文字、漢字、アクセント付き文字などラテン文字以外の文字が含まれています。

対処 既定の C:\Program Files\OpenConstructionERP のままにするか、C:\OpenConstructionERP のようなフォルダーを選びます。サイレントインストール（/S）はコード 3 で終了し、理由を %TEMP%\OpenConstructionERP-install-error.log に書き込みます。

意味 アプリのウィンドウを描画するコンポーネント Microsoft WebView2 を、Windows がインストールさせませんでした。インストーラーに含まれているのでインターネットは不要です。原因は Windows 側にあります（ポリシー、保留中の更新、以前の WebView2 の破損など）。

対処 パソコンを再起動して、もう一度インストーラーを実行します。それでも失敗する場合は、Microsoft から「Microsoft Edge WebView2 Runtime」をインストールしたうえで、当社のインストーラーをもう一度実行してください。

意味 このプログラムは新しく署名がないため、一部のウイルス対策ソフトが警戒します。

対処 隔離されたファイルを復元し、次の 2 つのフォルダーを除外に追加します。プログラムフォルダー C:\Program Files\OpenConstructionERP と、データフォルダー C:\Users\<your name>\.openestimate です。そのあと、既存のインストールに上書きする形でインストーラーをもう一度実行します。ファイルが本物かどうか不安な場合は、先にご連絡ください。

対処 すでに選択されている項目（上書き）のままにします。プロジェクトは保持されます。アップグレード後の初回起動は、データベースが自動で更新されるため時間がかかることがあります。

意味 どちらも同じ .openestimate フォルダーとデータベースを使います。インストーラーはプログラムを入れ替えるためにそのデータベースを停止します。18.4.0 からアップグレードする場合、古いアンインストーラーは openconstructionerp.exe という名前のプログラムもすべて終了させます。

対処 インストールやアップグレードの前にターミナル版を停止（Ctrl+C）し、終わってからもう一度起動します。

意味 アプリがローカルデータベースを作成しています。これは一度だけです。

対処 そのままお待ちいただき、ウィンドウを閉じないでください。ディスクが遅い、または空きが少ないと時間がかかることがあります。2 回目以降は速く起動します。

意味 アプリがウィンドウをまったく開けませんでした。

対処 もう一度起動してください。ボックスがまた出る場合は、書かれているログファイルを送ってください。

意味 ローカルデータベースが立ち上がりませんでした。正常に終了しなかった実行のあとによく起こります。

対処 パソコンを再起動して、アプリをもう一度起動します。繰り返す場合は、desktop-launcher.log とデータベースのログ（「ログ」を参照）を送ってください。

意味 プログラムフォルダーの一部が欠けています。多くはウイルス対策ソフトが削除したものです。

対処 ウイルス対策ソフトの隔離場所を確認してから、既存のインストールに上書きする形でインストーラーをもう一度実行します。プロジェクトには手を加えません。

意味 起動に、アプリが待つ時間より長くかかりました。メッセージに、どの手順で止まったかが書かれています。

対処 ウィンドウを閉じて、もう一度起動します。ディスクの空きがほとんどない場合は、先に空きを作ってください。同じ手順でまた止まる場合は、desktop-launcher.log を送ってください。

意味 文字どおりの意味です。メッセージに、フォルダーと残りの空き容量が書かれています。

対処 そのドライブの空きを増やして、もう一度起動します。

意味 Windows にはパスの長さに上限があり、データフォルダーのパスがデータベースのファイルには長すぎます。Windows の長いパスを有効にしても解決しません。

対処 ユーザー環境変数 OE_DATA_DIR を、C:\OpenConstructionERP\data のような短いパスに設定し（スタートで「環境変数」と入力し、「アカウントの環境変数を編集」から「新規」）、もう一度起動します。

意味 内蔵データベースはそのようなパスでは動かないため、18.5.0 以降、アプリはデータベースを C:\ProgramData\OpenConstructionERP\clusters\<id>\pgdata に置きます。18.5.0 より前は、そのようなアカウントではアプリがまったく起動しませんでした。

対処 直す必要はありません。.openestimate フォルダー内の pgdata.location ファイルに、データベースフォルダーの正確な場所が書かれています。バックアップでは両方のフォルダーをコピーします。

意味 アプリのバックグラウンド部分が予期せず停止したため、アプリが再起動しました。保存済みの作業は保持されます。30 分間に最大 2 回までです。

対処 そのままお使いください。繰り返す場合や "The application backend has stopped" と表示された場合は、desktop-launcher.log と logs/backend-crash.log を送ってください。

意味 別のプログラムが、アプリが通常使うポート 8732 を使っています。その場合 18.5.0 は起動のたびに空いているポートをランダムに選び、ウィンドウは新しいポートを新しいサイトとして扱うため、サインインと言語の設定が見つかりません。

対処 ポート 8732 を使っているもう一方のプログラムを終了するか、設定を変更します（Windows ではターミナルで netstat -ano | findstr :8732 を実行すると、プロセス ID がわかります）。プロジェクトには影響せず、影響を受けるのはサインインと言語の選択だけです。

意味 競合しません。Windows では内蔵データベースが空いているローカルポートをランダムに使い、macOS と Linux ではローカルソケットだけを待ち受けて、TCP ポートは使いません。

対処 対処は不要です。

意味 アプリがローカルデータベースを作成しています。これは一度だけです。

対処 そのままお待ちいただき、ウィンドウを閉じないでください。ディスクが遅い、または空きが少ないと時間がかかることがあります。2 回目以降は速く起動します。

意味 ローカルデータベースが立ち上がりませんでした。正常に終了しなかった実行のあとによく起こります。

対処 パソコンを再起動して、アプリをもう一度起動します。繰り返す場合は、desktop-launcher.log とデータベースのログ（「ログ」を参照）を送ってください。

意味 プログラムフォルダーの一部が欠けています。多くはウイルス対策ソフトが削除したものです。

対処 ウイルス対策ソフトの隔離場所を確認してから、既存のインストールに上書きする形でインストーラーをもう一度実行します。プロジェクトには手を加えません。

意味 起動に、アプリが待つ時間より長くかかりました。メッセージに、どの手順で止まったかが書かれています。

対処 ウィンドウを閉じて、もう一度起動します。ディスクの空きがほとんどない場合は、先に空きを作ってください。同じ手順でまた止まる場合は、desktop-launcher.log を送ってください。

意味 macOS と Linux では、アプリは起動のたびにバックエンドを展開します。ディスクが遅い、いっぱい、またはウイルス対策ソフトがファイルをロックしていると、展開できません。（Windows 版は 18.5 以降、自己展開をしなくなりました。）

対処 一時フォルダーのあるドライブの空きを増やすか、ウイルス対策ソフトでアプリを許可してから、もう一度起動します。

意味 文字どおりの意味です。メッセージに、フォルダーと残りの空き容量が書かれています。

対処 そのドライブの空きを増やして、もう一度起動します。

意味 アプリのバックグラウンド部分が予期せず停止したため、アプリが再起動しました。保存済みの作業は保持されます。30 分間に最大 2 回までです。

対処 そのままお使いください。繰り返す場合や "The application backend has stopped" と表示された場合は、desktop-launcher.log と logs/backend-crash.log を送ってください。

意味 別のプログラムが、アプリが通常使うポート 8732 を使っています。その場合 18.5.0 は起動のたびに空いているポートをランダムに選び、ウィンドウは新しいポートを新しいサイトとして扱うため、サインインと言語の設定が見つかりません。

対処 ポート 8732 を使っているもう一方のプログラムを終了するか、設定を変更します（Windows ではターミナルで netstat -ano | findstr :8732 を実行すると、プロセス ID がわかります）。プロジェクトには影響せず、影響を受けるのはサインインと言語の選択だけです。

意味 競合しません。Windows では内蔵データベースが空いているローカルポートをランダムに使い、macOS と Linux ではローカルソケットだけを待ち受けて、TCP ポートは使いません。

対処 対処は不要です。

意味 アプリはまだ Apple の公証を受けておらず、ダウンロードの印が残っています。アプリが壊れているわけではありません。

対処 効果があるのはこれだけです。ターミナルで一度 xattr -dr com.apple.quarantine /Applications/OpenConstructionERP.app を実行し、そのあと通常どおりアプリを開きます。

意味 アプリはアドホック署名されていますが、まだ Apple の公証を受けていません。

対処 同じ xattr コマンドを実行するか、「システム設定」の「プライバシーとセキュリティ」を開き、下へスクロールして「このまま開く」をクリックします。必要なのは一度だけです。

意味 Mac 版は Apple Silicon（M1 以降）専用です。Intel 向けのビルドはありません。

対処 Intel Mac では pip（Python 3.12 以上）または Docker を使ってください。

意味 アプリがローカルデータベースを作成しています。これは一度だけです。

対処 そのままお待ちいただき、ウィンドウを閉じないでください。ディスクが遅い、または空きが少ないと時間がかかることがあります。2 回目以降は速く起動します。

意味 ローカルデータベースが立ち上がりませんでした。正常に終了しなかった実行のあとによく起こります。

対処 パソコンを再起動して、アプリをもう一度起動します。繰り返す場合は、desktop-launcher.log とデータベースのログ（「ログ」を参照）を送ってください。

意味 プログラムフォルダーの一部が欠けています。多くはウイルス対策ソフトが削除したものです。

対処 ウイルス対策ソフトの隔離場所を確認してから、既存のインストールに上書きする形でインストーラーをもう一度実行します。プロジェクトには手を加えません。

意味 起動に、アプリが待つ時間より長くかかりました。メッセージに、どの手順で止まったかが書かれています。

対処 ウィンドウを閉じて、もう一度起動します。ディスクの空きがほとんどない場合は、先に空きを作ってください。同じ手順でまた止まる場合は、desktop-launcher.log を送ってください。

意味 macOS と Linux では、アプリは起動のたびにバックエンドを展開します。ディスクが遅い、いっぱい、またはウイルス対策ソフトがファイルをロックしていると、展開できません。（Windows 版は 18.5 以降、自己展開をしなくなりました。）

対処 一時フォルダーのあるドライブの空きを増やすか、ウイルス対策ソフトでアプリを許可してから、もう一度起動します。

意味 文字どおりの意味です。メッセージに、フォルダーと残りの空き容量が書かれています。

対処 そのドライブの空きを増やして、もう一度起動します。

意味 アプリのバックグラウンド部分が予期せず停止したため、アプリが再起動しました。保存済みの作業は保持されます。30 分間に最大 2 回までです。

対処 そのままお使いください。繰り返す場合や "The application backend has stopped" と表示された場合は、desktop-launcher.log と logs/backend-crash.log を送ってください。

意味 別のプログラムが、アプリが通常使うポート 8732 を使っています。その場合 18.5.0 は起動のたびに空いているポートをランダムに選び、ウィンドウは新しいポートを新しいサイトとして扱うため、サインインと言語の設定が見つかりません。

対処 ポート 8732 を使っているもう一方のプログラムを終了するか、設定を変更します（Windows ではターミナルで netstat -ano | findstr :8732 を実行すると、プロセス ID がわかります）。プロジェクトには影響せず、影響を受けるのはサインインと言語の選択だけです。

意味 競合しません。Windows では内蔵データベースが空いているローカルポートをランダムに使い、macOS と Linux ではローカルソケットだけを待ち受けて、TCP ポートは使いません。

対処 対処は不要です。

意味 アプリがウィンドウを描画するには WebKitGTK 4.1 が必要です。dpkg -i は依存関係をインストールしません。

対処 sudo apt install ./OpenConstructionERP_18.5.0_amd64.deb でインストールすると、ライブラリも一緒に入ります。お使いのディストリビューションに libwebkit2gtk-4.1-0 がない場合（22.04 より古い Ubuntu、12 より古い Debian）は、pip を使ってください。

意味 ファイルがまだプログラムとして設定されていません。

対処 chmod +x OpenConstructionERP_18.5.0_amd64.AppImage を実行して、もう一度起動します。

意味 新しいディストリビューションは、AppImage が使う FUSE 2 ライブラリを標準ではインストールしなくなりました。

対処 インストールします（sudo apt install libfuse2、Ubuntu 24.04 では sudo apt install libfuse2t64）。または .deb、.rpm、pip を使います。

意味 OpenConstructionERP には Python 3.12 以上が必要です。

対処 Python 3.12 以上をインストールして、python3.12 -m pip install --upgrade openconstructionerp を実行します（Windows では py -3.12 -m pip install --upgrade openconstructionerp）。

意味 システムの Python では、pip によるインストールが許可されていません。

対処 pipx install openconstructionerp を使うか、先に仮想環境を作ります：python3 -m venv ~/oe && ~/oe/bin/pip install openconstructionerp。

意味 pip がコマンドを置くフォルダーが PATH に入っていません（Windows でよくあります）。

対処 代わりに python -m openconstructionerp を実行します。PATH をいじらずに、どのシステムでも動きます。

意味 ほかのプログラムがポート 8080 を使っています。

対処 案内されたコマンドを実行し、表示されたアドレスを開きます。

意味 内蔵データベースが起動しませんでした。メッセージにそのログのパスが表示されます。

対処 openconstructionerp doctor を実行します。解決しない場合は、pip install --upgrade --force-reinstall openconstructionerp で再インストールし、示されたログを送ってください。

意味 2 つのシークレットが入った .env ファイルがないか、同じフォルダーにありません。

対処 手順 2 のとおり、docker-compose.yml があるフォルダーに .env ファイルを作成します。

意味 コンテナーがまだ動いていないか、ポート 8080 が使用中です。

対処 docker compose ps と docker compose logs app を実行します。別のポートを使うには：OE_PORT=8081 OE_ALLOWED_ORIGINS=http://localhost:8081 docker compose up -d を実行し、http://localhost:8081 を開きます。

意味 公開イメージは x86-64 のみ向けにビルドされています。

対処 make quickstart でソースからビルドするか、pip を使います。