SSD Nodes Learn Hosting plans →

VPS లో Docker ఉపయోగించి ERPNext ను ఎలా ఇన్‌స్టాల్ చేయాలి?

Docker ద్వారా ERPNext ను మీ VPS లో హోస్ట్ చేసే పద్ధతిని తెలుసుకోండి. 11 కంటైనర్ల స్టాక్, 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 తో ప్రారంభించండి. అదే మూల్యాంకన స్థాయి. ఇవి ఈ guide నుంచి తీసుకున్న కొలతలు కావు; ప్రారంభ విలువలు మాత్రమే. మీ పత్రాల పరిమాణం ఆధారంగా వాస్తవ అవసరం నిర్ణయించబడుతుంది. చివరి వరుస ప్రచురించబడిన కనిష్ఠ అవసరం కాదు. అది 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 చూపిస్తుంది. Job మధ్యలో worker ఆగిపోతే, సమర్పించిన document కు సంబంధించిన background పని సగంలోనే మిగిలిపోతుంది.

ప్రతిరోజూ ERPNext ఉపయోగించే సంస్థ కోసం 8 GB RAM, 4 vCPU మరియు 100 GB SSD చుట్టూ capacity planning ప్రారంభించి, తరువాత మీ workload ను పరీక్షించండి. ముందుగా RAM అయిపోతుంది. Disk ఊహించినదానికంటే వేగంగా పెరుగుతుంది, ఎందుకంటే ప్రతి attachment మరియు ప్రతి local backup database ఉన్న అదే volume లో నిల్వ అవుతుంది.

పదకొండు containers మరియు ప్రతి container చేసే పని

Stack ప్రారంభమై, పది containers నడుస్తున్న తర్వాత docker compose ps ను అమలు చేయండి. మరో container అయిన configurator తన పనిని ఒక్కసారి చేసి exit అవుతుంది. మొత్తం పదకొండు containers అని చెప్పడానికి కారణం ఇదే.

  • 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 Traefik. HTTPS override దీన్ని జోడిస్తుంది. ఇది ports 80 మరియు 443 ను నిర్వహించి certificates ను పొందుతుంది.

ఈ విభజనను తెలుసుకోవడం ఉపయోగకరం. ఏ log ను పరిశీలించాలో ఇది స్పష్టంగా చెబుతుంది. Email queue లో నిలిచిపోతే అది queue worker సమస్య. అందువల్ల docker compose logs -f queue-short సరైన command. Page load అవుతున్నా notification badge ఎప్పుడూ update కాకపోతే అది websocket సమస్య. ఈ రెండు సందర్భాల్లోనూ backend logs ను చదవడం వల్ల సమయం వృథా అవుతుంది.

Production compose files తో install చేయండి, demo తో కాదు

Repository లో pwd.yml అందుబాటులో ఉంటుంది. README దీనిని స్పష్టంగా చెబుతోంది: "ఈ setup తక్కువ కాలం evaluation కోసం మాత్రమే ఉద్దేశించబడింది. ఈ setup కు custom apps install చేయలేరు." ఒక మధ్యాహ్నం 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 image tag ను నిర్దిష్టంగా నిర్ణయిస్తుంది. ఉదాహరణ file లో DB_PASSWORD, 123 గా ఉంటుంది. SITES_RULE Traefik routing rule. LETSENCRYPT_EMAIL ACME account email ను అందిస్తుంది. Let's Encrypt 2025 June 4న 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 చేసి, దాన్ని 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 ఇప్పటికే substituted అయిన ఫలితాన్ని print చేస్తుంది. తరువాత మీరు ఆ rendered file ను run చేస్తారు. ఈ అదనపు దశ ఉపయోగకరంగా ఉంటుంది: running stack ను చదవగలిగే ఒకే file గా ఉంచుతుంది. అందువల్ల ఎవరైనా env file ను edit చేసినప్పుడు లేదా repository ను pull చేసినప్పుడు అది మీ నియంత్రణ లేకుండా మారదు. అనేక Docker Compose files ఎలా merge అవుతాయో override rules ను వివరంగా వివరిస్తుంది.

