Menginstal OpenConstructionERP

Artinya Installer belum ditandatangani kode, jadi Windows tidak mengenal penerbitnya. Ini peringatan, bukan deteksi virus.

Yang perlu dilakukan Klik "More info", pastikan nama file diawali OpenConstructionERP, lalu klik "Run anyway".

Artinya Smart App Control di Windows 11 menolak program yang tidak bertanda tangan.

Yang perlu dilakukan Smart App Control tidak bisa mengizinkan satu aplikasi saja. Agar tetap aktif, jalankan OpenConstructionERP dengan Docker Desktop atau di WSL (Linux bawaan Windows), yang tidak diperiksa Smart App Control. Petunjuk langkah demi langkah: docs/desktop/WINDOWS_BLOCKED.md di repositori.

Artinya Folder yang Anda pilih memiliki huruf Sirilik, Tionghoa, huruf beraksen, atau karakter non-Latin lain di path-nya.

Yang perlu dilakukan Biarkan C:\Program Files\OpenConstructionERP yang disarankan atau pilih folder seperti C:\OpenConstructionERP. Instalasi senyap (/S) berakhir dengan kode 3 dan menulis alasannya ke %TEMP%\OpenConstructionERP-install-error.log.

Artinya Windows menolak memasang Microsoft WebView2, komponen yang menggambar jendela aplikasi. Komponen ini sudah ada di dalam installer sehingga tidak perlu internet; galatnya datang dari Windows sendiri (kebijakan, pembaruan tertunda, atau WebView2 lama yang rusak).

Yang perlu dilakukan Mulai ulang komputer dan jalankan installer lagi. Jika gagal lagi, pasang "Microsoft Edge WebView2 Runtime" dari Microsoft lalu jalankan installer kami sekali lagi.

Artinya Programnya baru dan belum bertanda tangan, dan beberapa antivirus mencurigainya.

Yang perlu dilakukan Pulihkan file dari karantina dan tambahkan dua folder ini ke pengecualian: folder program C:\Program Files\OpenConstructionERP dan folder data Anda C:\Users\<your name>\.openestimate. Lalu jalankan installer lagi di atas instalasi yang ada. Jika Anda tidak yakin file itu asli, tulis ke kami dulu.

Yang perlu dilakukan Biarkan pilihan yang sudah terpilih (timpa). Proyek Anda tetap aman. Peluncuran pertama setelah peningkatan versi bisa lebih lama karena database memperbarui dirinya sendiri.

Artinya Keduanya memakai folder .openestimate dan database yang sama. Installer menghentikan database itu untuk mengganti program. Saat meningkatkan dari 18.4.0, uninstaller lama juga menutup program apa pun bernama openconstructionerp.exe.

Yang perlu dilakukan Hentikan versi terminal (Ctrl+C) sebelum memasang atau meningkatkan versi, dan jalankan lagi sesudahnya.

Artinya Aplikasi membuat database lokalnya. Ini hanya terjadi sekali.

Yang perlu dilakukan Tunggu dan jangan tutup jendelanya. Pada disk yang lambat atau hampir penuh, prosesnya bisa lebih lama. Peluncuran berikutnya cepat.

Artinya Aplikasi sama sekali tidak bisa membuka jendelanya.

Yang perlu dilakukan Jalankan sekali lagi. Jika kotak itu muncul lagi, kirimkan file log yang disebutkan kepada kami.

Artinya Database lokal tidak mulai, sering setelah sesi yang tidak ditutup dengan bersih.

Yang perlu dilakukan Mulai ulang komputer dan jalankan aplikasi lagi. Jika berulang, kirimkan desktop-launcher.log dan log database kepada kami (lihat Log).

Artinya Sebagian folder program hilang, biasanya karena dihapus antivirus.

Yang perlu dilakukan Periksa karantina antivirus, lalu jalankan installer lagi di atas instalasi yang ada. Proyek Anda tidak disentuh.

Artinya Proses mulai memakan waktu lebih lama dari yang ditunggu aplikasi. Pesan menyebut langkah tempat ia berada.

Yang perlu dilakukan Tutup jendela dan jalankan lagi. Kosongkan ruang disk dulu jika disk hampir penuh. Jika berhenti lagi di langkah yang sama, kirimkan desktop-launcher.log kepada kami.

