SSD Nodes Learn Hosting plans →
गाइड Matt Connorलेखक: Matt Connor

VPS पर Docker के साथ ERPNext कैसे host करें

Docker के जरिए VPS पर ERPNext को host करने की पूरी प्रक्रिया जानें। इसमें 11 कंटेनर स्टैक, TLS कॉन्फ़िगरेशन, आउटबाउंड ईमेल सेटअप, वर्शन पिनिंग और बैकअप रिस्टोर के सटीक तरीके शामिल हैं।

आप क्या चलाने के लिए साइन अप कर रहे हैं

VPS पर ERPNext को self-host करना एक operations का काम है, न कि एक command में होने वाला install। आधिकारिक Docker Compose stack में ग्यारह containers होते हैं, और इसमें आपका general ledger तथा customer records सुरक्षित रहते हैं। यह नीचे दी गई हर चीज़ के लिए मानक को बढ़ा देता है: backup तब तक backup नहीं है जब तक आपने उसे restore न किया हो, और एक unpinned image tag का मतलब है कि 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 का उपयोग करती है, जो कि project द्वारा maintain किया जाने वाला deployment है। नीचे दी गई हर command को अगस्त 2026 में उस repository के आधार पर जाँचा गया था। यदि Docker Compose आपके लिए नया है, तो VPS पर Docker Compose चलाना उन बुनियादी बातों को कवर करता है जिन्हें यह guide मानकर चलती है।

ERPNext के लिए कितने VPS की आवश्यकता है?

