راهنمای نصب
نصب OpenConstructionERP
روش اجرا را انتخاب کنید، مراحل شماره‌دار را دنبال کنید و اگر چیزی درست به نظر نمی‌رسد، پیامی را که می‌بینید در فهرست مشکلات زیر پیدا کنید. هیچ‌یک از هشدارهای زمان نصب پروژه‌های شما را به خطر نمی‌اندازد.
مطمئن نیستید چه چیزی لازم دارید؟
- از Windows 10 یا 11 استفاده می‌کنیدنصب‌کننده Windows (.exe)
- یک Mac با تراشه M1 یا M2 یا M3 یا M4 داریدmacOS (.dmg، Apple Silicon)
- یک Mac با پردازنده Intel داریدpip یا Docker (برای Mac با Intel برنامه‌ای وجود ندارد)
- از Ubuntu یا Debian یا Linux Mint استفاده می‌کنیدLinux فایل .deb
- از Fedora یا RHEL یا Rocky Linux استفاده می‌کنیدLinux فایل .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 در پوشه Downloads.
- 2
روی آن دوبار کلیک کنید. اگر پنجره‌ای آبی نوشت "Windows protected your PC"، روی "More info" کلیک کنید، مطمئن شوید نام فایل با OpenConstructionERP شروع می‌شود و بعد روی "Run anyway" کلیک کنید.
آنچه می‌بینیدWindows دسترسی مدیر می‌خواهد. روی Yes کلیک کنید.
- 3
زبان نصب‌کننده را انتخاب کنید، مجوز را بپذیرید و پوشه پیشنهادی
C:\Program Files\OpenConstructionERPرا نگه دارید.آنچه می‌بینیدنوار پیشرفت و بعد صفحه پایان.
- 4
روی Finish کلیک کنید یا OpenConstructionERP را از منوی Start اجرا کنید.
آنچه می‌بینیدصفحه بارگذاری "در حال راه‌اندازی برنامه" با فهرستی از مراحل: راه‌اندازی backend، راه‌اندازی پایگاه داده محلی، آماده‌سازی پایگاه داده، راه‌اندازی سرور برنامه، باز کردن برنامه.
- 5
در اولین اجرا صبر کنید. پنجره را نبندید.
آنچه می‌بینید"اولین اجرا پایگاه داده محلی شما را راه‌اندازی می‌کند. ممکن است یک یا دو دقیقه طول بکشد، لطفاً صبر کنید." اجراهای بعدی بسیار سریع‌ترند.
- 6
انتخاب کنید چگونه باز شود: به‌صورت پنجره برنامه (پیشنهادی) یا در مرورگر معمولی خودتان.
آنچه می‌بینید"می‌خواهید OpenConstructionERP را چگونه باز کنید؟" و بعد صفحه ورود.
- 7
با حساب آزمایشی وارد شوید: ایمیل demo@openconstructionerp.com و گذرواژه DemoPass1234!. بعد از آن می‌توانید حساب و پروژه‌های خودتان را بسازید.
آنچه می‌بینیدبرنامه. پروژه‌های آزمایشی در اولین اجرا در پس‌زمینه ساخته می‌شوند، برای همین فهرست پروژه‌ها ممکن است مدتی کوتاه بگوید که در راه‌اند.
- 8
در نصب تازه، یک بار از مدیر پرسیده می‌شود از کدام ماژول‌ها استفاده می‌کنید. آنچه لازم دارید را علامت بزنید و ادامه دهید. بعداً می‌توانید با دکمه Background services در نوار بالا آن را تغییر دهید.
آنچه می‌بینیدفهرست یک‌باره‌ای از ماژول‌ها با حافظه‌ای که لازم دارند.
اگر پیامی دیدید
نصبپنجره آبی "Windows protected your PC".
یعنی چه نصب‌کننده هنوز امضای دیجیتال ندارد و برای همین Windows ناشر را نمی‌شناسد. این یک هشدار است، نه شناسایی ویروس.
چه کنید روی "More info" کلیک کنید، مطمئن شوید نام فایل با OpenConstructionERP شروع می‌شود و بعد روی "Run anyway" کلیک کنید.
نصبSmart App Control برنامه را مسدود کرد و دکمه‌ای برای ادامه نیست.
یعنی چه Smart App Control در Windows 11 برنامه‌های بدون امضا را رد می‌کند.
چه کنید Smart App Control نمی‌تواند فقط یک برنامه را مجاز کند. برای اینکه روشن بماند، OpenConstructionERP را با Docker Desktop یا داخل WSL (همان Linux داخلی Windows) اجرا کنید، چون Smart App Control آن‌ها را بررسی نمی‌کند. راهنمای گام‌به‌گام: 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 Edge WebView2 Runtime" را از Microsoft نصب کنید و بعد نصب‌کننده ما را یک بار دیگر اجرا کنید.
نصبآنتی‌ویروس هنگام نصب یا در اولین اجرا فایلی را حذف یا قرنطینه می‌کند.
یعنی چه برنامه تازه و بدون امضاست و بعضی آنتی‌ویروس‌ها به آن مشکوک می‌شوند.
چه کنید فایل را از قرنطینه برگردانید و این دو پوشه را به استثناها اضافه کنید: پوشه برنامه C:\Program Files\OpenConstructionERP و پوشه داده‌های خودتان C:\Users\<your name>\.openestimate. بعد نصب‌کننده را دوباره روی نصب موجود اجرا کنید. اگر مطمئن نیستید فایل اصلی است، اول به ما بنویسید.
ارتقاصفحه‌ای که می‌پرسد نسخه نصب‌شده بازنویسی شود یا اول حذف شود، با خطی که حذف را پیشنهاد می‌کند.
چه کنید گزینه‌ای را که از قبل انتخاب شده نگه دارید (بازنویسی). پروژه‌های شما حفظ می‌شوند. اولین اجرا بعد از ارتقا ممکن است بیشتر طول بکشد، چون پایگاه داده خودش را به‌روز می‌کند.
ارتقاOpenConstructionERP را هم با pip یا از ترمینال روی همین رایانه اجرا می‌کنید و هنگام ارتقا متوقف می‌شود.
یعنی چه هر دو از همان پوشه .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 بگذارید (Start، عبارت "environment variables" را تایپ کنید، Edit environment variables for your account، New) و بعد دوباره اجرا کنید.
راه‌اندازینام کاربری Windows شما نویسه‌های غیرلاتین دارد (مثلاً سیریلیک یا چینی) و دنبال پایگاه داده خودتان می‌گردید.
یعنی چه پایگاه داده داخلی نمی‌تواند از چنین مسیری کار کند، برای همین از 18.5.0 برنامه آن را در C:\ProgramData\OpenConstructionERP\clusters\<id>\pgdata نگه می‌دارد. پیش از 18.5.0 برنامه برای چنین حساب‌هایی اصلاً بالا نمی‌آمد.
چه کنید چیزی برای رفع نیست. فایل pgdata.location در پوشه .openestimate شما پوشه دقیق پایگاه داده را می‌گوید. برای نسخه پشتیبان هر دو پوشه را کپی کنید.
در حال کار"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 را اجرا کنید تا شناسه فرایند آن را ببینید). پروژه‌های شما آسیبی نمی‌بینند، فقط ورود و انتخاب زبان.
راه‌اندازینگرانید برنامه با PostgreSQL ای که از قبل روی پورت 5432 اجرا می‌کنید تداخل داشته باشد.
یعنی چه تداخل ندارد. پایگاه داده داخلی در 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%را در نوار آدرس File Explorer تایپ کنید)چرا نصب‌کننده Windows پوشه نصب را رد کرد.
برای باز کردن پوشه، این را در نوار آدرس Explorer بچسبانید:
%USERPROFILE%\.openestimatemacOS
- 1
فایل
OpenConstructionERP_18.5.0_aarch64.dmgرا دانلود و باز کنید.آنچه می‌بینیدپنجره‌ای با نماد برنامه OpenConstructionERP.
- 2
OpenConstructionERP را به Applications بکشید.
آنچه می‌بینیدبرنامه در پوشه Applications ظاهر می‌شود.
- 3
یک بار Terminal را باز کنید و اجرا کنید.
xattr -dr com.apple.quarantine /Applications/OpenConstructionERP.appآنچه می‌بینیدخروجی‌ای نمی‌آید. درست است. این دستور نشانه دانلود را برمی‌دارد، چون Apple هنوز برنامه را notarize نکرده است.
- 4
OpenConstructionERP را از Applications باز کنید.
آنچه می‌بینیدصفحه بارگذاری "در حال راه‌اندازی برنامه". اولین اجرا پایگاه داده محلی را راه‌اندازی می‌کند و یک یا دو دقیقه طول می‌کشد.
- 5
پنجره برنامه یا مرورگر را انتخاب کنید.
آنچه می‌بینیدصفحه ورود.
- 6
با حساب آزمایشی وارد شوید: ایمیل demo@openconstructionerp.com و گذرواژه DemoPass1234!. بعد از آن می‌توانید حساب و پروژه‌های خودتان را بسازید.
آنچه می‌بینیدبرنامه. پروژه‌های آزمایشی در اولین اجرا در پس‌زمینه ساخته می‌شوند، برای همین فهرست پروژه‌ها ممکن است مدتی کوتاه بگوید که در راه‌اند.
- 7
در نصب تازه، یک بار از مدیر پرسیده می‌شود از کدام ماژول‌ها استفاده می‌کنید. آنچه لازم دارید را علامت بزنید و ادامه دهید. بعداً می‌توانید با دکمه Background services در نوار بالا آن را تغییر دهید.
آنچه می‌بینیدفهرست یک‌باره‌ای از ماژول‌ها با حافظه‌ای که لازم دارند.
اگر پیامی دیدید
راه‌اندازیصفحه بارگذاری در اولین اجرا یک دقیقه یا بیشتر می‌ماند.
یعنی چه برنامه پایگاه داده محلی خودش را می‌سازد. این کار فقط یک بار انجام می‌شود.
چه کنید صبر کنید و پنجره را نبندید. روی دیسک کند یا تقریباً پر ممکن است بیشتر طول بکشد. اجراهای بعدی سریع‌اند.
راه‌اندازی"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 برنامه در هر اجرا backend خودش را باز می‌کند. دیسک کند یا پر، یا آنتی‌ویروسی که فایل‌ها را قفل می‌کند، جلوی آن را می‌گیرد. (برنامه 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 را اجرا کنید تا شناسه فرایند آن را ببینید). پروژه‌های شما آسیبی نمی‌بینند، فقط ورود و انتخاب زبان.
راه‌اندازینگرانید برنامه با PostgreSQL ای که از قبل روی پورت 5432 اجرا می‌کنید تداخل داشته باشد.
یعنی چه تداخل ندارد. پایگاه داده داخلی در Windows یک پورت محلی آزاد تصادفی می‌گیرد و در macOS و Linux فقط روی یک سوکت محلی گوش می‌دهد، نه روی پورت TCP.
چه کنید لازم نیست کاری بکنید.
نصب"OpenConstructionERP is damaged and can't be opened" (متن ممکن است به زبان سیستم شما باشد).
یعنی چه Apple هنوز برنامه را notarize نکرده و نشانه دانلود هنوز روی آن است. برنامه خراب نیست.
چه کنید فقط این کمک می‌کند: در Terminal یک بار xattr -dr com.apple.quarantine /Applications/OpenConstructionERP.app را اجرا کنید و بعد برنامه را عادی باز کنید.
نصب"OpenConstructionERP cannot be opened because the developer cannot be verified" (یا Apple نتوانست تأیید کند که بدافزار ندارد؛ متن ممکن است به زبان سیستم شما باشد).
یعنی چه برنامه به‌صورت ad hoc امضا شده اما Apple هنوز آن را notarize نکرده است.
چه کنید همان دستور xattr را اجرا کنید یا System Settings، بعد Privacy & Security را باز کنید، به پایین بروید و روی Open Anyway کلیک کنید. این کار را فقط یک بار می‌کنید.
نصببرنامه اصلاً روی Mac شما اجرا نمی‌شود.
یعنی چه نسخه Mac فقط برای Apple Silicon است (M1 و جدیدتر). نسخه Intel وجود ندارد.
چه کنید روی Mac با Intel از 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
در نصب تازه، یک بار از مدیر پرسیده می‌شود از کدام ماژول‌ها استفاده می‌کنید. آنچه لازم دارید را علامت بزنید و ادامه دهید. بعداً می‌توانید با دکمه Background services در نوار بالا آن را تغییر دهید.
آنچه می‌بینیدفهرست یک‌باره‌ای از ماژول‌ها با حافظه‌ای که لازم دارند.
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
در نصب تازه، یک بار از مدیر پرسیده می‌شود از کدام ماژول‌ها استفاده می‌کنید. آنچه لازم دارید را علامت بزنید و ادامه دهید. بعداً می‌توانید با دکمه Background services در نوار بالا آن را تغییر دهید.
آنچه می‌بینیدفهرست یک‌باره‌ای از ماژول‌ها با حافظه‌ای که لازم دارند.
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
در نصب تازه، یک بار از مدیر پرسیده می‌شود از کدام ماژول‌ها استفاده می‌کنید. آنچه لازم دارید را علامت بزنید و ادامه دهید. بعداً می‌توانید با دکمه Background services در نوار بالا آن را تغییر دهید.
آنچه می‌بینیدفهرست یک‌باره‌ای از ماژول‌ها با حافظه‌ای که لازم دارند.
اگر پیامی دیدید
راه‌اندازیصفحه بارگذاری در اولین اجرا یک دقیقه یا بیشتر می‌ماند.
یعنی چه برنامه پایگاه داده محلی خودش را می‌سازد. این کار فقط یک بار انجام می‌شود.
چه کنید صبر کنید و پنجره را نبندید. روی دیسک کند یا تقریباً پر ممکن است بیشتر طول بکشد. اجراهای بعدی سریع‌اند.
راه‌اندازی"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 برنامه در هر اجرا backend خودش را باز می‌کند. دیسک کند یا پر، یا آنتی‌ویروسی که فایل‌ها را قفل می‌کند، جلوی آن را می‌گیرد. (برنامه 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 را اجرا کنید تا شناسه فرایند آن را ببینید). پروژه‌های شما آسیبی نمی‌بینند، فقط ورود و انتخاب زبان.
راه‌اندازینگرانید برنامه با PostgreSQL ای که از قبل روی پورت 5432 اجرا می‌کنید تداخل داشته باشد.
یعنی چه تداخل ندارد. پایگاه داده داخلی در 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 ندارد (Ubuntu قدیمی‌تر از 22.04، Debian قدیمی‌تر از 12)، از pip استفاده کنید.
نصبAppImage با دوبار کلیک کاری نمی‌کند.
یعنی چه فایل هنوز به‌عنوان برنامه علامت نخورده است.
چه کنید دستور chmod +x OpenConstructionERP_18.5.0_amd64.AppImage را اجرا کنید و دوباره اجرایش کنید.
نصبخطای AppImage که FUSE یا libfuse.so.2 را نام می‌برد.
یعنی چه توزیع‌های جدیدتر دیگر کتابخانه FUSE 2 را که AppImageها استفاده می‌کنند نصب نمی‌کنند.
چه کنید آن را نصب کنید (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
در نصب تازه، یک بار از مدیر پرسیده می‌شود از کدام ماژول‌ها استفاده می‌کنید. آنچه لازم دارید را علامت بزنید و ادامه دهید. بعداً می‌توانید با دکمه Background services در نوار بالا آن را تغییر دهید.
آنچه می‌بینیدفهرست یک‌باره‌ای از ماژول‌ها با حافظه‌ای که لازم دارند.
- 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
در نصب تازه، یک بار از مدیر پرسیده می‌شود از کدام ماژول‌ها استفاده می‌کنید. آنچه لازم دارید را علامت بزنید و ادامه دهید. بعداً می‌توانید با دکمه Background services در نوار بالا آن را تغییر دهید.
آنچه می‌بینیدفهرست یک‌باره‌ای از ماژول‌ها با حافظه‌ای که لازم دارند.
دستورهای مفید
بررسی کنید هر دو کانتینر در حال اجرا و سالم باشند
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 با آن دو راز نیست یا در همان پوشه نیست.
چه کنید فایل .env را مثل مرحله 2 در پوشه‌ای که 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 را باز کنید.
نصبروی Mac با Apple Silicon یا دستگاه 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(پنهان؛ در Finder کلیدهای Cmd+Shift+. را بزنید) - Linux~/
.openestimate - pip~/
.openestimate، همان پوشه برنامه دسکتاپ، مگر اینکه--data-dirبدهید یاOE_DATA_DIRرا تنظیم کنید - Dockerولومهای Docker با نام <folder>_pg_data (پایگاه داده) و <folder>_app_data (فایل‌ها)، که <folder> نام پوشه‌ای است که
docker-compose.ymlدر آن است
ارتقا
نسخه جدید را روی نسخه قدیمی نصب کنید. پوشه .openestimate شما بخشی از برنامه نیست، برای همین پروژه‌ها، کاربران و تنظیمات می‌مانند. اولین اجرا بعد از ارتقا ممکن است بیشتر طول بکشد، چون پایگاه داده خودش را به‌روز می‌کند.
حذف نصب
حذف نصب برنامه را برمی‌دارد و پروژه‌های شما را نگه می‌دارد. در Windows حذف‌کننده گزینه "Delete the application data" را (به زبان نصب‌کننده) پیشنهاد می‌کند: این فقط ورود و زبانی را که پنجره برنامه ذخیره کرده پاک می‌کند (در %APPDATA% و %LOCALAPPDATA%\io.openconstructionerp.desktop)، نه پروژه‌های شما را. برای شروع از صفر، حذف نصب کنید، .openestimate را در جای امنی کپی کنید و بعد پاکش کنید.
نسخه پشتیبان
برنامه را ببندید و پوشه .openestimate را کپی کنید (و پوشه ProgramData را که در pgdata.location آمده، اگر هست).
هنوز گیر کرده‌اید؟ کمک می‌کنیم
لطفاً این‌ها را بنویسید:
- نسخه (در نام فایل دانلودشده است؛ pip:
openconstructionerp --version؛ Docker: تگ ایمیج) و روش نصب (نصب‌کننده Windows، .dmg، .deb، .rpm، AppImage، pip یا Docker) - سیستم شما (Windows: Start،
winverرا تایپ کنید؛ macOS: منوی Apple، About This Mac؛ Linux: توزیع و نسخه) - متن دقیق پیام یا یک اسکرینشات
- فایل‌های لاگ که بالا آمدند
فایل‌های لاگ ممکن است نام کاربری و نام پوشه‌های شما را داشته باشند. پیش از انتشار مرورشان کنید؛ اگر ترجیح می‌دهید، بهتر است با ایمیل بفرستید.