OpenConstructionERP 설치

의미 설치 프로그램에 아직 코드 서명이 없어서 Windows가 게시자를 알지 못합니다. 경고일 뿐 바이러스가 발견된 것이 아닙니다.

조치 "추가 정보"를 클릭하고, 파일 이름이 OpenConstructionERP로 시작하는지 확인한 다음 "실행"을 클릭하세요.

의미 Windows 11의 스마트 앱 컨트롤은 서명되지 않은 프로그램을 거부합니다.

조치 스마트 앱 컨트롤은 앱 하나만 허용할 수 없습니다. 켜 둔 채로 쓰려면 스마트 앱 컨트롤이 검사하지 않는 Docker Desktop이나 WSL(Windows에 내장된 Linux)로 OpenConstructionERP를 실행하세요. 단계별 안내는 저장소의 docs/desktop/WINDOWS_BLOCKED.md에 있습니다.

의미 고른 폴더의 경로에 키릴 문자, 한자, 악센트 문자 등 라틴 문자가 아닌 글자가 들어 있습니다.

조치 제안된 C:\Program Files\OpenConstructionERP를 그대로 두거나 C:\OpenConstructionERP 같은 폴더를 고르세요. 무인 설치(/S)는 코드 3으로 종료되고 이유를 %TEMP%\OpenConstructionERP-install-error.log에 기록합니다.

의미 Windows가 앱 창을 그리는 구성 요소인 Microsoft WebView2의 설치를 거부했습니다. 설치 프로그램에 들어 있으므로 인터넷은 필요 없고, 원인은 Windows 자체에 있습니다(정책, 대기 중인 업데이트, 이전에 손상된 WebView2 등).

조치 컴퓨터를 다시 시작하고 설치 프로그램을 다시 실행하세요. 또 실패하면 Microsoft에서 "Microsoft Edge WebView2 Runtime"을 설치한 다음 저희 설치 프로그램을 한 번 더 실행하세요.

의미 프로그램이 새것이고 서명이 없어서 일부 바이러스 백신이 의심합니다.

조치 격리된 파일을 복원하고 다음 두 폴더를 예외로 추가하세요. 프로그램 폴더 C:\Program Files\OpenConstructionERP와 데이터 폴더 C:\Users\<your name>\.openestimate입니다. 그다음 기존 설치 위에 설치 프로그램을 다시 실행하세요. 파일이 정품인지 확신이 서지 않으면 먼저 저희에게 문의하세요.

조치 이미 선택된 항목(덮어쓰기)을 그대로 두세요. 프로젝트는 유지됩니다. 업그레이드 후 처음 시작할 때는 데이터베이스가 스스로 업데이트되느라 더 오래 걸릴 수 있습니다.

의미 둘 다 같은 .openestimate 폴더와 데이터베이스를 씁니다. 설치 프로그램은 프로그램을 교체하려고 그 데이터베이스를 중지합니다. 18.4.0에서 업그레이드할 때는 이전 제거 프로그램이 이름이 openconstructionerp.exe인 프로그램도 모두 닫습니다.

조치 설치나 업그레이드 전에 터미널 버전을 중지(Ctrl+C)하고, 끝난 뒤에 다시 시작하세요.

의미 앱이 로컬 데이터베이스를 만들고 있습니다. 한 번만 일어나는 일입니다.

조치 기다리시고 창을 닫지 마세요. 디스크가 느리거나 거의 찼다면 더 오래 걸릴 수 있습니다. 다음부터는 빠르게 시작됩니다.

의미 앱이 창을 전혀 열지 못했습니다.

조치 한 번 더 실행하세요. 상자가 다시 나오면 거기에 적힌 로그 파일을 보내 주세요.

의미 로컬 데이터베이스가 올라오지 않았습니다. 정상적으로 닫히지 않은 실행 뒤에 자주 생깁니다.

조치 컴퓨터를 다시 시작하고 앱을 다시 실행하세요. 반복되면 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분 동안 최대 두 번만 이렇게 합니다.

조치 계속 사용하세요. 반복되거나 "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 포트가 아니라 로컬 소켓만 수신 대기합니다.

조치 할 일이 없습니다.

의미 앱이 로컬 데이터베이스를 만들고 있습니다. 한 번만 일어나는 일입니다.

조치 기다리시고 창을 닫지 마세요. 디스크가 느리거나 거의 찼다면 더 오래 걸릴 수 있습니다. 다음부터는 빠르게 시작됩니다.

의미 로컬 데이터베이스가 올라오지 않았습니다. 정상적으로 닫히지 않은 실행 뒤에 자주 생깁니다.