चार्टERPNext sizing starting points (guidance, not a measurement)
इस चार्ट के पीछे का डेटा
[
  {
    "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 से शुरुआत करें। यह मूल्यांकन स्तर (evaluation tier) है। ये केवल शुरुआती बिंदु हैं, इस गाइड से लिए गए माप नहीं, और आपके दस्तावेज़ों की वास्तविक संख्या ही सही आवश्यकता तय करती है। अंतिम पंक्ति कोई प्रकाशित न्यूनतम आवश्यकता नहीं है। यह आपको अधिक मेमोरी headroom देती है, न कि इस बात की गारंटी कि मेमोरी कभी समाप्त नहीं होगी।

छोटे plans के बारे में यथार्थवादी रहें। 1 GB या 2 GB का VPS दस लंबे समय तक चलने वाले containers, MariaDB के buffer pool और रिपोर्ट तैयार करने वाले Python worker के लिए बहुत कम headroom छोड़ता है। मेमोरी के दबाव में, kernel का out of memory killer किसी container को रोक सकता है, और उस पर docker inspect चलाने से exit code 137 के साथ "OOMKilled": true दिखाई देता है। काम के बीच में मारा गया worker एक सबमिट किए गए दस्तावेज़ को अधूरा छोड़ देता है।

ERPNext का दैनिक उपयोग करने वाली कंपनी के लिए, 8 GB RAM, 4 vCPU और 100 GB SSD के साथ योजना बनाना शुरू करें, फिर अपने workload का परीक्षण करें। RAM सबसे पहले समाप्त होती है। डिस्क लोगों की अपेक्षा से अधिक तेज़ी से भरती है, क्योंकि प्रत्येक अटैचमेंट और प्रत्येक local backup उसी volume पर जाता है जहाँ डेटाबेस स्थित है।

ग्यारह कंटेनर और प्रत्येक का कार्य

स्टैक के चालू होने और दस कंटेनरों के चलने के बाद docker compose ps चलाएं। एक और, configurator, अपना काम एक बार करके बंद हो जाता है, जिससे कुल संख्या ग्यारह हो जाती है।

  • backend, gunicorn के अंतर्गत Frappe एप्लिकेशन को चलाता है। यहीं पर bench स्थित है।
  • frontend, nginx है। यह static assets को सर्व करता है और बाकी सब कुछ backend को भेज देता है।
  • queue-short और queue-long, RQ (Redis Queue) वर्कर्स हैं। ये बैकग्राउंड जॉब्स जैसे कि आउटगोइंग ईमेल, इम्पोर्ट और रिपोर्ट बिल्ड चलाते हैं।
  • scheduler, समय-आधारित जॉब्स को ट्रिगर करता है, जिसमें निर्धारित रिपोर्ट और ऑटो-रिपीट डॉक्यूमेंट्स शामिल हैं।
  • websocket, ब्राउज़र में लाइव अपडेट के लिए जिम्मेदार socket.io प्रोसेस है।
  • db, MariaDB है।
  • redis-cache और redis-queue, दो अलग-अलग Redis इंस्टेंस हैं, एक कैश के लिए और एक जॉब क्यू के लिए।
  • proxy, Traefik है, जिसे HTTPS ओवरराइड द्वारा जोड़ा गया है। यह पोर्ट 80 और 443 को नियंत्रित करता है और सर्टिफिकेट प्राप्त करता है।

इस विभाजन को समझना उपयोगी है, क्योंकि इससे पता चलता है कि कौन सा लॉग पढ़ना है। यदि ईमेल अटक गया है, तो यह एक क्यू वर्कर की समस्या है, इसलिए docker compose logs -f queue-short सही कमांड है। यदि कोई पेज लोड तो होता है लेकिन उसका नोटिफिकेशन बैज अपडेट नहीं होता, तो यह एक वेबसॉकेट की समस्या है। इन दोनों स्थितियों में backend के लॉग पढ़ने में समय बर्बाद होगा।

डेमो के बजाय प्रोडक्शन compose फाइलों के साथ इंस्टॉल करें

यह रिपॉजिटरी pwd.yml प्रदान करती है, और README इस बारे में स्पष्ट है: "यह सेटअप केवल अल्पकालिक मूल्यांकन के लिए है। आप इस सेटअप में कस्टम ऐप्स इंस्टॉल नहीं कर पाएंगे।" इसका उपयोग 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 खोलें और चार मान बदलें। ERPNEXT_VERSION इमेज टैग को पिन करता है। उदाहरण फ़ाइल में DB_PASSWORD, 123 के रूप में आता है। SITES_RULE Traefik राउटिंग नियम है, और LETSENCRYPT_EMAIL ACME अकाउंट ईमेल प्रदान करता है। Let’s Encrypt ने 4 जून, 2025 को एक्सपायरी नोटिफिकेशन ईमेल भेजना बंद कर दिया है, इसलिए सर्टिफिकेट की समाप्ति को अलग से मॉनिटर करें।

ERPNEXT_VERSION=v16.32.1
DB_PASSWORD=<a long random password>
SITES_RULE=Host(`erp.example.com`)
LETSENCRYPT_EMAIL=ops@example.com

अब एक compose फ़ाइल रेंडर करें, फिर उसे स्टार्ट करें।

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 कुछ भी स्टार्ट नहीं करता है। यह बेस फ़ाइल को ओवरराइड्स के साथ मर्ज करता है और हर वेरिएबल के प्रतिस्थापित होने के बाद परिणाम प्रिंट करता है। फिर आप उस रेंडर की गई फ़ाइल को रन करते हैं। यह अतिरिक्त चरण उपयोगी है: रनिंग स्टैक एक ऐसी फ़ाइल है जिसे आप पढ़ सकते हैं, इसलिए जब कोई env फ़ाइल को एडिट करता है या आप रिपॉजिटरी को पुल करते हैं, तो यह आपके बिना जानकारी के बदल नहीं सकती। Docker Compose की कई फाइलें कैसे मर्ज होती हैं ओवरराइड नियमों को विस्तार से समझाता है।

COMPOSE_FILE एक्सपोर्ट नीचे दिए गए कमांड्स को रेंडर की गई फ़ाइल का उपयोग करने के लिए बाध्य करता है। इसे प्रत्येक नए शेल में दोहराएं; cron में, -f ~/gitops/erpnext.yaml को स्पष्ट रूप से पास करें।

db के स्टार्ट होने और configurator के एग्जिट होने की प्रतीक्षा करें, जिसमें कुछ सेकंड लगते हैं, फिर साइट बनाएं।

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

इसे चेक करें:

docker compose --project-name erpnext ps
docker compose --project-name erpnext exec backend bench --site erp.example.com list-apps

list-apps को frappe और erpnext को उनके वर्ज़न के साथ प्रिंट करना चाहिए। एक स्वस्थ ps में running स्टेट में दस सर्विसेज दिखनी चाहिए और restarting में कोई नहीं।

यहाँ अक्सर दो चीजें गलत हो जाती हैं। --mariadb-user-host-login-scope=% नई साइट के डेटाबेस यूजर को वाइल्डकार्ड होस्ट स्कोप देता है, ताकि जब Docker ऐप कंटेनर को अलग एड्रेस असाइन करे, तब भी वह लॉग इन कर सके। इसके बिना, Frappe यूजर को वर्तमान कनेक्टिंग होस्ट तक सीमित कर देता है। ऐप कंटेनर Docker नेटवर्क के माध्यम से MariaDB तक पहुँचता है, इसलिए यह एक रिमोट होस्ट के रूप में आता है, और localhost तक सीमित डेटाबेस यूजर वहां से लॉग इन नहीं कर सकता। यह विकल्प साइट के डेटाबेस यूजर को बदलता है, न कि root अकाउंट को। % स्कोप किसी भी ऐसे होस्ट से कनेक्शन की अनुमति देता है जो MariaDB तक पहुँच सकता है, इसलिए डेटाबेस को प्राइवेट Docker नेटवर्क पर रखें।

दूसरी समस्या साइट का नाम है। फ्रंटएंड डिफ़ॉल्ट रूप से HTTP Host हेडर से चुनता है कि कौन सी साइट सर्व करनी है, इसलिए erpnext के रूप में बनाई गई साइट erp.example.com पर पहुंच योग्य नहीं होती, भले ही दोनों मौजूद हों। साइट का नाम डोमेन के अनुसार रखें, जैसा कि ऊपर बताया गया है, या env फ़ाइल में FRAPPE_SITE_NAME_HEADER को साइट के नाम पर सेट करें और compose फ़ाइल को फिर से रेंडर करें।

HTTPS, और इसके काम करने के लिए किन शर्तों का पूरा होना आवश्यक है

compose.https.yaml ओवरराइड Traefik को port 443 पर चलाता है, port 80 को उस पर रीडायरेक्ट करता है, और Let's Encrypt से सर्टिफिकेट का अनुरोध करता है। TLS (transport layer security) वह तकनीक है जो इनवॉइस और सेशन कुकी को नेटवर्क पर सादे टेक्स्ट (plain text) में जाने से रोकती है।

दो चीजें सही होनी चाहिए, अन्यथा कोई सर्टिफिकेट जारी नहीं होगा। erp.example.com के लिए DNS A रिकॉर्ड पहले से ही VPS की ओर इशारा करना चाहिए। Port 80 और 443 इंटरनेट से एक्सेस करने योग्य होने चाहिए, क्योंकि Let's Encrypt यह पुष्टि करता है कि आप port 80 पर HTTP-01 चैलेंज के माध्यम से डोमेन नाम को नियंत्रित करते हैं। अपने प्रदाता के नेटवर्क फायरवॉल के साथ-साथ सर्वर के फायरवॉल की भी जाँच करें। ये दोनों अलग-अलग नियंत्रण हैं, और लोग अक्सर पैनल फायरवॉल को भूल जाते हैं।

सर्टिफिकेट cert-data वॉल्यूम में /letsencrypt/acme.json पर सेव होते हैं। यदि ब्राउज़र आपके सर्टिफिकेट के बजाय डिफ़ॉल्ट सर्टिफिकेट दिखाता है, तो docker compose --project-name erpnext ps में प्रॉक्सी सर्विस का नाम खोजें और ACME (automatic certificate management environment) त्रुटि के लिए उसके लॉग पढ़ें। क्या आप उसी सर्वर पर अन्य वेब ऐप्स चला रहे हैं? कई Docker Compose ऐप्स के सामने एक Traefik इंस्टेंस दिखाता है कि port 443 के लिए संघर्ष करने के बजाय प्रॉक्सी को कैसे साझा किया जाए। इस तरह के सर्वर पर दूसरा ऐप अक्सर ग्राहकों के लिए होता है, और एक self-hosted Chatwoot सपोर्ट डेस्क उसी प्रॉक्सी के पीछे स्थित होता है, ताकि जो लोग इनवॉइस पर काम करते हैं, वे एक ही जगह से ग्राहकों के ईमेल और चैट का जवाब भी दे सकें।

आउटबाउंड ईमेल, या इनवॉइस का सर्वर से बाहर न जाना

यह वह चरण है जिसे अधिकांश ERPNext गाइड छोड़ देती हैं, और यही वह चरण है जो यह तय करता है कि सिस्टम उपयोगी है या नहीं। यदि आउटबाउंड मेल काम नहीं कर रहा है, तो कोई भी इनवॉइस ग्राहक तक नहीं पहुँचेगा, पासवर्ड रीसेट का ईमेल नहीं आएगा, और कोई भी निर्धारित रिपोर्ट डिलीवर नहीं होगी। इस स्टैक में कोई मेल सर्वर शामिल नहीं है।

VPS से सीधे पोर्ट 25 पर मेल भेजने का प्रयास न करें। AWS जैसे प्रदाता डिफ़ॉल्ट रूप से आउटबाउंड पोर्ट 25 को ब्लॉक करते हैं, और बिना किसी इतिहास वाला नया सेंडिंग IP रिजेक्शन या स्पैम में जाने के जोखिम को बढ़ा देता है। इनमें से कोई भी परिणाम अनिवार्य नहीं है। पोर्ट 587 पर एक ऑथेंटिकेटेड रिले का उपयोग करें, और पहले अपने प्रदाता के आउटबाउंड नियमों की जाँच करें: DigitalOcean डिफ़ॉल्ट रूप से Droplets पर पोर्ट 25, 465 और 587 को ब्लॉक करता है।

समर्थित तरीका ERPNext इंटरफ़ेस में Email Account स्क्रीन है, जो पासवर्ड को एन्क्रिप्ट करके स्टोर करती है। आप 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 को स्ट्रिंग "587" के बजाय एक नंबर के रूप में स्टोर करता है। फ़ाइल को दोबारा पढ़ें और पुष्टि करें कि उन दो मानों के चारों ओर कोई कोट्स (quotes) नहीं हैं:

docker compose --project-name erpnext exec backend \
  cat sites/erp.example.com/site_config.json

एन्क्रिप्टेड पासवर्ड स्टोरेज के लिए, Email Account स्क्रीन में आउटगोइंग सर्वर, लॉगिन और पासवर्ड को एक साथ कॉन्फ़िगर करें। इसका पासवर्ड फ़ील्ड अलग से mail_password site config key को सेट नहीं करता है।

इसके बाद एक वास्तविक संदेश भेजें। एक Sales Invoice बनाएँ, इसे अपने नियंत्रण वाले ईमेल पते पर भेजें, और ऐसा करते समय कतार (queue) पर नज़र रखें:

docker compose --project-name erpnext logs -f queue-short

आउटगोइंग मेल एक बैकग्राउंड जॉब है, इसलिए जो संदेश नहीं पहुँचता है, वह आमतौर पर ब्राउज़र में एरर के बजाय उस लॉग में एक फेल्ड जॉब के रूप में दिखाई देता है। सेंडिंग डोमेन के लिए SPF (sender policy framework) और DKIM (domainkeys identified mail) रिकॉर्ड प्रकाशित करें, और फिर एक DMARC पॉलिसी जोड़ें। ऑथेंटिकेशन के बिना, तकनीकी रूप से सही इनवॉइस के भी रिजेक्ट होने या स्पैम में जाने का जोखिम रहता है। यदि आप पूरे पाथ का स्वामित्व स्वयं रखना चाहते हैं, तो एक self-hosted Mailcow mail server आपको एक ऐसा रिले देता है जिसे आप नियंत्रित कर सकते हैं, जो ERP से अलग बॉक्स पर स्थित होता है।

ऐसे बैकअप जो वास्तव में रिस्टोर होते हैं

केवल एक डेटाबेस डंप ERPNext का पूर्ण बैकअप नहीं है। अटैचमेंट्स और प्राइवेट फाइलें MariaDB में नहीं, बल्कि sites डायरेक्टरी में रहती हैं। यदि आप केवल डेटाबेस को रिस्टोर करते हैं, तो हर अपलोड किया गया परचेज ऑर्डर एक टूटे हुए लिंक के रूप में दिखाई देगा।

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 होता है, वह की (key) जिसका उपयोग Frappe संग्रहीत पासवर्ड को एन्क्रिप्ट करने के लिए करता है: ईमेल अकाउंट क्रेडेंशियल्स, पेमेंट गेटवे कीज़, और हर इंटीग्रेशन सीक्रेट। यदि आप बिना मैचिंग की (key) के डेटाबेस को रिस्टोर करते हैं, तो साइट सामान्य रूप से लोड होगी, लेकिन ईमेल भेजना इस एरर के साथ विफल हो जाएगा:

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 की (key) इसे ओवरराइड करती है।

docker compose --project-name erpnext cp \
  backend:/home/frappe/frappe-bench/sites/erp.example.com/private/backups \
  ~/erpnext-backups

इसे cron से चलाएं, और फिर डायरेक्टरी को किसी ऐसी जगह पुश करें जिसे आप एडमिनिस्टर नहीं करते हैं। ऑफ-साइट स्टोरेज पर एन्क्रिप्टेड restic बैकअप इसके लिए सही टूल है, क्योंकि यह अपलोड करने से पहले डेटा को एन्क्रिप्ट करता है और restic check यह प्रमाणित करता है कि रिपॉजिटरी अभी भी पढ़ने योग्य है। ERP बैकअप आपके पूरे लेजर की एक कॉपी है, इसलिए इसे किसी अन्य हार्डवेयर पर एन्क्रिप्टेड अवस्था में रखा जाना चाहिए।

जरूरत पड़ने से पहले restore का परीक्षण करें

बिना परीक्षण किया गया backup केवल एक अनुमान है। इसका परीक्षण उसी मशीन पर किसी दूसरे स्थान (site) पर करें, कभी भी live site पर न करें।

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>'

Encryption key को backed up config से copy करके restored site में डालें, अन्यथा इसके 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 से करें। हाल ही का कोई purchase invoice खोलें और उसका attachment download करें। केवल login page का दिखना यह साबित नहीं करता कि सब कुछ ठीक है।

काम पूरा होने पर test site को हटा दें:

docker compose --project-name erpnext exec backend \
  bench drop-site restore-test.example.com

ERPNext के लिए version pinning क्यों अधिक महत्वपूर्ण है

एक static site पर unpinned image tag का मतलब केवल एक अचानक restart हो सकता है। ERPNext पर इसका मतलब एक schema migration है। bench migrate database tables को rewrite करता है और document data को भी बदल सकता है, और इसे undo करने का कोई विकल्प नहीं है। Rollback करने का अर्थ है backup से restore करना, न कि कोई docker compose down।

इसलिए tag को pin करें। अगस्त 2026 में repository के अपने pwd.yml में ERPNEXT_VERSION=v16.32.1 वह release थी जिसे pin किया गया था। 2026-11-16 को pwd.yml और example.env दोनों ने v16.55.0 को pin किया था। जाँच किए बिना किसी भी संख्या को आगे न बढ़ाएं। वर्तमान 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 off

Maintenance mode महत्वपूर्ण है क्योंकि migrate चलते समय schema को बदल देता है। यदि कोई user आधी-अधूरी migrate हुई table पर document submit करता है, तो आपको records को हाथ से ठीक करना पड़ सकता है।

एक बार में एक ही major version पर आगे बढ़ें, और हर चरण के बीच backup लें। आगे बढ़ने से पहले प्रत्येक major version के लिए migration guidance की जाँच करें।

Repository में overrides/compose.migrator.yaml भी शामिल है, जो एक container जोड़ता है। यह container start होने पर bench --site all migrate चलाता है, यदि sites मौजूद हों और MIGRATE_SITES enabled हो, जैसा कि यह default रूप से होता है। यह सुविधाजनक है। इसका मतलब यह भी है कि बदला हुआ tag वाला docker compose up आपकी production database को बिना किसी निगरानी के migrate कर देता है। Business system पर, migrate चलाने का निर्णय उसी दिन सोच-समझकर लें।

ग्राहक रिकॉर्ड रखने वाले सर्वर को सुरक्षित करना

पहली बार लॉगिन करने पर Administrator पासवर्ड बदलें। evaluation compose फ़ाइल में admin पासवर्ड के रूप में दिया गया है, और लोग अक्सर इसे production में भी इस्तेमाल करते रहते हैं।

DB_PASSWORD को example.env में मौजूद 123 से बदलें। यह मान रेंडर की गई ~/gitops/erpnext.yaml फ़ाइल में plain text के रूप में आ जाता है, इसलिए फ़ाइल को chmod 600 करें और इसे किसी भी git repository से दूर रखें। अधिक सुरक्षा के लिए, overrides/compose.mariadb-secrets.yaml पासवर्ड को environment variable के बजाय Docker secret फ़ाइल से पढ़ता है। Docker Compose में env फ़ाइलों और secrets को मैनेज करना में इसके फायदे और नुकसान बताए गए हैं।

केवल वही पब्लिश करें जिसकी आवश्यकता है। HTTPS override के साथ, केवल 80 और 443 ports ही expose होते हैं। डेटाबेस क्लाइंट से कनेक्शन आसान बनाने के लिए db सर्विस में ports मैपिंग न जोड़ें: ऐसा करने से MariaDB सार्वजनिक इंटरनेट पर आ जाएगा। इसके बजाय docker compose --project-name erpnext exec backend bench mariadb का उपयोग करें। होस्ट पर 22, 80 और 443 को अनुमति दें, बाकी को ब्लॉक करें, और प्रदाता के अलग नेटवर्क फ़ायरवॉल की भी जाँच करें।

System Manager भूमिका वाले प्रत्येक खाते के लिए System Settings में two-factor authentication चालू करें। यह भूमिका System Settings को बदल सकती है, इसलिए इसे सुविधा के बजाय एक administrator खाते के रूप में देखें। यदि आप कई self-hosted ऐप्स चलाते हैं, तो प्रति ऐप एक और पासवर्ड रखने के बजाय self-hosted single sign-on प्रदाता के रूप में Authentik का उपयोग करना बेहतर है।

होस्ट को पैच करें और kernel अपडेट के लिए रीबूट करें। इस पर निर्भर रहने से पहले कि स्टैक वापस आ जाएगा, प्रत्येक सर्विस पर restart पॉलिसी के लिए रेंडर की गई फ़ाइल की जाँच करें, क्योंकि इसके बिना स्टैक रीबूट के बाद बंद ही रहेगा। रीबूट के बाद Docker Compose स्टैक को दोबारा शुरू करना में systemd पक्ष को कवर किया गया है।

जब ERPNext एक VPS पर पर्याप्त न रहे

एक VPS लंबे समय तक एक छोटी कंपनी का काम संभाल सकता है। जब यह क्षमता कम पड़ने लगे, तो ये संकेत मिलते हैं:

  • Background jobs जमा होने लगते हैं, जिससे emails और imports मिनटों या घंटों की देरी से पहुँचते हैं।
  • docker inspect कंटेनरों में "OOMKilled": true या exit code 137 दिखाई देता है।
  • जो reports दो सेकंड में तैयार होती थीं, वे अब तीस सेकंड लेती हैं और MariaDB वह process है जो CPU का उपयोग कर रही है।
  • Backups इतने लंबे समय तक चलते हैं कि वे अगले निर्धारित run के साथ overlap करने लगते हैं।

सबसे पहले MariaDB को ऐसे resources दें जिन्हें वह साझा न करे, क्योंकि database और Python workers एक ही memory के लिए प्रतिस्पर्धा करते हैं और buffer pool को अधिक memory की आवश्यकता होती है। एक बड़ा application server लोगों की अपेक्षा के अनुरूप कम मदद करता है। database को Docker में या host पर चलाना इस निर्णय को कवर करता है, और Docker Compose में memory limits सेट करना एक कंटेनर को दूसरों के संसाधन छीनने से रोकता है, जब तक आप इसे व्यवस्थित कर रहे हों।

इसके बाद, web capacity बढ़ाने के बजाय queue workers जोड़ें। ERPNext का धीमा काम background का काम होता है: report generation और bulk imports। अधिक workers को CPU और memory headroom की आवश्यकता होती है; पहले से ही भरे हुए VPS में और कंटेनर जोड़ने से capacity नहीं बढ़ती।

FAQ

ERPNext को VPS पर कितनी RAM की आवश्यकता होती है?

मूल्यांकन के लिए, 4 GB RAM और 2 vCPU से शुरुआत करें। दैनिक उपयोग करने वाली कंपनी के लिए, 8 GB RAM, 4 vCPU और 100 GB SSD की योजना बनाएँ। मेमोरी पर दबाव होने पर kernel का out of memory killer containers को बंद कर सकता है, जिसे docker inspect, "OOMKilled": true और exit code 137 के रूप में रिपोर्ट करता है। ये केवल शुरुआती बिंदु हैं, सटीक माप नहीं, इसलिए पहले महीने के दौरान अपने मेमोरी उपयोग पर नज़र रखें।

क्या मैं production में pwd.yml चला सकता हूँ?

नहीं। प्रोजेक्ट का README इसे केवल अल्पकालिक मूल्यांकन के लिए बताता है और स्पष्ट करता है कि आप इसमें custom apps इंस्टॉल नहीं कर सकते। MariaDB, Redis और HTTPS overrides के साथ compose.yaml का उपयोग करें, उन्हें docker compose config के साथ एक ही फाइल में render करें और उस फाइल को चलाएँ।

मेरी ERPNext साइट बनाने के तुरंत बाद ही unreachable क्यों है?

Frontend डिफ़ॉल्ट रूप से HTTP Host header से चुनता है कि कौन सी साइट serve करनी है, इसलिए ब्राउज़र में साइट का नाम डोमेन से मेल खाना चाहिए। erpnext के रूप में बनाई गई साइट erp.example.com पर serve नहीं होती है। या तो डोमेन को नाम के रूप में उपयोग करके साइट बनाएँ, या env फाइल में FRAPPE_SITE_NAME_HEADER को साइट के नाम पर सेट करें, compose फाइल को फिर से 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 करने पर stored integration passwords को decrypt नहीं किया जा सकेगा, जो Encryption key is invalid! Please check site_config.json के रूप में सामने आता है।

मैं अपने डेटा को नुकसान पहुँचाए बिना ERPNext को अपग्रेड कैसे करूँ?

--with-files के साथ backup लें, maintenance mode चालू करें, अपनी env फाइल में ERPNEXT_VERSION बदलें, compose फाइल को फिर से render करें, pull करें, stack को up करें, फिर bench --site erp.example.com migrate चलाएँ और maintenance mode बंद कर दें। एक बार में एक ही major version पर आगे बढ़ें और पहले release notes पढ़ें, क्योंकि migrate बिना किसी undo के schema और document डेटा को फिर से लिख देता है। Roll back करने का अर्थ है शुरुआत में लिए गए backup को restore करना।

क्या यह लेख उपयोगी था?