VPS پر Docker کے ساتھ ERPNext self-host کرنے کا طریقہ
اپنے VPS پر ERPNext چلائیں: 11 containers کی sizing، TLS، outbound email، version pinning اور ایسا restore طریقہ سیکھیں جسے پہلے آزمایا جا چکا ہو۔
آپ کس چیز کو چلانے کی ذمہ داری لے رہے ہیں
VPS پر ERPNext کو self-host کرنا operations کا کام ہے، نہ کہ ایک کمانڈ سے مکمل ہونے والی installation۔ سرکاری Docker Compose stack میں 11 containers شامل ہیں، اور اس میں آپ کا general ledger اور customer records محفوظ ہوتے ہیں۔ اس لیے ذیل کے تمام اقدامات کے لیے معیار بلند ہے: backup اس وقت تک backup نہیں ہوتا جب تک آپ اسے restore نہ کر لیں، اور image tag کو pin نہ کرنا ایسی schema migration کے انتظار کے مترادف ہے جو کسی بھی وقت شروع ہو سکتی ہے۔
چند نام پورے متن میں استعمال ہوں گے۔ ERPNext business application ہے۔ Frappe اس کے نیچے کام کرنے والا Python framework ہے۔ Bench وہ command line tool ہے جو sites کو manage کرتا ہے، اور containers کے اندر پہلے سے installed ہے۔ site سے مراد ایک tenant ہے: ایک MariaDB database اور uploaded files کی ایک directory۔ یہاں تقریباً ہر command bench کو backend container کے اندر ایک نامزد site کے خلاف چلاتی ہے۔
اس guide میں frappe_docker repository استعمال کی گئی ہے، جس کی deployment project maintain کرتا ہے۔ ذیل کی ہر command کو August 2026 میں اسی repository کے خلاف check کیا گیا تھا۔ اگر Docker Compose آپ کے لیے نیا ہے تو VPS پر Docker Compose چلانا ان بنیادی امور کی وضاحت کرتا ہے جنہیں یہ guide فرض کرتی ہے۔
ERPNext کو کتنے VPS وسائل درکار ہیں؟
اس چارٹ کے پیچھے کا ڈیٹا
[
{
"label": "Evaluation",
"vcpu": 2,
"ram_gb": 4,
"disk_gb": 40
},
{
"label": "Small production",
"vcpu": 4,
"ram_gb": 8,
"disk_gb": 100
},
{
"label": "Room to grow",
"vcpu": 4,
"ram_gb": 16,
"disk_gb": 160
}
]تشخیصی استعمال کے لیے 2 vCPU اور 4 GB RAM سے شروع کریں۔ یہ تشخیصی tier ہے۔ یہ صرف ابتدائی اعداد ہیں، اس guide کی پیمائشوں سے حاصل کردہ نتائج نہیں۔ اصل ضرورت کا تعین آپ کے اپنے دستاویزاتی حجم سے ہوتا ہے۔ آخری row کسی شائع شدہ minimum کی نمائندگی نہیں کرتی۔ اس میں memory کے لیے اضافی گنجائش دی گئی ہے، لیکن یہ ضمانت نہیں کہ memory کبھی ختم نہیں ہوگی۔
چھوٹے plans کے بارے میں حقیقت پسند رہیں۔ 1 GB یا 2 GB VPS میں دس طویل عرصے تک چلنے والے containers، MariaDB کے buffer pool اور report بنانے والے Python worker کے لیے بہت کم اضافی گنجائش بچتی ہے۔ memory pressure کے دوران kernel کا out of memory killer کسی container کو روک سکتا ہے، اور اس container پر docker inspect پھر exit code 137 کے ساتھ "OOMKilled": true دکھاتا ہے۔ دورانِ کام ختم کیا گیا worker جمع کرائی گئی دستاویز کا background work ادھورا چھوڑ دیتا ہے۔
ERPNext روزانہ استعمال کرنے والی کمپنی کے لیے 8 GB RAM، 4 vCPU اور 100 GB SSD کے مطابق planning شروع کریں، پھر اپنے workload کی جانچ کریں۔ RAM پہلے ختم ہوتی ہے۔ Disk توقع سے زیادہ تیزی سے بھر جاتی ہے، کیونکہ ہر attachment اور ہر local backup اسی volume پر محفوظ ہوتا ہے جس پر database موجود ہے۔
گیارہ کنٹینرز، اور ہر ایک کا کام
جب stack چل پڑے اور دس کنٹینرز فعال ہو جائیں تو docker compose ps چلائیں۔ ایک اور کنٹینر، configurator، اپنا کام ایک بار مکمل کر کے بند ہو جاتا ہے، اسی لیے کل تعداد گیارہ بنتی ہے۔
backendFrappe ایپلیکیشن کو gunicorn کے تحت چلاتا ہے۔ یہیںbenchموجود ہوتا ہے۔frontendnginx ہے۔ یہ static assets فراہم کرتا ہے اور باقی تمام درخواستیں backend کو بھیج دیتا ہے۔queue-shortاورqueue-longRQ (Redis Queue) ورکرز ہیں۔ یہ پس منظر میں کام انجام دیتے ہیں جیسے کہ ای میل بھیجنا، ڈیٹا امپورٹ کرنا اور رپورٹس تیار کرنا۔schedulerوقت پر مبنی کاموں (time based jobs) کو متحرک کرتا ہے، بشمول شیڈول شدہ رپورٹس اور خودکار طور پر دہرائے جانے والے دستاویزات۔websocketبراؤزر میں لائیو اپڈیٹس کے لیے socket.io کا عمل ہے۔dbMariaDB ہے۔redis-cacheاورredis-queueدو الگ الگ Redis انسٹینس ہیں، ایک cache کے لیے اور دوسرا job queue کے لیے۔proxyTraefik ہے، جسے HTTPS اوور رائڈ کے ذریعے شامل کیا گیا ہے۔ یہ ports 80 اور 443 کو کنٹرول کرتا ہے اور سرٹیفکیٹس حاصل کرتا ہے۔
اس تقسیم کو سمجھنا ضروری ہے، کیونکہ اس سے آپ کو معلوم ہوتا ہے کہ کون سا لاگ پڑھنا ہے۔ اگر ای میل پھنس جائے تو یہ queue ورکر کا مسئلہ ہے، لہذا docker compose logs -f queue-short درست کمانڈ ہے۔ اگر کوئی صفحہ لوڈ تو ہو جائے لیکن اس کا نوٹیفکیشن بیج اپڈیٹ نہ ہو تو یہ websocket کا مسئلہ ہے۔ ان میں سے کسی بھی مسئلے کے لیے backend کے لاگز پڑھنا وقت کا ضیاع ہے۔
پروڈکشن compose فائلوں کے ساتھ انسٹال کریں، demo کے ساتھ نہیں
repository میں pwd.yml شامل ہے، اور README اس بارے میں واضح ہے: "یہ setup صرف مختصر مدتی evaluation کے لیے ہے۔ آپ اس setup میں custom apps انسٹال نہیں کر سکیں گے۔" اسے ایک دوپہر کے لیے ERPNext دیکھنے کے لیے استعمال کریں۔ اس پر کمپنی نہ چلائیں۔
sudo apt update && sudo apt install -y git
curl -fsSL https://get.docker.com | bash
git clone https://github.com/frappe/frappe_docker
cd frappe_docker
mkdir -p ~/gitops
cp example.env ~/gitops/erpnext.env~/gitops/erpnext.env کھولیں اور چار values تبدیل کریں۔ ERPNEXT_VERSION image tag کو مقرر کرتا ہے۔ مثال کی فائل میں DB_PASSWORD بطور 123 شامل ہے۔ SITES_RULE Traefik کا routing rule ہے، اور LETSENCRYPT_EMAIL ACME account email فراہم کرتا ہے۔ Let's Encrypt نے June 4, 2025 کو expiration notification emails بند کر دیے تھے، اس لیے certificate expiry کی الگ نگرانی کریں۔
ERPNEXT_VERSION=v16.32.1
DB_PASSWORD=<a long random password>
SITES_RULE=Host(`erp.example.com`)
LETSENCRYPT_EMAIL=ops@example.comاب ایک compose فائل render کریں، پھر اسے start کریں۔
docker compose --project-name erpnext \
--env-file ~/gitops/erpnext.env \
-f compose.yaml \
-f overrides/compose.mariadb.yaml \
-f overrides/compose.redis.yaml \
-f overrides/compose.https.yaml \
config > ~/gitops/erpnext.yaml
docker compose --project-name erpnext -f ~/gitops/erpnext.yaml up -d
export COMPOSE_FILE="$HOME/gitops/erpnext.yaml"config کوئی چیز start نہیں کرتا۔ یہ base file کو overrides کے ساتھ merge کرتا ہے اور ہر variable کو پہلے ہی substitute کر کے نتیجہ print کرتا ہے۔ اس کے بعد آپ وہ rendered فائل run کرتے ہیں۔ یہ اضافی مرحلہ مفید ہے: چلتا ہوا stack ایک ایسی فائل ہوتا ہے جسے آپ پڑھ سکتے ہیں، اس لیے جب کوئی env file میں ترمیم کرے یا آپ repository pull کریں تو یہ آپ کے زیرِ استعمال تبدیل نہیں ہو سکتا۔ متعدد Docker Compose فائلیں کیسے merge ہوتی ہیں override rules کی تفصیل بیان کرتا ہے۔
COMPOSE_FILE export کے باعث نیچے دیے گئے commands rendered فائل استعمال کرتے ہیں۔ ہر نئے shell میں اسے دوبارہ چلائیں؛ cron میں -f ~/gitops/erpnext.yaml واضح طور پر pass کریں۔
db کے start ہونے اور configurator کے exit ہونے کا انتظار کریں۔ اس میں چند seconds لگتے ہیں۔ پھر site بنائیں۔
docker compose --project-name erpnext exec backend \
bench new-site --mariadb-user-host-login-scope=% \
--db-root-password '<your DB_PASSWORD>' \
--install-app erpnext \
--admin-password '<a strong admin password>' \
erp.example.comاسے check کریں:
docker compose --project-name erpnext ps
docker compose --project-name erpnext exec backend bench --site erp.example.com list-appslist-apps کو frappe اور erpnext اپنی versions کے ساتھ print کرنا چاہیے۔ ایک healthy ps میں running state میں ten services دکھائی دیتی ہیں، اور restarting میں کوئی service نہیں ہونی چاہیے۔
یہاں اکثر دو مسائل پیش آتے ہیں۔ --mariadb-user-host-login-scope=% نئی site کے database user کو wildcard host scope دیتا ہے، اس لیے Docker جب app container کو مختلف address assign کرتا ہے تو user پھر بھی login کر سکتا ہے۔ اس کے بغیر Frappe user کو اس وقت connect کرنے والے host تک محدود کر دیتا ہے۔ app container Docker network کے ذریعے MariaDB تک پہنچتا ہے، اس لیے وہ remote host کے طور پر آتا ہے، اور localhost تک محدود database user وہاں سے login نہیں کر سکتا۔ یہ option site کے database user کو تبدیل کرتا ہے، root account کو نہیں۔ % scope ہر اس host سے connections کی اجازت دیتا ہے جو MariaDB تک پہنچ سکتا ہو، اس لیے database کو private Docker network پر رکھیں۔
دوسرا مسئلہ site name کا ہے۔ frontend بطور default HTTP Host header سے طے کرتا ہے کہ کون سی site serve کرنی ہے، اس لیے erpnext کے نام سے بنائی گئی site erp.example.com پر reachable نہیں ہوتی، حالانکہ دونوں موجود ہوتے ہیں۔ اوپر کی طرح site کا نام domain کے مطابق رکھیں، یا env file میں FRAPPE_SITE_NAME_HEADER کو site name پر set کریں اور compose file دوبارہ render کریں۔
HTTPS، اور اس کے کام کرنے سے پہلے کیا درست ہونا چاہیے
compose.https.yaml override، Traefik کو port 443 پر چلاتا ہے، port 80 کو اس کی طرف redirect کرتا ہے، اور Let's Encrypt سے certificates طلب کرتا ہے۔ TLS (transport layer security) invoice اور session cookie کو network traffic پر plain text میں منتقل ہونے سے محفوظ رکھتا ہے۔
Certificate جاری ہونے کے لیے 2 باتیں درست ہونا ضروری ہیں۔ erp.example.com کا DNS A record پہلے ہی VPS کی طرف point ہونا چاہیے۔ ports 80 اور 443 انٹرنیٹ سے reachable ہونے چاہییں، کیونکہ Let's Encrypt port 80 پر HTTP-01 challenge کے ذریعے یہ ثابت کرتا ہے کہ آپ اس نام کو control کرتے ہیں۔ اپنے provider کا network firewall بھی چیک کریں اور server پر موجود firewall بھی۔ یہ الگ الگ controls ہیں، اور panel firewall اکثر نظر انداز ہو جاتا ہے۔
Certificates، cert-data volume میں /letsencrypt/acme.json پر محفوظ ہوتے ہیں۔ اگر browser آپ کے certificate کے بجائے default certificate دکھائے تو docker compose --project-name erpnext ps میں proxy service کا نام تلاش کریں اور اس کے logs میں ACME (automatic certificate management environment) error دیکھیں۔ کیا اسی server پر دوسری web apps بھی چل رہی ہیں؟ کئی Docker Compose apps کے سامنے ایک Traefik instance میں بتایا گیا ہے کہ port 443 پر تنازع سے بچتے ہوئے proxy کیسے share کیا جائے۔ ایسے server پر دوسری app اکثر customers کے لیے ہوتی ہے، اور self-hosted Chatwoot support desk اسی proxy کے پیچھے چلتا ہے، اس لیے invoices پر کام کرنے والے لوگ customer email اور chat کا جواب بھی ایک ہی جگہ سے دے سکتے ہیں۔
آؤٹ باؤنڈ ای میل، ورنہ invoices سسٹم سے باہر نہیں جائیں گے
یہ وہ مرحلہ ہے جسے زیادہ تر ERPNext گائیڈز نظرانداز کر دیتی ہیں، حالانکہ یہی طے کرتا ہے کہ سسٹم عملی طور پر مفید ہے یا نہیں۔ آؤٹ باؤنڈ میل کے درست کام نہ کرنے کی صورت میں کوئی invoice صارف تک نہیں پہنچتا، password reset موصول نہیں ہوتا، اور scheduled report بھیج نہیں جاتی۔ اس stack میں mail server شامل نہیں ہے۔
VPS سے port 25 پر براہِ راست mail بھیجنے کی کوشش نہ کریں۔ AWS جیسے providers outbound port 25 کو default طور پر block کرتے ہیں، جبکہ نئی sending IP کی کم یا غیر موجود reputation rejection یا spam placement کا خطرہ بڑھا دیتی ہے۔ ان میں سے کوئی نتیجہ لازمی نہیں۔ port 587 پر authenticated relay استعمال کریں، اور پہلے اپنے provider کے outbound rules دیکھیں: DigitalOcean Droplets پر ports 25، 465 اور 587 کو default طور پر block کرتا ہے۔
معاونت یافتہ طریقہ ERPNext interface میں Email Account screen استعمال کرنا ہے، جہاں password encrypted شکل میں محفوظ ہوتا ہے۔ آپ keys کو site config میں بھی لکھ سکتے ہیں:
docker compose --project-name erpnext exec backend \
bench --site erp.example.com set-config mail_server smtp.example.com
docker compose --project-name erpnext exec backend \
bench --site erp.example.com set-config mail_port 587 --parse
docker compose --project-name erpnext exec backend \
bench --site erp.example.com set-config use_tls 1 --parse
docker compose --project-name erpnext exec backend \
bench --site erp.example.com set-config mail_login 'erp@example.com'
docker compose --project-name erpnext exec backend \
bench --site erp.example.com set-config auto_email_id 'erp@example.com'--parse، 587 کو string "587" کے بجائے number کے طور پر محفوظ کرتا ہے۔ فائل دوبارہ پڑھیں اور تصدیق کریں کہ ان دونوں values کے گرد quotes موجود نہ ہوں:
docker compose --project-name erpnext exec backend \
cat sites/erp.example.com/site_config.jsonencrypted password storage کے لیے outgoing server، login اور password کو Email Account screen میں ایک ساتھ configure کریں۔ اس کا password field الگ mail_password site config key مقرر نہیں کرتا۔
اس کے بعد ایک حقیقی message بھیجیں۔ Sales Invoice بنائیں، اسے ایسے address پر email کریں جس تک آپ کی رسائی ہو، اور اسی دوران queue کو monitor کریں:
docker compose --project-name erpnext logs -f queue-shortOutgoing mail ایک background job ہے، اس لیے جو message کبھی نہیں پہنچتا وہ عموماً browser میں error کے بجائے اس log میں failed job کے طور پر نظر آتا ہے۔ sending domain کے لیے SPF (sender policy framework) اور DKIM (domainkeys identified mail) records بھی publish کریں، پھر DMARC policy شامل کریں۔ authentication کے بغیر تکنیکی طور پر درست invoice بھی rejection یا spam placement کا شکار ہو سکتا ہے۔ اگر آپ پورا mail path خود manage کرنا چاہتے ہیں تو self-hosted Mailcow mail server ERP سے الگ box پر آپ کے کنٹرول میں relay فراہم کرتا ہے۔
ایسے بیک اپ جو واقعی بحال ہو سکیں
صرف ایک database dump بذات خود ERPNext کا مکمل بیک اپ نہیں ہے۔ attachments اور نجی فائلیں MariaDB میں نہیں بلکہ sites ڈائریکٹری میں موجود ہوتی ہیں۔ اگر آپ صرف ڈیٹا بیس بحال کریں گے تو ہر اپ لوڈ کردہ purchase order ایک ٹوٹے ہوئے لنک کی صورت میں ظاہر ہوگا۔
docker compose --project-name erpnext exec backend \
bench --site erp.example.com backup --with-filesیہ کمانڈ sites والیوم کے اندر sites/erp.example.com/private/backups میں چار فائلیں لکھتی ہے:
- ایک
-database.sql.gzڈمپ - عوامی فائلوں کا ایک
-files.tarآرکائیو - نجی فائلوں کا ایک
-private-files.tarآرکائیو - سائٹ کنفیگریشن کی ایک
-site_config_backup.jsonکاپی
چوتھی فائل وہ ہے جسے لوگ ضائع کر دیتے ہیں، اور یہی سب سے زیادہ نقصان دہ ثابت ہوتی ہے۔ اس میں encryption_key موجود ہوتا ہے، وہ کلید جسے Frappe ذخیرہ شدہ پاس ورڈز کو انکرپٹ کرنے کے لیے استعمال کرتا ہے: ای میل اکاؤنٹ کی اسناد، پیمنٹ گیٹ وے کیز، اور ہر انٹیگریشن کا خفیہ کوڈ۔ اگر آپ متعلقہ کلید کے بغیر ڈیٹا بیس بحال کریں گے تو سائٹ عام طور پر لوڈ تو ہو جائے گی، لیکن ای میل بھیجنا اس ایرر کے ساتھ ناکام ہو جائے گا:
frappe.exceptions.ValidationError: Encryption key is invalid! Please check site_config.jsonچاروں فائلوں کو ہمیشہ ایک ساتھ رکھیں۔
پھر انہیں سرور سے باہر منتقل کریں۔ والیوم کے اندر موجود بیک اپ سرور کے ساتھ ختم ہو جاتا ہے، اور bench اسے ویسے بھی صاف کر دیتا ہے: یہ بائی ڈیفالٹ اس ڈائریکٹری سے 23 گھنٹے سے پرانے بیک اپ حذف کر دیتا ہے۔ Frappe 16.20.0 اور 15.114.0 سے پہلے یہ ڈیفالٹ 24 گھنٹے تھا، اور سائٹ کنفیگریشن میں موجود keep_backups_for_hours کلید اسے اوور رائڈ (override) کرتی ہے۔
docker compose --project-name erpnext cp \
backend:/home/frappe/frappe-bench/sites/erp.example.com/private/backups \
~/erpnext-backupsاسے cron سے چلائیں، اور پھر ڈائریکٹری کو کسی ایسی جگہ بھیج دیں جسے آپ خود manage نہیں کرتے۔ آف سائٹ اسٹوریج پر انکرپٹڈ restic بیک اپ اس کے لیے بہترین ٹول ہے، کیونکہ یہ اپ لوڈ سے پہلے انکرپشن کرتا ہے اور restic check اس بات کی تصدیق کرتا ہے کہ ریپوزٹری اب بھی قابلِ مطالعہ ہے۔ ERP کا بیک اپ آپ کے پورے لیجر کی نقل ہوتا ہے، اس لیے اسے کسی ایسے ہارڈویئر پر انکرپٹڈ حالت میں ہونا چاہیے جو یہ سرور نہ ہو۔
بحالی کی ضرورت پڑنے سے پہلے اس کی جانچ کریں
غیر آزمودہ backup محض ایک اندازہ ہے۔ اسے اسی server پر دوسری site میں restore کر کے test کریں؛ اسے کبھی live site میں restore نہ کریں۔
docker compose --project-name erpnext exec backend \
bench new-site --mariadb-user-host-login-scope=% \
--db-root-password '<your DB_PASSWORD>' \
--admin-password '<a strong admin password>' \
restore-test.example.com
docker compose --project-name erpnext exec backend \
bench --site restore-test.example.com --force restore \
sites/erp.example.com/private/backups/<stamp>-erp_example_com-database.sql.gz \
--with-public-files sites/erp.example.com/private/backups/<stamp>-erp_example_com-files.tar \
--with-private-files sites/erp.example.com/private/backups/<stamp>-erp_example_com-private-files.tar \
--db-root-password '<your DB_PASSWORD>'backup کی گئی configuration سے encryption key کو restored site میں copy کریں، ورنہ اس کے integrations کام نہیں کریں گے:
docker compose --project-name erpnext exec backend \
bench --site restore-test.example.com set-config encryption_key '<value from site_config_backup.json>'اب restore کو اس طرح جانچیں جیسے کوئی accountant جانچ کرتا ہے۔ Accounts Receivable report کھولیں اور closing balance کو live site کے balance سے ملائیں۔ حالیہ purchase invoice کھولیں اور اس کی attachment download کریں۔ ایسی site جس پر صرف login page ظاہر ہو جائے، اس سے کچھ ثابت نہیں ہوتا۔
کام مکمل ہونے پر test site remove کریں:
docker compose --project-name erpnext exec backend \
bench drop-site restore-test.example.comERPNext کے لیے version pinning زیادہ اہم کیوں ہے
Static site پر unpinned image tag کا مطلب غیر متوقع restart ہوتا ہے۔ ERPNext پر اس کا مطلب schema migration ہے۔ bench migrate database tables کو دوبارہ لکھتا ہے اور document data بھی تبدیل کر سکتا ہے، جبکہ اسے undo نہیں کیا جا سکتا۔ Rollback کے لیے backup restore کرنا پڑتا ہے، نہ کہ docker compose down۔
اس لیے tag کو pin کریں۔ ERPNEXT_VERSION=v16.32.1 وہ release تھا جسے repository کے اپنے pwd.yml میں August 2026 میں pin کیا گیا تھا۔ 2026-11-16 کو pwd.yml اور example.env دونوں نے v16.55.0 کو pin کیا تھا۔ تصدیق کیے بغیر ان میں سے کسی بھی number کو آگے استعمال نہ کریں۔ موجودہ releases frappe/erpnext releases page پر درج ہیں، جبکہ موجود image tags Docker Hub پر موجود ہیں۔ جس version پر منتقل ہونا ہے، منتقلی سے پہلے اس کے notes پڑھیں۔
Upgrade کا آغاز backup اور maintenance mode سے ہوتا ہے۔
docker compose --project-name erpnext exec backend \
bench --site erp.example.com backup --with-files
docker compose --project-name erpnext exec backend \
bench --site erp.example.com set-maintenance-mode on~/gitops/erpnext.env میں ERPNEXT_VERSION کو edit کریں، پھر render، pull اور migrate کریں۔
docker compose --project-name erpnext \
--env-file ~/gitops/erpnext.env \
-f compose.yaml \
-f overrides/compose.mariadb.yaml \
-f overrides/compose.redis.yaml \
-f overrides/compose.https.yaml \
config > ~/gitops/erpnext.yaml
docker compose --project-name erpnext -f ~/gitops/erpnext.yaml pull
docker compose --project-name erpnext -f ~/gitops/erpnext.yaml up -d
docker compose --project-name erpnext exec backend \
bench --site erp.example.com migrate
docker compose --project-name erpnext exec backend \
bench --site erp.example.com set-maintenance-mode offMaintenance mode اہم ہے کیونکہ migrate چلتے وقت schema تبدیل کرتا ہے۔ اگر کوئی user آدھی migration والی table کے خلاف document submit کرے تو records کو دستی طور پر repair کرنا پڑ سکتا ہے۔
ایک وقت میں صرف ایک major version پر منتقل ہوں، اور ہر step سے پہلے backup بنائیں۔ آگے بڑھنے سے پہلے ہر major version کے لیے migration guidance دیکھیں۔
Repository overrides/compose.migrator.yaml بھی فراہم کرتی ہے۔ یہ ایسا container شامل کرتا ہے جو start کے وقت bench --site all migrate چلاتا ہے، بشرطیکہ sites موجود ہوں اور MIGRATE_SITES enabled ہو، جیسا کہ default طور پر ہوتا ہے۔ یہ سہولت فراہم کرتا ہے۔ لیکن اس کا مطلب یہ بھی ہے کہ tag تبدیل کرنے والا docker compose up کسی کی نگرانی کے بغیر production database migrate کر سکتا ہے۔ Business system پر migrate اسی وقت چلائیں جب آپ نے اسی صبح یہ فیصلہ کیا ہو۔
کسٹمر ریکارڈ رکھنے والے box کو زیادہ محفوظ بنانا
پہلے login پر Administrator کا password تبدیل کریں۔ evaluation compose file میں admin بطور password موجود ہے، اور یہ عادت لوگوں کے ساتھ production تک پہنچ جاتی ہے۔
DB_PASSWORD کو 123 سے تبدیل کریں، جو example.env میں ہے۔ یہ value سادہ متن میں تیار کردہ ~/gitops/erpnext.yaml میں شامل ہو جاتی ہے، اس لیے chmod 600 فائل کو محفوظ رکھیں اور اسے کسی git repository سے باہر رکھیں۔ مزید مضبوط طریقے کے لیے overrides/compose.mariadb-secrets.yaml password کو environment variable کے بجائے Docker secret file سے پڑھتا ہے۔ Docker Compose میں env files اور secrets کا انتظام میں ان طریقوں کے فوائد اور نقصانات بیان کیے گئے ہیں۔
صرف مطلوبہ چیزیں publish کریں۔ HTTPS override کے ساتھ صرف ports 80 اور 443 exposed ہوتے ہیں۔ database client کو آسانی سے connect کرانے کے لیے db service میں ports mapping شامل نہ کریں، کیونکہ اس سے MariaDB public internet پر دستیاب ہو جاتی ہے۔ اس کے بجائے docker compose --project-name erpnext exec backend bench mariadb استعمال کریں۔ host پر 22، 80 اور 443 کی اجازت دیں، باقی سب کو deny کریں، اور provider کے الگ network firewall کو بھی چیک کریں۔
System Settings میں System Manager role رکھنے والے ہر account کے لیے two factor authentication فعال کریں۔ یہ role System Settings تبدیل کر سکتا ہے، اس لیے اسے سہولت کے بجائے administrator account سمجھیں۔ اگر آپ کئی self-hosted apps چلاتے ہیں تو self-hosted single sign-on provider کے طور پر Authentik ہر app کے لیے ایک اضافی password رکھنے سے بہتر ہے۔
host کو patch کریں اور kernel updates کے لیے reboot کریں۔ stack کے دوبارہ چلنے پر انحصار کرنے سے پہلے ہر service کے لیے تیار کردہ file میں restart policy چیک کریں، کیونکہ جس stack میں یہ policy نہ ہو وہ reboot کے بعد بند رہتا ہے۔ reboot کے بعد Docker Compose stack کو دوبارہ شروع کرنا systemd سے متعلق طریقہ بیان کرتا ہے۔
جب ERPNext ایک VPS پر آرام دہ نہ رہے
ایک VPS طویل عرصے تک ایک چھوٹی کمپنی کی ضروریات پوری کر سکتا ہے۔ لیکن درج ذیل علامات ظاہر ہوں تو یہ مزید کافی نہیں رہتا:
- Background jobs جمع ہونے لگتی ہیں، اس لیے emails اور imports کئی منٹ یا کئی گھنٹے کی تاخیر سے پہنچتے ہیں۔
docker inspect،"OOMKilled": trueکے ساتھ یا exit code 137 کے ذریعے containers کے مسائل رپورٹ کرتا ہے۔- وہ reports جنہیں پہلے دو seconds لگتے تھے، اب thirty seconds لیتی ہیں، اور MariaDB CPU استعمال کرنے والا process ہوتا ہے۔
- Backups اتنا وقت لیتے ہیں کہ ایک backup اگلے scheduled run کے ساتھ overlap کرنے لگتا ہے۔
سب سے پہلے MariaDB کو ایسے resources دیں جو اس کے ساتھ shared نہ ہوں، کیونکہ database اور Python workers ایک ہی memory کے لیے مقابلہ کرتے ہیں، جبکہ buffer pool کو زیادہ memory درکار ہوتی ہے۔ Application server کو بڑا کرنے سے عموماً توقع سے کم فائدہ ہوتا ہے۔ database کو Docker یا host پر چلانا اس فیصلے کا احاطہ کرتا ہے، جبکہ Docker Compose میں memory limits مقرر کرنا ایک container کو دوسرے containers کے resources ختم کرنے سے روکتا ہے۔
اس کے بعد web capacity کے بجائے queue workers شامل کریں۔ ERPNext کا سست کام background work ہوتا ہے، جس میں report generation اور bulk imports شامل ہیں۔ زیادہ workers کے لیے CPU اور memory headroom درکار ہوتا ہے؛ پہلے سے saturated VPS میں containers شامل کرنے سے capacity میں اضافہ نہیں ہوتا۔
FAQ
VPS پر ERPNext کو کتنی RAM درکار ہوتی ہے؟
جائزے کے لیے 4 GB RAM اور 2 vCPU سے شروع کریں۔ روزانہ استعمال کرنے والی کمپنی کے لیے 8 GB RAM، 4 vCPU اور 100 GB SSD مختص کریں۔ میموری پر دباؤ کی صورت میں kernel کا out of memory killer containers کو روک سکتا ہے۔ docker inspect اسے exit code 137 کے ساتھ "OOMKilled": true کے طور پر رپورٹ کرتا ہے۔ یہ صرف ابتدائی تخمینے ہیں، پیمائش نہیں۔ اس لیے پہلے مہینے کے دوران اپنی میموری کے استعمال کی نگرانی کریں۔
کیا میں production میں pwd.yml چلا سکتا ہوں؟
نہیں۔ project کی README میں اسے صرف مختصر مدتی جائزے کے لیے بتایا گیا ہے، اور یہ بھی درج ہے کہ اس میں custom apps install نہیں کی جا سکتیں۔ MariaDB، Redis اور HTTPS overrides کے ساتھ compose.yaml استعمال کریں، انہیں docker compose config سے ایک فائل میں render کریں، اور وہ فائل چلائیں۔
site بنانے کے فوراً بعد میری ERPNext site قابل رسائی کیوں نہیں ہوتی؟
frontend عموماً HTTP Host header سے یہ طے کرتا ہے کہ کون سی site serve کرنی ہے۔ اس لیے site کا نام browser میں موجود domain سے مطابقت رکھنا چاہیے۔ erpnext کے نام سے بنائی گئی site کو erp.example.com پر serve نہیں کیا جاتا۔ یا تو domain کو site کے نام کے طور پر استعمال کرتے ہوئے site بنائیں، یا env file میں FRAPPE_SITE_NAME_HEADER کو site کے نام پر set کریں، compose file دوبارہ render کریں، اور stack restart کریں۔
ERPNext backup میں کیا شامل ہونا چاہیے؟
چار فائلیں ایک ساتھ محفوظ رکھیں: -database.sql.gz dump، -files.tar اور -private-files.tar archives، اور -site_config_backup.json config copy۔ bench --site erp.example.com backup --with-files چلانے سے یہ چاروں فائلیں بن جاتی ہیں۔ config copy میں encryption_key موجود ہوتا ہے۔ اس کے بغیر restore کرنے پر محفوظ شدہ integration passwords decrypt نہیں کیے جا سکتے، اور نتیجے میں Encryption key is invalid! Please check site_config.json ظاہر ہوتا ہے۔
میں اپنا data خراب کیے بغیر ERPNext کو upgrade کیسے کروں؟
--with-files سے backup لیں، maintenance mode فعال کریں، env file میں ERPNEXT_VERSION تبدیل کریں، compose file دوبارہ render کریں، images pull کریں، stack start کریں، پھر bench --site erp.example.com migrate چلائیں اور maintenance mode غیر فعال کریں۔ ہر بار صرف ایک major version آگے جائیں اور پہلے release notes پڑھیں، کیونکہ migrate schema اور document data کو اس طرح rewrite کرتا ہے جسے واپس undo نہیں کیا جا سکتا۔ Rollback کے لیے شروع میں لیا گیا backup restore کریں۔