SSD Nodes Learn Hosting plans →
मार्गदर्शक Matt Connorद्वारे Matt Connor

VPS वर Docker वापरून ERPNext कसे इन्स्टॉल करावे

Docker वापरून VPS वर ERPNext सेटअप करण्याची पूर्ण माहिती. यात अकरा कंटेनर स्टॅक, TLS कॉन्फिगरेशन, ईमेल सेटिंग्ज आणि बॅकअप रिस्टोर करण्याच्या अचूक पद्धती सविस्तर दिल्या आहेत.

तुम्ही काय चालवणार आहात

VPS वर ERPNext self-host करणे हे एक ऑपरेशन्सचे काम आहे, केवळ एका कमांडने होणारे इन्स्टॉलेशन नाही. अधिकृत Docker Compose स्टॅक मध्ये अकरा कंटेनर्स आहेत आणि त्यात तुमचा जनरल लेजर (general ledger) आणि ग्राहकांचे रेकॉर्ड्स असतात. यामुळे खालील सर्व गोष्टींसाठी मानके वाढतात: जोपर्यंत तुम्ही बॅकअप रिस्टोर करून पाहत नाही, तोपर्यंत तो बॅकअप नसतो आणि अनपिन (unpinned) केलेले इमेज टॅग म्हणजे कधीही होऊ शकणारे स्कीमा मायग्रेशन आहे.

या मार्गदर्शिकेत काही नावे वारंवार येतील. ERPNext हे बिझनेस ॲप्लिकेशन आहे. Frappe हे त्याखालील Python फ्रेमवर्क आहे. Bench हे कमांड लाईन टूल आहे जे साइट्सचे व्यवस्थापन करते आणि ते आधीच कंटेनर्समध्ये इन्स्टॉल केलेले असते. एक site म्हणजे एक टेनंट: एक MariaDB डेटाबेस आणि अपलोड केलेल्या फाइल्सची एक डिरेक्टरी. येथील जवळजवळ प्रत्येक कमांड bench ही backend कंटेनरच्या आत एका विशिष्ट साइटसाठी चालवली जाते.

हे मार्गदर्शक frappe_docker रिपॉझिटरीचा वापर करते, जी या प्रकल्पाद्वारे राखली जाणारी डिप्लॉयमेंट आहे. खालील प्रत्येक कमांड ऑगस्ट 2026 मध्ये त्या रिपॉझिटरीच्या संदर्भात तपासली गेली आहे. जर Docker Compose तुमच्यासाठी नवीन असेल, तर VPS वर Docker Compose चालवणे या विषयावर या मार्गदर्शिकेसाठी आवश्यक असलेली पूर्वतयारी दिली आहे.

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 पासून सुरुवात करा. हा मूल्यमापन स्तर आहे. हे प्रारंभिक अंदाज आहेत; या मार्गदर्शिकेतील मोजमाप नाहीत. तुमच्या दस्तऐवजांच्या प्रमाणावर प्रत्यक्ष आवश्यकता ठरते. शेवटची ओळ प्रकाशित केलेली किमान आवश्यकता नाही. ती अधिक memory headroom देते; memory कधीच संपणार नाही याची हमी देत नाही.

लहान plans बाबत स्वतःशी स्पष्ट रहा. 1 GB किंवा 2 GB VPS मध्ये दहा दीर्घकाळ चालणारे containers, MariaDB चा buffer pool आणि report तयार करणारा Python worker यांच्यासाठी फारच कमी headroom उरतो. Memory pressure आल्यास kernel out of memory killer एखादा container थांबवू शकतो आणि त्यावरील docker inspect नंतर exit code 137 सह "OOMKilled": true दाखवतो. कामाच्या मध्यावर थांबवला गेलेला worker submitted document चे background work अर्धवट ठेवतो.

दररोज ERPNext वापरणाऱ्या कंपनीसाठी 8 GB RAM, 4 vCPU आणि 100 GB SSD यांनुसार नियोजन सुरू करा. त्यानंतर तुमच्या workload ची चाचणी घ्या. RAM सर्वप्रथम संपते. Disk लोकांच्या अपेक्षेपेक्षा जलद भरते, कारण प्रत्येक attachment आणि प्रत्येक local backup database असलेल्या त्याच volume वर साठवला जातो.

अकरा containers आणि प्रत्येकाचे कार्य