COMPOSE_FILE export వల్ల కింది commands rendered file ను ఉపయోగిస్తాయి. ప్రతి కొత్త shell లో దీన్ని మళ్లీ అమలు చేయండి. cron లో -f ~/gitops/erpnext.yaml ను స్పష్టంగా pass చేయండి.

db start అయ్యి, configurator exit అయ్యే వరకు వేచి ఉండండి. దీనికి కొన్ని seconds పడుతుంది. తరువాత site ను create చేయండి.

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

list-apps, frappe మరియు erpnext ను వాటి versions తో print చేయాలి. ఆరోగ్యంగా ఉన్న ps లో running state లో పది services కనిపించాలి. restarting state లో ఏ service ఉండకూడదు.

ఇక్కడ రెండు సమస్యలు తరచుగా వస్తాయి. --mariadb-user-host-login-scope=% కొత్త site యొక్క database user కు wildcard host scope ఇస్తుంది. అందువల్ల Docker app container కు వేరే address కేటాయించినా అది login చేయగలదు. ఇది లేకపోతే, Frappe user ను ప్రస్తుత connecting host కు పరిమితం చేస్తుంది. App container Docker network ద్వారా MariaDB ను చేరుతుంది. అందువల్ల అది remote host గా వస్తుంది. localhost కు పరిమితమైన database user అక్కడి నుంచి login చేయలేడు. ఈ option site యొక్క database user ను మార్చుతుంది, root account ను కాదు. % scope MariaDB ను చేరగల ఏ host నుంచైనా connections ను అనుమతిస్తుంది. కాబట్టి database ను private Docker network లో ఉంచండి.

రెండవ సమస్య site name. Default గా frontend ఏ site ను serve చేయాలో HTTP Host header ఆధారంగా ఎంచుకుంటుంది. అందువల్ల erpnext గా create చేసిన site, రెండూ ఉన్నప్పటికీ erp.example.com వద్ద reachable కాదు. పై విధంగా domain పేరుతో site ను name చేయండి. లేదా env file లో FRAPPE_SITE_NAME_HEADER ను site name కు set చేసి compose file ను మళ్లీ render చేయండి.

HTTPS మరియు అది పనిచేయడానికి ముందు ఉండాల్సిన పరిస్థితులు

compose.https.yaml ఓవర్‌రైడ్ Traefik ను 443 పోర్ట్‌పై నడుపుతుంది, 80 పోర్ట్‌ను దానికి మళ్ళిస్తుంది (redirect), మరియు Let's Encrypt నుండి సర్టిఫికేట్‌లను అభ్యర్థిస్తుంది. ఇన్‌వాయిస్ మరియు సెషన్ కుక్కీలు నెట్‌వర్క్‌లో ప్లెయిన్ టెక్స్ట్ రూపంలో వెళ్లకుండా TLS (transport layer security) కాపాడుతుంది.

రెండు విషయాలు నిజమైతేనే సర్టిఫికేట్ జారీ చేయబడుతుంది. erp.example.com కోసం DNS A రికార్డ్ ఇప్పటికే 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 instance ఎలా వాడాలో ఇది చూపిస్తుంది, ఇది 443 పోర్ట్ కోసం పోటీ పడకుండా ప్రాక్సీని పంచుకోవడానికి సహాయపడుతుంది. ఇలాంటి సర్వర్‌పై ఉండే రెండవ అప్లికేషన్ తరచుగా కస్టమర్లకు సంబంధించినది అయి ఉంటుంది, మరియు self-hosted Chatwoot support desk అదే ప్రాక్సీ వెనుక ఉంటుంది, తద్వారా ఇన్‌వాయిస్‌లపై పనిచేసే వారు కస్టమర్ ఈమెయిల్ మరియు చాట్‌లకు కూడా ఒకే చోట సమాధానం ఇవ్వగలరు.

