انسٹالیشن میں مدد
OpenConstructionERP کی انسٹالیشن
منتخب کریں کہ آپ اسے کیسے چلانا چاہتے ہیں، نمبر والے مراحل پر عمل کریں، اور اگر کچھ ٹھیک نہ لگے تو نیچے مسائل کی فہرست میں وہ پیغام تلاش کریں جو آپ کو نظر آ رہا ہے۔ انسٹالیشن کے دوران آنے والی کوئی بھی وارننگ آپ کے پروجیکٹس کو خطرے میں نہیں ڈالتی۔
یقین نہیں کہ آپ کو کیا چاہیے؟
- آپ Windows 10 یا 11 استعمال کرتے ہیںWindows انسٹالر (.exe)
- آپ کے پاس M1، M2، M3 یا M4 چپ والا Mac ہےmacOS (.dmg، Apple Silicon)
- آپ کے پاس Intel والا Mac ہےpip یا Docker (Intel Mac کے لیے ایپ نہیں ہے)
- آپ 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ڈاؤن لوڈ کریں۔آپ کو نظر آئے گاDownloads فولڈر میں تقریباً 800 MB کی فائل۔
- 2
اس پر ڈبل کلک کریں۔ اگر نیلی ونڈو میں "Windows protected your PC" لکھا آئے تو "More info" پر کلک کریں، دیکھ لیں کہ فائل کا نام OpenConstructionERP سے شروع ہوتا ہے، پھر "Run anyway" پر کلک کریں۔
آپ کو نظر آئے گاWindows ایڈمنسٹریٹر کی اجازت مانگتا ہے۔ Yes پر کلک کریں۔
- 3
انسٹالر کی زبان منتخب کریں، لائسنس قبول کریں اور تجویز کردہ فولڈر
C:\Program Files\OpenConstructionERPرہنے دیں۔آپ کو نظر آئے گاپروگریس بار، پھر اختتامی صفحہ۔
- 4
Finish پر کلک کریں یا Start مینو سے OpenConstructionERP چلائیں۔
آپ کو نظر آئے گا"ایپ شروع ہو رہی ہے" والی لوڈنگ اسکرین اور ایک فہرست: 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 نے ایپ کو بلاک کر دیا، آگے بڑھنے کا بٹن نہیں ہے۔
اس کا مطلب Windows 11 کا Smart App Control بغیر دستخط والے پروگرام مسترد کر دیتا ہے۔
کیا کریں Smart App Control صرف ایک ایپ کو اجازت نہیں دے سکتا۔ اسے آن رکھنے کے لیے OpenConstructionERP کو Docker Desktop یا WSL (Windows میں شامل Linux) کے ساتھ چلائیں، جنہیں 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 سے "Microsoft Edge WebView2 Runtime" انسٹال کریں اور پھر ہمارا انسٹالر ایک بار اور چلائیں۔
انسٹالیشناینٹی وائرس انسٹالیشن کے دوران یا پہلی بار چلانے پر کوئی فائل حذف یا کوارنٹین کر دیتا ہے۔
اس کا مطلب پروگرام نیا ہے اور اس پر دستخط نہیں، اور کچھ اینٹی وائرس اسے شک کی نظر سے دیکھتے ہیں۔
کیا کریں فائل کو کوارنٹین سے بحال کریں اور یہ دو فولڈر استثنا میں شامل کریں: پروگرام کا فولڈر 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 سے پہلے ایسے اکاؤنٹس کے لیے ایپ شروع ہی نہیں ہو سکتی تھی۔
کیا کریں ٹھیک کرنے کو کچھ نہیں۔ آپ کے .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 چلائیں تاکہ اس کی process ID نظر آئے)۔ آپ کے پروجیکٹس متاثر نہیں ہوتے، صرف لاگ ان اور زبان کا انتخاب۔
شروع کرناآپ کو فکر ہے کہ ایپ اس PostgreSQL سے ٹکراتی ہے جو آپ پہلے سے پورٹ 5432 پر چلا رہے ہیں۔
اس کا مطلب نہیں ٹکراتی۔ اندرونی ڈیٹا بیس Windows میں ایک بے ترتیب خالی مقامی پورٹ لیتا ہے، اور macOS اور Linux میں صرف مقامی socket پر سنتا ہے، 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(Explorer کے ایڈریس بار میں%TEMP%ٹائپ کریں)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
Applications سے OpenConstructionERP کھولیں۔
آپ کو نظر آئے گا"ایپ شروع ہو رہی ہے" والی لوڈنگ اسکرین۔ پہلی بار چلانے پر مقامی ڈیٹا بیس بنتا ہے اور ایک یا دو منٹ لگتے ہیں۔
- 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 چلائیں تاکہ اس کی process ID نظر آئے)۔ آپ کے پروجیکٹس متاثر نہیں ہوتے، صرف لاگ ان اور زبان کا انتخاب۔
شروع کرناآپ کو فکر ہے کہ ایپ اس PostgreSQL سے ٹکراتی ہے جو آپ پہلے سے پورٹ 5432 پر چلا رہے ہیں۔
اس کا مطلب نہیں ٹکراتی۔ اندرونی ڈیٹا بیس Windows میں ایک بے ترتیب خالی مقامی پورٹ لیتا ہے، اور macOS اور Linux میں صرف مقامی socket پر سنتا ہے، 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 کے لیے ریلیز نہیں ہے۔
کیا کریں 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
نئی انسٹالیشن میں ایڈمنسٹریٹر سے ایک بار پوچھا جاتا ہے کہ آپ کون سے ماڈیول استعمال کریں گے۔ جو چاہیے ان پر نشان لگائیں اور آگے بڑھیں۔ بعد میں اوپر کی بار کے 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 چلائیں تاکہ اس کی process ID نظر آئے)۔ آپ کے پروجیکٹس متاثر نہیں ہوتے، صرف لاگ ان اور زبان کا انتخاب۔
شروع کرناآپ کو فکر ہے کہ ایپ اس PostgreSQL سے ٹکراتی ہے جو آپ پہلے سے پورٹ 5432 پر چلا رہے ہیں۔
اس کا مطلب نہیں ٹکراتی۔ اندرونی ڈیٹا بیس Windows میں ایک بے ترتیب خالی مقامی پورٹ لیتا ہے، اور macOS اور Linux میں صرف مقامی socket پر سنتا ہے، 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 چلائیں اور اسے دوبارہ چلائیں۔
انسٹالیشن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 کھولیں۔
انسٹالیشنApple Silicon والے Mac یا کسی اور ARM مشین پر Docker خبردار کرتا ہے کہ image کا پلیٹ فارم linux/amd64 میل نہیں کھاتا، یا ایپ بہت سست چلتی ہے۔
اس کا مطلب شائع شدہ image صرف 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سیٹ نہ کریں - DockerDocker volumes <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: image کا ٹیگ) اور آپ نے کیسے انسٹال کیا (Windows انسٹالر، .dmg، .deb، .rpm، AppImage، pip یا Docker) - آپ کا سسٹم (Windows: Start،
winverٹائپ کریں؛ macOS: Apple مینو، About This Mac؛ Linux: ڈسٹری بیوشن اور ورژن) - پیغام کا ٹھیک متن یا اسکرین شاٹ
- اوپر دی گئی لاگ فائلیں
لاگ فائلوں میں آپ کا صارف نام اور فولڈرز کے نام ہو سکتے ہیں۔ شائع کرنے سے پہلے انہیں دیکھ لیں؛ اگر چاہیں تو بہتر ہے ای میل سے بھیجیں۔
انسٹالیشن کے بعد اگلے مراحل
مکمل متن GitHub پر بھی English، Deutsch اور Русский میں موجود ہے۔