Stack सुरू झाल्यानंतर आणि दहा containers चालू असताना docker compose ps चालवा. आणखी एक container, configurator, आपले काम एकदाच करून बंद होते. त्यामुळे एकूण संख्या अकरा होते.

  • backend gunicorn अंतर्गत Frappe application चालवतो. bench येथे असतो.
  • frontend nginx आहे. तो static assets उपलब्ध करून देतो आणि इतर सर्व विनंत्या backend कडे पाठवतो.
  • queue-short आणि queue-long हे RQ (Redis Queue) workers आहेत. ते outgoing email, imports आणि report builds यांसारखी background jobs चालवतात.
  • scheduler वेळेवर चालणारी jobs सुरू करतो. यामध्ये scheduled reports आणि auto repeat documents समाविष्ट आहेत.
  • websocket हा browser मधील live updates साठीचा socket.io process आहे.
  • db MariaDB आहे.
  • redis-cache आणि redis-queue हे दोन स्वतंत्र Redis instances आहेत. एक cache साठी आणि दुसरा job queue साठी वापरला जातो.
  • proxy हा HTTPS override द्वारे जोडलेला Traefik आहे. तो ports 80 आणि 443 हाताळतो आणि certificates मिळवतो.

ही विभागणी समजून घेणे उपयुक्त आहे, कारण कोणता log तपासायचा हे त्यावरून कळते. Email अडकला असल्यास ती queue worker ची समस्या आहे. त्यामुळे docker compose logs -f queue-short ही योग्य command आहे. एखादे page लोड होते, पण त्याचा notification badge कधीच update होत नसेल, तर ती websocket ची समस्या आहे. यापैकी कोणत्याही समस्येसाठी backend चे logs वाचल्यास अनावश्यक वेळ जातो.

production compose files वापरून install करा, demo वापरू नका

Repository मध्ये pwd.yml दिलेले आहे आणि README मध्ये याबाबत स्पष्ट सूचना आहे: "This setup is intended for short-lived evaluation only. You will not be able to install custom apps to this setup." ERPNext चे काही तास मूल्यांकन करण्यासाठी ते वापरा. त्यावर कंपनीचे production कामकाज चालवू नका.

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 image tag निश्चित करते. उदाहरणातील file मध्ये DB_PASSWORD हे 123 म्हणून दिलेले आहे. SITES_RULE हा Traefik routing rule आहे आणि LETSENCRYPT_EMAIL ACME account email देते. Let's Encrypt ने June 4, 2025 रोजी expiration notification emails बंद केली. त्यामुळे certificate expiry स्वतंत्रपणे monitor करा.

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

आता एक compose file render करा आणि ती सुरू करा.

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 कोणतीही सेवा सुरू करत नाही. ते base file ला override files सोबत merge करते आणि प्रत्येक variable ची value आधीच भरलेला निकाल दाखवते. त्यानंतर ती rendered file चालवा. हा अतिरिक्त टप्पा उपयुक्त आहे: चालू stack एका file मध्ये वाचता येतो. त्यामुळे कोणी env file संपादित केले किंवा repository pull केली तरी तो तुमच्या नियंत्रणाखाली बदलत नाही. अनेक Docker Compose files कशा merge होतात यामध्ये override rules सविस्तर स्पष्ट केले आहेत.

COMPOSE_FILE export केल्यावर खालील commands मध्ये rendered file वापरली जाते. प्रत्येक नवीन shell मध्ये ते पुन्हा करा; cron मध्ये -f ~/gitops/erpnext.yaml स्पष्टपणे पास करा.

db सुरू होण्याची आणि configurator बंद होण्याची प्रतीक्षा करा. यासाठी काही सेकंद लागतात. त्यानंतर 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

ते तपासा:

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

list-apps ने frappe आणि erpnext यांच्या versions दाखवाव्यात. निरोगी ps मध्ये running state मधील दहा services दिसतात आणि restarting मधील एकही service दिसत नाही.

येथे दोन समस्या वारंवार येतात. --mariadb-user-host-login-scope=% नवीन site च्या database user साठी wildcard host scope देते. त्यामुळे Docker ने app container ला वेगळा address दिला तरी तो user login करू शकतो. हे न दिल्यास Frappe user ला सध्याच्या connecting host पुरते मर्यादित करते. App container Docker network वरून MariaDB पर्यंत पोहोचतो. त्यामुळे तो remote host म्हणून जोडला जातो आणि localhost पुरता मर्यादित database user तेथून login करू शकत नाही. हा पर्याय site च्या database user मध्ये बदल करतो; root account मध्ये नाही. % scope मुळे MariaDB पर्यंत पोहोचू शकणाऱ्या कोणत्याही host कडून connections स्वीकारले जातात. त्यामुळे database private Docker network वर ठेवा.