Artinya Persis itu. Pesan menyebut folder dan sisa ruang kosong.

Yang perlu dilakukan Kosongkan ruang pada drive itu dan jalankan lagi.

Artinya Windows membatasi panjang path, dan path folder data Anda terlalu panjang untuk file database. Mengaktifkan path panjang di Windows tidak membantu.

Yang perlu dilakukan Setel variabel lingkungan pengguna OE_DATA_DIR ke path pendek seperti C:\OpenConstructionERP\data (Start, ketik "environment variables", Edit environment variables for your account, New) lalu jalankan lagi.

Artinya Database bawaan tidak bisa berjalan dari path seperti itu, jadi sejak 18.5.0 aplikasi menyimpannya di C:\ProgramData\OpenConstructionERP\clusters\<id>\pgdata. Sebelum 18.5.0 aplikasi sama sekali tidak bisa mulai untuk akun seperti itu.

Yang perlu dilakukan Tidak ada yang perlu diperbaiki. File pgdata.location di folder .openestimate Anda menyebut folder database yang tepat. Untuk cadangan, salin kedua folder.

Artinya Bagian aplikasi yang berjalan di latar belakang berhenti tiba-tiba dan aplikasi menjalankannya lagi. Pekerjaan yang sudah disimpan tetap aman. Ini dilakukan paling banyak dua kali dalam 30 menit.

Yang perlu dilakukan Lanjutkan. Jika berulang atau Anda melihat "The application backend has stopped", kirimkan desktop-launcher.log dan logs/backend-crash.log kepada kami.

Artinya Program lain memakai port 8732, yang biasanya dipakai aplikasi. Saat itu versi 18.5.0 memilih port bebas acak di setiap peluncuran, dan jendela menganggap setiap port baru sebagai situs baru, sehingga login dan bahasa tidak ditemukan.

Yang perlu dilakukan Tutup atau konfigurasi ulang program lain yang memakai port 8732 (di Windows jalankan netstat -ano | findstr :8732 di terminal untuk melihat process ID-nya). Proyek Anda tidak terpengaruh, hanya login dan pilihan bahasa.

Artinya Tidak berbenturan. Database bawaan di Windows mengambil port lokal bebas acak, dan di macOS serta Linux hanya mendengarkan pada socket lokal, bukan port TCP.

Yang perlu dilakukan Tidak ada yang perlu dilakukan.

Artinya Aplikasi membuat database lokalnya. Ini hanya terjadi sekali.

Yang perlu dilakukan Tunggu dan jangan tutup jendelanya. Pada disk yang lambat atau hampir penuh, prosesnya bisa lebih lama. Peluncuran berikutnya cepat.

Artinya Database lokal tidak mulai, sering setelah sesi yang tidak ditutup dengan bersih.

Yang perlu dilakukan Mulai ulang komputer dan jalankan aplikasi lagi. Jika berulang, kirimkan desktop-launcher.log dan log database kepada kami (lihat Log).

Artinya Sebagian folder program hilang, biasanya karena dihapus antivirus.

Yang perlu dilakukan Periksa karantina antivirus, lalu jalankan installer lagi di atas instalasi yang ada. Proyek Anda tidak disentuh.

Artinya Proses mulai memakan waktu lebih lama dari yang ditunggu aplikasi. Pesan menyebut langkah tempat ia berada.

Yang perlu dilakukan Tutup jendela dan jalankan lagi. Kosongkan ruang disk dulu jika disk hampir penuh. Jika berhenti lagi di langkah yang sama, kirimkan desktop-launcher.log kepada kami.

Artinya Di macOS dan Linux aplikasi mengekstrak backend-nya di setiap peluncuran. Disk yang lambat atau penuh, atau antivirus yang mengunci file, menghalanginya. (Aplikasi Windows tidak lagi mengekstrak dirinya sejak 18.5.)

Yang perlu dilakukan Kosongkan ruang pada drive yang berisi folder sementara Anda atau izinkan aplikasi di antivirus, lalu jalankan lagi.

Artinya Persis itu. Pesan menyebut folder dan sisa ruang kosong.