조치 컴퓨터를 다시 시작하고 앱을 다시 실행하세요. 반복되면 desktop-launcher.log와 데이터베이스 로그(로그 참고)를 보내 주세요.

의미 프로그램 폴더의 일부가 없습니다. 보통 바이러스 백신이 지운 것입니다.

조치 바이러스 백신의 격리 항목을 확인한 다음, 기존 설치 위에 설치 프로그램을 다시 실행하세요. 프로젝트는 건드리지 않습니다.

의미 시작하는 데 앱이 기다리는 시간보다 오래 걸렸습니다. 메시지에 어느 단계였는지 나옵니다.

조치 창을 닫고 다시 시작하세요. 디스크가 거의 찼다면 먼저 공간을 확보하세요. 같은 단계에서 또 멈추면 desktop-launcher.log를 보내 주세요.

의미 macOS와 Linux에서는 앱이 시작할 때마다 백엔드의 압축을 풉니다. 느리거나 가득 찬 드라이브, 또는 파일을 잠그는 바이러스 백신이 이를 막습니다. (Windows 앱은 18.5부터 스스로 압축을 풀지 않습니다.)

조치 임시 폴더가 있는 드라이브의 공간을 확보하거나 바이러스 백신에서 앱을 허용한 다음 다시 시작하세요.

의미 말 그대로입니다. 메시지에 폴더와 남은 여유 공간이 나옵니다.

조치 해당 드라이브의 공간을 확보하고 다시 시작하세요.

의미 앱의 백그라운드 부분이 예기치 않게 멈췄고 앱이 다시 시작했습니다. 저장한 작업은 유지됩니다. 30분 동안 최대 두 번만 이렇게 합니다.

조치 계속 사용하세요. 반복되거나 "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를 한 번 실행한 다음 앱을 평소처럼 여세요.

의미 앱은 임시(ad hoc) 서명되어 있지만 아직 Apple의 공증을 받지 않았습니다.

조치 같은 xattr 명령을 실행하거나, 시스템 설정의 개인정보 보호 및 보안을 열어 아래로 스크롤한 다음 "그래도 열기"를 클릭하세요. 한 번만 하면 됩니다.

의미 Mac 빌드는 Apple Silicon(M1 이상)용뿐입니다. Intel 빌드는 없습니다.

조치 Intel Mac에서는 pip(Python 3.12 이상)나 Docker를 쓰세요.

의미 앱이 로컬 데이터베이스를 만들고 있습니다. 한 번만 일어나는 일입니다.

조치 기다리시고 창을 닫지 마세요. 디스크가 느리거나 거의 찼다면 더 오래 걸릴 수 있습니다. 다음부터는 빠르게 시작됩니다.

의미 로컬 데이터베이스가 올라오지 않았습니다. 정상적으로 닫히지 않은 실행 뒤에 자주 생깁니다.

조치 컴퓨터를 다시 시작하고 앱을 다시 실행하세요. 반복되면 desktop-launcher.log와 데이터베이스 로그(로그 참고)를 보내 주세요.

의미 프로그램 폴더의 일부가 없습니다. 보통 바이러스 백신이 지운 것입니다.

조치 바이러스 백신의 격리 항목을 확인한 다음, 기존 설치 위에 설치 프로그램을 다시 실행하세요. 프로젝트는 건드리지 않습니다.

의미 시작하는 데 앱이 기다리는 시간보다 오래 걸렸습니다. 메시지에 어느 단계였는지 나옵니다.

조치 창을 닫고 다시 시작하세요. 디스크가 거의 찼다면 먼저 공간을 확보하세요. 같은 단계에서 또 멈추면 desktop-launcher.log를 보내 주세요.

의미 macOS와 Linux에서는 앱이 시작할 때마다 백엔드의 압축을 풉니다. 느리거나 가득 찬 드라이브, 또는 파일을 잠그는 바이러스 백신이 이를 막습니다. (Windows 앱은 18.5부터 스스로 압축을 풀지 않습니다.)

조치 임시 폴더가 있는 드라이브의 공간을 확보하거나 바이러스 백신에서 앱을 허용한 다음 다시 시작하세요.

의미 말 그대로입니다. 메시지에 폴더와 남은 여유 공간이 나옵니다.

조치 해당 드라이브의 공간을 확보하고 다시 시작하세요.

의미 앱의 백그라운드 부분이 예기치 않게 멈췄고 앱이 다시 시작했습니다. 저장한 작업은 유지됩니다. 30분 동안 최대 두 번만 이렇게 합니다.

조치 계속 사용하세요. 반복되거나 "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로 다시 설치하고 안내된 로그를 보내 주세요.

의미 시크릿 두 개가 들어 있는 .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를 쓰세요.