दुसरी समस्या site name ची आहे. By default, frontend कोणती site serve करायची हे HTTP Host header वरून ठरवतो. त्यामुळे erpnext नावाने तयार केलेली site erp.example.com वर उपलब्ध होत नाही, जरी दोन्ही अस्तित्वात असल्या तरी. वर दाखवल्याप्रमाणे site ला domain नुसार नाव द्या किंवा env file मध्ये FRAPPE_SITE_NAME_HEADER ची value site name सेट करा आणि compose file पुन्हा render करा.

HTTPS आणि ते कार्यन्वित होण्यापूर्वी आवश्यक अटी

compose.https.yaml ओव्हरराइड Traefik ला पोर्ट 443 वर चालवते, पोर्ट 80 वरील ट्रॅफिक तिथे रिडायरेक्ट करते आणि Let's Encrypt कडून प्रमाणपत्रे मिळवते. TLS (transport layer security) मुळे इनव्हॉइस आणि सेशन कुकीज नेटवर्कवर प्लेन टेक्स्ट स्वरूपात उघड होत नाहीत.

दोन गोष्टी पूर्ण झाल्याशिवाय कोणतेही प्रमाणपत्र जारी केले जात नाही. erp.example.com साठीचा DNS A record आधीच VPS कडे निर्देशित असावा. पोर्ट 80 आणि 443 इंटरनेटवरून प्रवेशयोग्य असावेत, कारण Let's Encrypt पोर्ट 80 वर HTTP-01 चॅलेंजद्वारे तुम्ही त्या डोमेनचे नियंत्रण करत आहात याची खात्री करते. तुमच्या सर्व्हरवरील फायरवॉलसोबतच तुमच्या क्लाउड प्रोव्हायडरची नेटवर्क फायरवॉलही तपासा. ही दोन्ही स्वतंत्र नियंत्रणे आहेत आणि अनेकदा लोक पॅनेल फायरवॉल तपासण्यास विसरतात.

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

आउटबाउंड ईमेल, अन्यथा invoices सर्व्हरबाहेर जात नाहीत

हा टप्पा बहुतेक ERPNext मार्गदर्शकांमध्ये वगळला जातो. मात्र प्रणाली उपयुक्त ठरेल की नाही हे याच्यावर ठरते. कार्यरत आउटबाउंड मेल नसल्यास कोणतेही invoice ग्राहकापर्यंत पोहोचत नाही, password reset संदेश येत नाही आणि scheduled report वितरित होत नाही. या stack मध्ये mail server समाविष्ट नाही.

VPS वरून port 25 वापरून थेट mail पाठवण्याचा प्रयत्न करू नका. AWS सारखे providers outbound port 25 डीफॉल्टनुसार block करतात. तसेच, फार कमी किंवा कोणताही इतिहास नसलेल्या नव्या sending IP मुळे संदेश reject होण्याचा किंवा spam मध्ये जाण्याचा धोका वाढतो. यापैकी कोणताही परिणाम अपरिहार्य नाही. port 587 वर authenticated relay वापरा आणि आधी provider चे outbound rules तपासा: DigitalOcean Droplets वर ports 25, 465 आणि 587 डीफॉल्टनुसार 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 हे "587" string ऐवजी number म्हणून साठवले जाते. फाइल पुन्हा वाचा आणि त्या दोन values भोवती quotes नाहीत याची खात्री करा:

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

Encrypted password storage साठी outgoing server, login आणि password ही माहिती Email Account screen मध्ये एकत्र configure करा. या screen मधील password field स्वतंत्र mail_password site config key सेट करत नाही.

त्यानंतर प्रत्यक्ष message पाठवा. Sales Invoice तयार करा, तो तुमच्या नियंत्रणाखालील पत्त्यावर email करा आणि त्याच वेळी queue monitor करा:

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

Outgoing 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 देखील reject होण्याचा किंवा spam मध्ये जाण्याचा धोका असतो. संपूर्ण mail path स्वतःच्या नियंत्रणात ठेवायचा असल्यास, self-hosted Mailcow mail server ERP पासून वेगळ्या box वर तुमच्या नियंत्रणातील relay उपलब्ध करून देतो.

प्रत्यक्ष पुनर्संचयित होणारे बॅकअप

फक्त database dump हा ERPNext चा बॅकअप नसतो. Attachments आणि private files या MariaDB मध्ये नसून sites directory मध्ये असतात. फक्त database restore केल्यास अपलोड केलेली प्रत्येक purchase order तुटलेल्या link म्हणून दिसते.