Yang perlu dilakukan Kosongkan ruang pada drive itu dan jalankan lagi.

Artinya Bagian aplikasi yang berjalan di latar belakang berhenti tiba-tiba dan aplikasi menjalankannya lagi. Pekerjaan yang sudah disimpan tetap aman. Ini dilakukan paling banyak dua kali dalam 30 menit.

Yang perlu dilakukan Lanjutkan. Jika berulang atau Anda melihat "The application backend has stopped", kirimkan desktop-launcher.log dan logs/backend-crash.log kepada kami.

Artinya Program lain memakai port 8732, yang biasanya dipakai aplikasi. Saat itu versi 18.5.0 memilih port bebas acak di setiap peluncuran, dan jendela menganggap setiap port baru sebagai situs baru, sehingga login dan bahasa tidak ditemukan.

Yang perlu dilakukan Tutup atau konfigurasi ulang program lain yang memakai port 8732 (di Windows jalankan netstat -ano | findstr :8732 di terminal untuk melihat process ID-nya). Proyek Anda tidak terpengaruh, hanya login dan pilihan bahasa.

Artinya Tidak berbenturan. Database bawaan di Windows mengambil port lokal bebas acak, dan di macOS serta Linux hanya mendengarkan pada socket lokal, bukan port TCP.

Yang perlu dilakukan Tidak ada yang perlu dilakukan.

Artinya Aplikasi belum dinotarisasi (notarized) oleh Apple dan masih membawa tanda unduhan. Aplikasinya tidak rusak.

Yang perlu dilakukan Hanya ini yang membantu: di Terminal jalankan sekali xattr -dr com.apple.quarantine /Applications/OpenConstructionERP.app lalu buka aplikasi seperti biasa.

Artinya Aplikasi ditandatangani ad hoc tetapi belum dinotarisasi (notarized) oleh Apple.

Yang perlu dilakukan Jalankan perintah xattr yang sama atau buka System Settings, Privacy & Security, gulir ke bawah dan klik Open Anyway. Anda hanya melakukannya sekali.

Artinya Rilis Mac hanya untuk Apple Silicon (M1 dan yang lebih baru). Tidak ada rilis untuk Intel.

Yang perlu dilakukan Di Mac Intel gunakan pip (Python 3.12 atau lebih baru) atau Docker.

Artinya Aplikasi membuat database lokalnya. Ini hanya terjadi sekali.

Yang perlu dilakukan Tunggu dan jangan tutup jendelanya. Pada disk yang lambat atau hampir penuh, prosesnya bisa lebih lama. Peluncuran berikutnya cepat.

Artinya Database lokal tidak mulai, sering setelah sesi yang tidak ditutup dengan bersih.

Yang perlu dilakukan Mulai ulang komputer dan jalankan aplikasi lagi. Jika berulang, kirimkan desktop-launcher.log dan log database kepada kami (lihat Log).

Artinya Sebagian folder program hilang, biasanya karena dihapus antivirus.

Yang perlu dilakukan Periksa karantina antivirus, lalu jalankan installer lagi di atas instalasi yang ada. Proyek Anda tidak disentuh.

Artinya Proses mulai memakan waktu lebih lama dari yang ditunggu aplikasi. Pesan menyebut langkah tempat ia berada.

Yang perlu dilakukan Tutup jendela dan jalankan lagi. Kosongkan ruang disk dulu jika disk hampir penuh. Jika berhenti lagi di langkah yang sama, kirimkan desktop-launcher.log kepada kami.

Artinya Di macOS dan Linux aplikasi mengekstrak backend-nya di setiap peluncuran. Disk yang lambat atau penuh, atau antivirus yang mengunci file, menghalanginya. (Aplikasi Windows tidak lagi mengekstrak dirinya sejak 18.5.)

Yang perlu dilakukan Kosongkan ruang pada drive yang berisi folder sementara Anda atau izinkan aplikasi di antivirus, lalu jalankan lagi.

Artinya Persis itu. Pesan menyebut folder dan sisa ruang kosong.

Yang perlu dilakukan Kosongkan ruang pada drive itu dan jalankan lagi.