బయటకు పంపే ఇమెయిల్, లేకపోతే invoices server ను దాటవు

చాలా ERPNext మార్గదర్శకాలు దాటవేసే దశ ఇదే. వ్యవస్థ ఉపయోగకరంగా ఉంటుందా లేదా అన్నది దీనిపైనే ఆధారపడి ఉంటుంది. బయటకు పంపే ఇమెయిల్ పనిచేయకపోతే ఏ invoice కూడా customer కు చేరదు, password reset ఇమెయిల్ అందదు, scheduled report కూడా పంపబడదు. ఈ stack లో mail server లేదు.

VPS నుంచి port 25 ద్వారా నేరుగా mail పంపడానికి ప్రయత్నించవద్దు. AWS వంటి providers outbound port 25 ను default గా block చేస్తాయి. అదనంగా, చరిత్ర లేని లేదా చాలా తక్కువ చరిత్ర ఉన్న కొత్త sending IP వల్ల 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 ను "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 చేయండి. దాని password field ప్రత్యేకమైన mail_password site config key ను set చేయదు.

తర్వాత నిజమైన message పంపండి. ఒక Sales Invoice సృష్టించి, మీ నియంత్రణలో ఉన్న address కు దాన్ని email చేయండి. అదే సమయంలో queue ను ఇలా పరిశీలించండి:

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

Outgoing mail ఒక background job. అందువల్ల చేరని message సాధారణంగా browser లో error గా కాకుండా ఆ log లో failed job గా కనిపిస్తుంది. పంపే domain కోసం SPF (sender policy framework) మరియు DKIM (domainkeys identified mail) records కూడా publish చేయండి. తరువాత DMARC policy జోడించండి. Authentication లేకపోతే, సాంకేతికంగా సరైన invoice కూడా rejection లేదా spam placement కు గురయ్యే ప్రమాదం ఉంది. మొత్తం మార్గాన్ని మీరే నిర్వహించాలనుకుంటే, మీరు స్వయంగా నిర్వహించే Mailcow mail server ERP నుంచి వేరే box పై మీ నియంత్రణలో ఉండే relay ను అందిస్తుంది.

నిజంగా restore చేయగల Backups

Database dump మాత్రమే ERPNext కు backup కాదు. Attachments మరియు private files MariaDB లో కాకుండా sites directory లో ఉంటాయి. Database ను మాత్రమే restore చేస్తే, upload చేసిన ప్రతి purchase order broken 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 ను చాలామంది తొలగిస్తారు. సమస్యకు కారణమయ్యేది కూడా అదే. Stored passwords ను encrypt చేయడానికి Frappe ఉపయోగించే encryption_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 గా ఆ directory లో 23 గంటలకంటే పాత backups ను తొలగిస్తుంది. Frappe 16.20.0 మరియు 15.114.0 కి ముందు ఈ default 24 గంటలు. Site config లోని keep_backups_for_hours key ఈ వ్యవధిని override చేస్తుంది.

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

దీనిని cron నుంచి అమలు చేసి, directory ను మీరు administer చేయని మరో ప్రదేశానికి పంపండి. off-site storage కు encrypted restic backups దీనికి సరైన tool. ఇది upload కు ముందు encrypt చేస్తుంది. restic check repository ను ఇప్పటికీ చదవగలమని నిర్ధారిస్తుంది. ERP backup మీ మొత్తం ledger యొక్క copy. అందువల్ల దానిని ఈ server కాకుండా వేరే hardware పై at rest encrypted గా ఉంచాలి.

మీకు అవసరం రాకముందే restore ను పరీక్షించండి

పరీక్షించని backup ఒక అంచనా మాత్రమే. అదే box లోని రెండో site కు restore చేసి పరీక్షించండి; 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 చేసిన 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 పనిచేస్తోందని మాత్రమే నిరూపించదు.

పరీక్ష పూర్తయిన తర్వాత test site ను తొలగించండి:

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