docker compose --project-name erpnext exec backend \
  bench --site erp.example.com backup --with-files

यामुळे sites volume मधील sites/erp.example.com/private/backups मध्ये चार files लिहिल्या जातात:

  • -database.sql.gz dump
  • public files चे -files.tar archive
  • private files चे -private-files.tar archive
  • site config ची -site_config_backup.json copy

चौथी file लोक सहसा टाकून देतात; पण सर्वाधिक समस्या याच्यामुळे निर्माण होतात. त्यात encryption_key असते. Stored passwords encrypt करण्यासाठी Frappe ही key वापरते. यात email account credentials, payment gateway keys आणि प्रत्येक integration secret यांचा समावेश होतो. जुळणाऱ्या key शिवाय database restore केल्यास site नेहमीप्रमाणे load होते; मात्र mail पाठवणे अयशस्वी होते:

frappe.exceptions.ValidationError: Encryption key is invalid! Please check site_config.json

ही चारही files नेहमी एकत्र ठेवा.

यानंतर त्या server च्या बाहेर ठेवा. Volume मधील backup server नष्ट झाल्यावर टिकत नाही. तसेच bench ते काढून टाकते. Default configuration नुसार त्या directory मधील 23 तासांपेक्षा जुन्या backups हटवल्या जातात. Frappe 16.20.0 आणि 15.114.0 पूर्वी हा default 24 तासांचा होता. Site config मधील 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 मधून चालवा. त्यानंतर directory तुमच्या व्यवस्थापनाखाली नसलेल्या ठिकाणी पाठवा. off-site storage वर encrypted restic backups हे यासाठी योग्य साधन आहे. ते upload करण्यापूर्वी backup encrypt करते आणि restic check मुळे repository अजून वाचता येते की नाही हे सिद्ध होते. ERP backup म्हणजे तुमच्या संपूर्ण ledger ची copy आहे. त्यामुळे ती या server व्यतिरिक्त इतर hardware वर, rest ने encrypted स्वरूपात ठेवली पाहिजे.

गरज पडण्यापूर्वी restore तपासा

तपासलेला नसलेला backup म्हणजे केवळ अंदाज. तो त्याच सर्व्हरवरील दुसऱ्या site वर restore करून तपासा; 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>'

backup केलेल्या config मधून 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>'

आता accountant ज्या पद्धतीने तपासेल त्या पद्धतीने restore तपासा. Accounts Receivable report उघडा आणि closing balance live site शी तुलना करा. अलीकडील purchase invoice उघडा आणि त्याचे attachment download करा. login page दिसते, यावरून site योग्यरीत्या restore झाली आहे असे सिद्ध होत नाही.

तपासणी पूर्ण झाल्यावर 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 पुन्हा लिहिते आणि document data मध्येही बदल करू शकते. हे पूर्ववत करण्याची सुविधा नाही. Rollback म्हणजे backup मधून restore करणे; तो docker compose down नाही.

म्हणून tag pin करा. ERPNEXT_VERSION=v16.32.1 हे August 2026 मध्ये repository च्या स्वतःच्या pwd.yml मध्ये pinned असलेले release होते. 2026-11-16 रोजी pwd.yml आणि example.env दोन्हींनी v16.55.0 pin केले होते. तपासणी केल्याशिवाय यापैकी कोणताही number पुढे वापरू नका. सध्याची releases frappe/erpnext releases page वर सूचीबद्ध आहेत. उपलब्ध image tags Docker Hub वर आहेत. ज्या version वर जाणार आहात, त्या 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 संपादित करा. त्यानंतर 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 बदलते. अर्धवट migrate झालेल्या table वर user ने document submit केल्यास records हाताने दुरुस्त करण्याची वेळ येऊ शकते.

एकावेळी एक major version पुढे जा. प्रत्येक टप्प्याच्या आधी backup घ्या. पुढे जाण्यापूर्वी प्रत्येक major version साठी migration guidance तपासा.

Repository मध्ये overrides/compose.migrator.yaml देखील उपलब्ध आहे. Sites अस्तित्वात असतील आणि MIGRATE_SITES enabled असेल, जे default आहे, तर ते सुरू होताना bench --site all migrate चालवणारा container जोडते. हे सोयीचे आहे. परंतु tag बदलल्यास docker compose up तुमच्या production database चे migration कोणाच्याही देखरेखीशिवाय करू शकते. Business system वर migrate चालवणे हा त्या सकाळी घेतलेला जाणीवपूर्वक निर्णय असावा.