Artinya Bagian aplikasi yang berjalan di latar belakang berhenti tiba-tiba dan aplikasi menjalankannya lagi. Pekerjaan yang sudah disimpan tetap aman. Ini dilakukan paling banyak dua kali dalam 30 menit.

Yang perlu dilakukan Lanjutkan. Jika berulang atau Anda melihat "The application backend has stopped", kirimkan desktop-launcher.log dan logs/backend-crash.log kepada kami.

Artinya Program lain memakai port 8732, yang biasanya dipakai aplikasi. Saat itu versi 18.5.0 memilih port bebas acak di setiap peluncuran, dan jendela menganggap setiap port baru sebagai situs baru, sehingga login dan bahasa tidak ditemukan.

Yang perlu dilakukan Tutup atau konfigurasi ulang program lain yang memakai port 8732 (di Windows jalankan netstat -ano | findstr :8732 di terminal untuk melihat process ID-nya). Proyek Anda tidak terpengaruh, hanya login dan pilihan bahasa.

Artinya Tidak berbenturan. Database bawaan di Windows mengambil port lokal bebas acak, dan di macOS serta Linux hanya mendengarkan pada socket lokal, bukan port TCP.

Yang perlu dilakukan Tidak ada yang perlu dilakukan.

Artinya Aplikasi membutuhkan WebKitGTK 4.1 untuk menggambar jendelanya. dpkg -i tidak memasang dependensi.

Yang perlu dilakukan Pasang dengan sudo apt install ./OpenConstructionERP_18.5.0_amd64.deb, yang juga membawa pustakanya. Jika distribusi Anda tidak punya libwebkit2gtk-4.1-0 (Ubuntu lebih lama dari 22.04, Debian lebih lama dari 12), gunakan pip.

Artinya File belum ditandai sebagai program.

Yang perlu dilakukan Jalankan chmod +x OpenConstructionERP_18.5.0_amd64.AppImage dan jalankan lagi.

Artinya Distribusi yang lebih baru tidak lagi memasang pustaka FUSE 2 yang dipakai AppImage.

Yang perlu dilakukan Pasang pustaka itu (sudo apt install libfuse2, di Ubuntu 24.04 sudo apt install libfuse2t64) atau gunakan .deb, .rpm, atau pip.

Artinya OpenConstructionERP membutuhkan Python 3.12 atau lebih baru.

Yang perlu dilakukan Pasang Python 3.12 atau lebih baru dan jalankan python3.12 -m pip install --upgrade openconstructionerp (di Windows: py -3.12 -m pip install --upgrade openconstructionerp).

Artinya Python sistem tidak mengizinkan pip memasang ke dalamnya.

Yang perlu dilakukan Gunakan pipx install openconstructionerp atau buat lingkungan virtual dulu: python3 -m venv ~/oe && ~/oe/bin/pip install openconstructionerp.

Artinya Folder tempat pip menaruh perintah tidak ada di PATH Anda (sering terjadi di Windows).

Yang perlu dilakukan Jalankan python -m openconstructionerp sebagai gantinya. Ini berfungsi di sistem apa pun tanpa menyentuh PATH.

Artinya Program lain memakai port 8080.

Yang perlu dilakukan Jalankan perintah yang disarankan dan buka alamat yang dicetaknya.

Artinya Database bawaan tidak mulai. Pesan mencetak path lognya.

Yang perlu dilakukan Jalankan openconstructionerp doctor. Jika tidak membantu, pasang ulang dengan pip install --upgrade --force-reinstall openconstructionerp dan kirimkan log yang disebutkan kepada kami.

Artinya File .env dengan dua rahasia itu tidak ada atau tidak berada di folder yang sama.

Yang perlu dilakukan Buat file .env seperti langkah 2, di folder yang berisi docker-compose.yml.

Artinya Container belum berjalan atau port 8080 sedang dipakai.

Yang perlu dilakukan Jalankan docker compose ps dan docker compose logs app. Untuk port lain: OE_PORT=8081 OE_ALLOWED_ORIGINS=http://localhost:8081 docker compose up -d lalu buka http://localhost:8081.

Artinya Image yang dipublikasikan hanya dibangun untuk x86-64.

Yang perlu dilakukan Bangun dari sumber dengan make quickstart atau gunakan pip.