ERPNext కోసం version pinning ఎందుకు మరింత ముఖ్యమైనది

స్థిరమైన siteలో pin చేయని image tag అనుకోని restart కు దారితీస్తుంది. ERPNextలో అది schema migration కు దారితీస్తుంది. bench migrate database tables ను తిరిగి రాస్తుంది మరియు document data ను కూడా మార్చవచ్చు. దీనికి undo ఉండదు. Rollback అంటే backup నుంచి restore చేయడం, docker compose down కాదు.

కాబట్టి tag ను pin చేయండి. ఆగస్టు 2026లో repository యొక్క స్వంత pwd.yml లో pin చేసిన release ERPNEXT_VERSION=v16.32.1. 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 ను సవరించి, తరువాత 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

migrate నడుస్తున్నప్పుడు schema ను మార్చుతుంది కాబట్టి maintenance mode ముఖ్యమైనది. సగం మాత్రమే migrate అయిన tableపై user document submit చేస్తే, records ను చేతితో సరిచేయాల్సి వస్తుంది.

ఒక్కసారి ఒక major version చొప్పున మాత్రమే ముందుకు వెళ్లండి. ప్రతి దశ మధ్య backup తీసుకోండి. కొనసాగించే ముందు ప్రతి major version కోసం migration guidance ను తనిఖీ చేయండి.

Repository overrides/compose.migrator.yaml ను కూడా అందిస్తుంది. Sites ఉన్నప్పుడు మరియు MIGRATE_SITES enable అయి ఉన్నప్పుడు, ఇది ప్రారంభ సమయంలో bench --site all migrate నడిపే container ను జోడిస్తుంది. ఇది defaultగా enable అయి ఉంటుంది. ఇది సౌకర్యవంతంగా ఉంటుంది. అయితే tag మారిన docker compose up మీ production database ను ఎవరూ పర్యవేక్షించకుండా migrate చేయవచ్చు. Business systemలో migrate నడపడం ఆ ఉదయం మీరు తీసుకున్న నిర్ణయం అయి ఉండాలి.

కస్టమర్ రికార్డులను కలిగి ఉన్న సర్వర్‌ను కఠినంగా భద్రపరచడం

మొదటి login సమయంలో Administrator password ను మార్చండి. Evaluation compose file లో ఆ password గా admin ఉంటుంది. ఈ అలవాటు production లోకీ కొనసాగుతుంది.

example.env లోని 123 విలువను ఉపయోగించకుండా DB_PASSWORD ను మార్చండి. ఆ విలువ 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 నిర్వహణ లో ఈ ఎంపికల ప్రయోజనాలు, పరిమితులు వివరించబడ్డాయి.

అవసరమైన ports ను మాత్రమే publish చేయండి. HTTPS override ఉపయోగించినప్పుడు 80 మరియు 443 మాత్రమే బయటకు expose అవుతాయి. Database client సులభంగా connect కావడానికి db service కు ports mapping జోడించవద్దు. అలా చేస్తే MariaDB public internet లోకి expose అవుతుంది. బదులుగా docker compose --project-name erpnext exec backend bench mariadb ఉపయోగించండి. Host పై 22, 80 మరియు 443 ను allow చేసి, మిగతావన్నీ deny చేయండి. Provider యొక్క ప్రత్యేక network firewall ను కూడా తనిఖీ చేయండి.

System Manager role ఉన్న ప్రతి account కోసం System Settings లో two factor authentication ను ప్రారంభించండి. ఆ role తో System Settings మార్చవచ్చు. అందువల్ల దాన్ని convenience account గా కాకుండా administrator account గా పరిగణించండి. మీరు అనేక self-hosted apps నడిపితే, ప్రతి app కు మరో password ఉంచడం కంటే self-hosted single sign-on provider గా Authentik మెరుగైన ఎంపిక.