Customer records असलेल्या सर्व्हरचे hardening

पहिल्या login वेळी Administrator password बदला. Evaluation compose file मध्ये admin हा password म्हणून दिलेला आहे आणि ही सवय production मध्येही कायम राहते.

example.env मधील 123 ऐवजी DB_PASSWORD वापरा. ही value rendered ~/gitops/erpnext.yaml मध्ये plain text स्वरूपात येते. त्यामुळे chmod 600 file आणि ती कोणत्याही 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 ला जोडणे सोपे व्हावे म्हणून db service साठी ports mapping जोडू नका. त्यामुळे MariaDB public internet वर exposed होतो. त्याऐवजी docker compose --project-name erpnext exec backend bench mariadb वापरा. Host वर 22, 80 आणि 443 ला परवानगी द्या आणि उर्वरित traffic नाकारा. Provider चा स्वतंत्र network firewall देखील तपासा.

System Settings मध्ये System Manager role असलेल्या प्रत्येक account साठी two factor authentication सुरू करा. हा role System Settings बदलू शकतो. त्यामुळे त्याला केवळ सोयीसाठी दिलेला role न मानता administrator account म्हणून हाताळा. अनेक self-hosted apps चालवत असल्यास, प्रत्येक app साठी आणखी एक password ठेवण्यापेक्षा self-hosted single sign-on provider म्हणून Authentik अधिक योग्य आहे.

Host ला patch करा आणि kernel updates साठी reboot करा. Stack पुन्हा सुरू होईल यावर अवलंबून राहण्यापूर्वी rendered file मध्ये प्रत्येक service साठी restart policy आहे का ते तपासा. अशी policy नसलेला stack त्या reboot नंतर बंदच राहतो. reboot नंतर Docker Compose stack पुन्हा सुरू करणे systemd संबंधी माहिती देते.

ERPNext एका VPS वर आरामात चालत नसेल तेव्हा

एक VPS लहान कंपनीच्या गरजा दीर्घकाळ पूर्ण करू शकतो. पुढील लक्षणे दिसू लागल्यास ती क्षमता पुरेशी राहिलेली नसते:

  • Background jobs साचतात. त्यामुळे emails आणि imports काही मिनिटे किंवा काही तास उशिरा पोहोचतात.
  • docker inspect containers मध्ये "OOMKilled": true किंवा exit code 137 असल्याचे दाखवतो.
  • पूर्वी दोन सेकंद लागणारे reports आता तीस सेकंद घेतात आणि CPU वापरणारी process MariaDB असते.
  • Backups इतका वेळ चालतात की एक backup संपण्यापूर्वी पुढील scheduled run सुरू होतो.

सुरुवातीला MariaDB ला इतर सेवांसोबत सामायिक न केलेली resources द्या. 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 आवश्यक असते. आधीच पूर्ण क्षमतेवर चालणाऱ्या 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 म्हणून नोंदवले जाते. हे मोजमाप नसून सुरुवातीचे अंदाज आहेत. त्यामुळे पहिल्या महिन्यात तुमचा प्रत्यक्ष memory वापर monitor करा.

production मध्ये pwd.yml चालवू शकतो का?

नाही. प्रकल्पाच्या README नुसार ते केवळ अल्पकालीन मूल्यांकनासाठी आहे. त्यात custom apps install करता येत नाहीत, असेही README मध्ये नमूद केले आहे. MariaDB, Redis आणि HTTPS overrides सह compose.yaml वापरा. ते docker compose config द्वारे एका फाइलमध्ये render करा आणि ती फाइल चालवा.

site तयार केल्यानंतर लगेच माझी ERPNext site का उपलब्ध होत नाही?

frontend default ने HTTP Host header वरून कोणती site serve करायची ते ठरवतो. त्यामुळे site name browser मधील domain शी जुळले पाहिजे. erpnext नावाने तयार केलेली site erp.example.com वर serve केली जात नाही. Domain हे site name म्हणून वापरून site तयार करा. किंवा env file मध्ये FRAPPE_SITE_NAME_HEADER ला site name सेट करा, 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 सुरू करा. त्यानंतर bench --site erp.example.com migrate चालवा आणि maintenance mode बंद करा. एका वेळी एकच major version पुढे न्या. आधी release notes वाचा, कारण migrate schema आणि document data मध्ये बदल करते आणि हे पूर्ववत करता येत नाही. Rollback करण्यासाठी सुरुवातीला घेतलेला backup restore करा.

हा लेख उपयुक्त होता का?