Host కు patches వర్తింపజేసి, kernel updates కోసం reboot చేయండి. Stack తిరిగి ప్రారంభమవుతుందని ఆధారపడే ముందు, ప్రతి service కు rendered file లో restart policy ఉందో తనిఖీ చేయండి. అలాంటి policy లేని stack ఆ reboot తర్వాత down స్థితిలోనే ఉంటుంది. reboot తర్వాత Docker Compose stack ను మళ్లీ ప్రారంభించేలా చేయడం systemd భాగాన్ని వివరిస్తుంది.

ఒక VPSపై ERPNext సౌకర్యవంతంగా నడవనప్పుడు

ఒక VPS చిన్న కంపెనీ అవసరాలను చాలా కాలం నిర్వహించగలదు. అది ఇక సరిపోకపోవడానికి కనిపించే సంకేతాలు ఇవి:

  • Background jobs పేరుకుపోతాయి. అందువల్ల emails మరియు imports కొన్ని నిమిషాలు లేదా గంటలు ఆలస్యంగా వస్తాయి.
  • docker inspect reports ను "OOMKilled": true లేదా exit code 137 తో చూపిస్తుంది.
  • రెండు సెకన్లలో పూర్తయ్యే reports కు ముప్పై సెకన్లు పడతాయి. MariaDB CPUని ఎక్కువగా ఉపయోగించే processగా ఉంటుంది.
  • Backups పూర్తవడానికి ఎక్కువ సమయం పడుతుంది. అందువల్ల ఒక backup, తదుపరి scheduled run ప్రారంభమయ్యే సమయానికి ఇంకా నడుస్తూనే ఉంటుంది.

ముందుగా MariaDBకి ఇతర సేవలతో పంచుకోని resources ఇవ్వండి. Database మరియు Python workers ఒకే memory కోసం పోటీ పడతాయి. ఎక్కువ memory అవసరమయ్యే భాగం buffer pool. పెద్ద application server ఉపయోగపడుతుంది, కానీ చాలామంది ఆశించేంతగా కాదు. database ను Dockerలో లేదా hostపై నడపడం ఈ నిర్ణయాన్ని వివరిస్తుంది. మీరు ఈ మార్పు చేస్తున్నప్పుడు Docker Composeలో memory limits సెట్ చేయడం ఒక container మిగిలిన వాటి 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లో ఇది తక్కువకాల evaluation కోసం మాత్రమే ఉద్దేశించబడిందని, ఇందులో custom appsను install చేయలేరని పేర్కొన్నారు. MariaDB, Redis మరియు HTTPS overridesతో కూడిన compose.yamlను ఉపయోగించండి. వాటిని docker compose configతో ఒకే fileగా render చేసి, ఆ fileను నడపండి.

siteని సృష్టించిన వెంటనే నా ERPNext site ఎందుకు అందుబాటులో ఉండదు?

డిఫాల్ట్‌గా frontend ఏ siteను serve చేయాలో HTTP Host header ఆధారంగా ఎంచుకుంటుంది. అందువల్ల 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లో ఏమేమి ఉండాలి?

నాలుగు filesను కలిపి ఉంచాలి: -database.sql.gz dump, -files.tar మరియు -private-files.tar archives, అలాగే -site_config_backup.json config copy. bench --site erp.example.com backup --with-filesను నడిపితే ఈ నాలుగు 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ను enable చేయండి. env fileలో ERPNEXT_VERSIONను మార్చండి. Compose fileను మళ్లీ render చేసి, imagesను pull చేసి, stackను ప్రారంభించండి. తరువాత bench --site erp.example.com migrateను నడిపి maintenance modeను disable చేయండి. ఒక్కసారి ఒక major version మాత్రమే మార్చండి. ముందుగా release notes చదవండి. ఎందుకంటే migrate schema మరియు document dataను తిరిగి మార్చే అవకాశం లేకుండా rewrite చేస్తుంది. వెనక్కి వెళ్లాలంటే ప్రారంభంలో తీసుకున్న backupను restore చేయాలి.

ఈ వ్యాసం ఉపయోగకరంగా ఉందా?