VPS-ல் Docker மூலம் ERPNext-ஐ நிறுவுவது எப்படி?
VPS-ல் ERPNext-ஐ Docker மூலம் நிறுவும் முறையை அறிக. 11 containers மேலாண்மை, TLS அமைப்பு, மின்னஞ்சல் கட்டமைப்பு மற்றும் தரவு மீட்பு குறித்த விரிவான வழிகாட்டி இங்கே உள்ளது.
நீங்கள் இயக்கப்போகும் மென்பொருள் குறித்த விளக்கம்
VPS-ல் ERPNext-ஐ self-host செய்வது என்பது ஒரு செயல்பாட்டுப் பணி (operations job), இது ஒரே கட்டளையில் முடிந்துவிடும் நிறுவல் அல்ல. அதிகாரப்பூர்வ Docker Compose stack-ல் பதினொரு containers உள்ளன, இது உங்கள் பொதுப் பேரேடு (general ledger) மற்றும் வாடிக்கையாளர் பதிவுகளைக் கொண்டுள்ளது. இது கீழே உள்ள அனைத்திற்கும் தரநிலையை உயர்த்துகிறது: நீங்கள் மீட்டமைக்கும் வரை ஒரு backup என்பது உண்மையான backup ஆகாது, மேலும் image tag-ஐ pin செய்யாமல் விடுவது என்பது எப்போது வேண்டுமானாலும் நிகழக்கூடிய schema migration சிக்கலுக்கு வழிவகுக்கும்.
இந்த வழிகாட்டி முழுவதும் சில பெயர்கள் மீண்டும் மீண்டும் வரும். ERPNext என்பது வணிகப் பயன்பாட்டு மென்பொருள் (business application). Frappe என்பது அதன் அடிப்படையிலான Python framework ஆகும். Bench என்பது sites-ஐ நிர்வகிக்கும் command line கருவி, இது ஏற்கனவே containers-க்குள் நிறுவப்பட்டிருக்கும். ஒரு site என்பது ஒரு tenant ஆகும்: ஒரு MariaDB database மற்றும் பதிவேற்றப்பட்ட கோப்புகளைக் கொண்ட ஒரு directory. இங்கே உள்ள பெரும்பாலான கட்டளைகள் bench மூலம் backend container-க்குள் ஒரு குறிப்பிட்ட site-க்காக இயக்கப்படுகின்றன.
இந்த வழிகாட்டி frappe_docker repository-ஐப் பயன்படுத்துகிறது, இது அந்தத் திட்டத்தால் பராமரிக்கப்படும் deployment ஆகும். கீழே உள்ள ஒவ்வொரு கட்டளையும் ஆகஸ்ட் 2026-ல் அந்த repository-க்கு எதிராகச் சரிபார்க்கப்பட்டது. Docker Compose உங்களுக்குப் புதியது என்றால், VPS-ல் Docker Compose-ஐ இயக்குதல் என்ற பகுதி இந்த வழிகாட்டிக்குத் தேவையான அடிப்படைத் தகவல்களை வழங்குகிறது.
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 உடன் தொடங்கவும். இதுவே மதிப்பீட்டு நிலை (evaluation tier). இவை தொடக்கப் புள்ளிகள் மட்டுமே; இந்த வழிகாட்டியில் உள்ள அளவீடுகள் அல்ல. உங்கள் ஆவணங்களின் அளவே உண்மையான தேவையைத் தீர்மானிக்கும். கடைசி வரிசையில் குறிப்பிடப்பட்டுள்ளவை குறைந்தபட்சத் தேவைகள் அல்ல. அவை கூடுதல் நினைவக வசதியை (memory headroom) மட்டுமே வழங்குகின்றன, நினைவகம் தீர்ந்து போகாது என்பதற்கு உத்தரவாதம் அல்ல.
குறைந்த திறன் கொண்ட திட்டங்களைப் பயன்படுத்தும்போது கவனமாக இருக்கவும். 1 GB அல்லது 2 GB VPS-ல், பத்து நீண்ட நேரம் இயங்கும் containers, MariaDB buffer pool மற்றும் அறிக்கை தயாரிக்கும் Python worker ஆகியவற்றை இயக்குவதற்குப் போதிய இடவசதி இருக்காது. நினைவக அழுத்தம் ஏற்படும்போது, kernel-ன் out of memory killer ஒரு container-ஐ நிறுத்தக்கூடும். அப்போது docker inspect-ஐச் சரிபார்த்தால், exit code 137 உடன் "OOMKilled": true பிழை காட்டப்படும். ஒரு பணி பாதியில் இருக்கும்போது worker நிறுத்தப்பட்டால், சமர்ப்பிக்கப்பட்ட ஆவணத்தின் பின்னணி வேலைகள் முழுமையடையாமல் நின்றுவிடும்.
தினமும் ERPNext-ஐப் பயன்படுத்தும் நிறுவனங்களுக்கு, 8 GB RAM, 4 vCPU மற்றும் 100 GB SSD ஆகியவற்றுடன் திட்டமிடத் தொடங்கி, உங்கள் பணிச்சுமையைச் சோதிக்கவும். பொதுவாக RAM தான் முதலில் தீர்ந்துவிடும். ஒவ்வொரு இணைப்பும் (attachment) மற்றும் உள்ளூர் backup-களும் database இருக்கும் அதே volume-ல் சேமிக்கப்படுவதால், வட்டு (disk) எதிர்பார்ப்பதை விட வேகமாக நிரம்பும்.
பதினொரு containers மற்றும் ஒவ்வொன்றின் செயல்பாடுகள்
Stack இயங்கத் தொடங்கிய பிறகு, பத்து containers இயங்கிக்கொண்டிருக்கும்போது docker compose ps-ஐ இயக்கவும். மேலும் ஒன்று, configurator, தனது பணியை ஒருமுறை செய்துவிட்டு வெளியேறிவிடும்; இதனால்தான் மொத்தம் பதினொரு containers எனப்படுகிறது.
backend, gunicorn-ன் கீழ் Frappe application-ஐ இயக்குகிறது.benchஇங்குதான் இயங்குகிறது.frontendஎன்பது nginx ஆகும். இது static assets-ஐ வழங்கி, மற்ற அனைத்தையும் backend-க்கு அனுப்புகிறது.queue-shortமற்றும்queue-longஆகியவை RQ (Redis Queue) workers ஆகும். இவை மின்னஞ்சல் அனுப்புதல், தரவு இறக்குமதி மற்றும் அறிக்கை தயாரித்தல் போன்ற பின்னணிப் பணிகளைச் செய்கின்றன.scheduler, திட்டமிடப்பட்ட அறிக்கைகள் மற்றும் தானியங்கி ஆவணங்கள் உள்ளிட்ட கால அடிப்படையிலான பணிகளைச் செய்கிறது.websocketஎன்பது browser-ல் நேரடி அப்டேட்களை வழங்கும் socket.io process ஆகும்.dbஎன்பது MariaDB ஆகும்.redis-cacheமற்றும்redis-queueஆகியவை இரண்டு தனித்தனி Redis instances ஆகும்; ஒன்று cache-க்கும் மற்றொன்று job queue-க்கும் பயன்படுகிறது.proxyஎன்பது Traefik ஆகும், இது HTTPS override மூலம் சேர்க்கப்பட்டது. இது 80 மற்றும் 443 ports-ஐக் கையாளுகிறது மற்றும் certificates-ஐப் பெறுகிறது.
இந்தக் கட்டமைப்பைப் புரிந்துகொள்வது அவசியம், ஏனெனில் எந்த log-ஐப் பார்க்க வேண்டும் என்பதை இதுவே தீர்மானிக்கிறது. ஒரு மின்னஞ்சல் சிக்கிக்கொண்டால், அது queue worker தொடர்பான பிரச்சினை, எனவே docker compose logs -f queue-short சரியான கட்டளையாகும். ஒரு பக்கம் சரியாகத் திறந்தும், notification badge அப்டேட் ஆகவில்லை என்றால், அது websocket தொடர்பான பிரச்சினை. இவற்றுக்கு backend logs-ஐப் படிப்பது நேரத்தை வீணடிக்கும் செயலாகும்.
டெமோ கோப்புகளைப் பயன்படுத்தாமல், production compose கோப்புகளைக் கொண்டு நிறுவுதல்
இந்த களஞ்சியம் (repository) pwd.yml-ஐ வழங்குகிறது, மேலும் அதன் README கோப்பில் இது தெளிவாகக் குறிப்பிடப்பட்டுள்ளது: "இந்த அமைப்பு குறுகிய கால மதிப்பீட்டிற்காக மட்டுமே உருவாக்கப்பட்டது. இதில் நீங்கள் தனிப்பயன் செயலிகளை (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 கோப்பைத் திறந்து நான்கு மதிப்புகளை மாற்றவும். ERPNEXT_VERSION என்பது image tag-ஐ நிலைப்படுத்துகிறது. DB_PASSWORD என்பது உதாரணக் கோப்பில் 123 என வழங்கப்பட்டுள்ளது. SITES_RULE என்பது Traefik routing விதியாகும், மேலும் 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 எதையும் தொடங்காது. இது அடிப்படை கோப்பை (base file) மாற்றுகளுடன் (overrides) இணைத்து, அனைத்து மாறிகளும் (variables) மாற்றப்பட்ட பிறகு முடிவை அச்சிடும். நீங்கள் அந்த உருவாக்கப்பட்ட கோப்பை இயக்க வேண்டும். இந்த கூடுதல் படி பயனுள்ளது: இயங்கும் stack என்பது நீங்கள் படிக்கக்கூடிய ஒரே கோப்பாக இருக்கும், எனவே env கோப்பை யாராவது மாற்றும்போதோ அல்லது களஞ்சியத்தை நீங்கள் pull செய்யும்போதோ அது மாறாது. பல Docker Compose கோப்புகள் எவ்வாறு இணைகின்றன என்பது override விதிகளை விரிவாக விளக்குகிறது.
COMPOSE_FILE export கட்டளையானது கீழே உள்ள கட்டளைகளை உருவாக்கப்பட்ட கோப்பைப் பயன்படுத்தச் செய்கிறது. ஒவ்வொரு புதிய 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-appslist-apps கட்டளையானது frappe மற்றும் erpnext ஆகியவற்றின் பதிப்புகளை அச்சிட வேண்டும். ஆரோக்கியமான ps நிலையில், பத்து சேவைகள் running நிலையிலும், எதுவும் restarting நிலையிலும் இருக்கக்கூடாது.
இங்கு பெரும்பாலும் இரண்டு விஷயங்கள் தவறாக நடக்கின்றன. --mariadb-user-host-login-scope=% என்பது புதிய தளத்தின் தரவுத்தளப் பயனருக்கு wildcard host scope-ஐ வழங்குகிறது, இதனால் Docker செயலிக்கு (container) வேறு முகவரியை ஒதுக்கினாலும் அது உள்நுழைய முடியும். இது இல்லையெனில், Frappe பயனரை தற்போதைய இணைக்கும் host-க்கு மட்டுமே கட்டுப்படுத்தும். செயலி கொள்கலன் (app container) Docker பிணையம் வழியாக MariaDB-ஐ அடைகிறது, எனவே அது ஒரு remote host-ஆகவே வரும், மேலும் localhost-க்குக் கட்டுப்படுத்தப்பட்ட தரவுத்தளப் பயனரால் அங்கிருந்து உள்நுழைய முடியாது. இந்த விருப்பம் தளத்தின் தரவுத்தளப் பயனரை மாற்றுகிறது, root கணக்கை அல்ல. % scope, MariaDB-ஐ அணுகக்கூடிய எந்தவொரு host-லிருந்தும் இணைப்புகளை அனுமதிக்கிறது, எனவே தரவுத்தளத்தை private Docker பிணையத்திலேயே வைத்திருக்கவும்.
இரண்டாவது விஷயம் தளத்தின் பெயர். frontend இயல்பாகவே HTTP Host header-லிருந்து எந்தத் தளத்தை வழங்க வேண்டும் என்பதைத் தேர்வு செய்கிறது, எனவே erpnext என உருவாக்கப்பட்ட ஒரு தளம் erp.example.com-ல் அணுக முடியாது, அவை இரண்டும் இருந்தாலும் கூட. தளத்திற்கு டொமைன் பெயரை வைக்கவும், அல்லது env கோப்பில் FRAPPE_SITE_NAME_HEADER-ஐ தளத்தின் பெயருக்கு அமைத்து, compose கோப்பை மீண்டும் உருவாக்கவும்.
HTTPS மற்றும் அது செயல்படுவதற்கு முன்னால் இருக்க வேண்டிய நிபந்தனைகள்
compose.https.yaml override, Traefik-ஐ port 443-ல் இயக்குகிறது, port 80-ஐ அதற்குத் திருப்பி விடுகிறது (redirect), மேலும் Let's Encrypt-லிருந்து certificates-ஐக் கோருகிறது. TLS (transport layer security) என்பதுதான் invoice மற்றும் session cookie போன்ற தகவல்கள் இணையத்தில் plain text-ஆகப் பரிமாறப்படாமல் பாதுகாக்கிறது.
இரண்டு விஷயங்கள் சரியாக இருந்தால் மட்டுமே certificate வழங்கப்படும். erp.example.com-க்கான DNS A record ஏற்கனவே அந்த VPS-ஐச் சுட்டிக்காட்ட வேண்டும். Port 80 மற்றும் 443 இணையத்திலிருந்து அணுகக்கூடியதாக இருக்க வேண்டும், ஏனெனில் Let's Encrypt, port 80-ல் HTTP-01 challenge மூலம் அந்த domain உங்கள் கட்டுப்பாட்டில் இருப்பதை உறுதி செய்கிறது. உங்கள் service provider-ன் network firewall மற்றும் server-ல் உள்ள firewall ஆகிய இரண்டையும் சரிபார்க்கவும். இவை இரண்டும் தனித்தனி கட்டுப்பாடுகள்; பெரும்பாலும் மக்கள் 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) பிழையை வாசிக்கவும். ஒரே server-ல் பிற web apps-ஐ இயக்குகிறீர்களா? ஒரே Traefik instance-ஐப் பல Docker Compose apps-க்கு முன்னால் பயன்படுத்துதல் என்ற பகுதி, port 443-க்காகப் போட்டியிடாமல் proxy-ஐ எவ்வாறு பகிர்ந்துகொள்வது என்பதைக் காட்டுகிறது. இது போன்ற ஒரு server-ல் இரண்டாவது app பெரும்பாலும் வாடிக்கையாளர் சேவைக்காகப் பயன்படுத்தப்படுகிறது, மேலும் self-hosted Chatwoot support desk அதே proxy-க்கு பின்னால் இயங்குகிறது. இதனால் invoice கையாளும் பணியாளர்கள், வாடிக்கையாளர் மின்னஞ்சல் மற்றும் chat-களுக்கும் ஒரே இடத்தில் பதிலளிக்க முடியும்.
வெளியேறும் மின்னஞ்சல், அல்லது invoices பெட்டியை விட்டு வெளியேறவில்லை என்றால்
ERPNext வழிகாட்டிகளில் பெரும்பாலானவை தவிர்க்கும் படிநிலை இதுவாகும்; ஒரு system பயனுள்ளதா என்பதைத் தீர்மானிப்பது இதுவே. வெளியேறும் மின்னஞ்சல் சரியாகச் செயல்படாவிட்டால், எந்தவொரு invoice-ம் வாடிக்கையாளரைச் சென்றடையாது, password reset மின்னஞ்சல் வராது, மற்றும் திட்டமிடப்பட்ட அறிக்கைகளும் (scheduled reports) கிடைக்காது. இந்த stack-ல் mail server எதுவும் இல்லை.
VPS-லிருந்து port 25 வழியாக நேரடியாக மின்னஞ்சல் அனுப்ப முயற்சிக்க வேண்டாம். AWS போன்ற நிறுவனங்கள் outbound port 25-ஐ இயல்பாகவே (by default) முடக்குகின்றன. மேலும், புதிய sending IP-க்கு வரலாறு குறைவாகவோ அல்லது இல்லாமலோ இருப்பதால், மின்னஞ்சல் நிராகரிக்கப்படவோ அல்லது spam folder-க்குச் செல்லவோ வாய்ப்பு அதிகம். இந்த இரண்டு விளைவுகளும் தவிர்க்க முடியாதவை அல்ல. Port 587-ல் authenticated relay-ஐப் பயன்படுத்தவும்; அதற்கு முன் உங்கள் provider-ன் outbound விதிகளைச் சரிபார்க்கவும்: DigitalOcean அதன் Droplets-ல் port 25, 465 மற்றும் 587 ஆகியவற்றை இயல்பாகவே முடக்குகிறது.
ERPNext interface-ல் உள்ள Email Account திரை இதற்கான அங்கீகரிக்கப்பட்ட வழியாகும்; இது password-ஐ encrypted வடிவில் சேமிக்கிறது. நீங்கள் site config-ல் keys-ஐயும் எழுதலாம்:
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-ஐ எண்ணாகச் சேமிக்கிறது. கோப்பை மீண்டும் படித்து, அந்த இரண்டு மதிப்புகளையும் சுற்றி quotes இல்லை என்பதை உறுதிப்படுத்தவும்:
docker compose --project-name erpnext exec backend \
cat sites/erp.example.com/site_config.jsonEncrypted password சேமிப்பிற்கு, outgoing server, login மற்றும் password ஆகியவற்றை Email Account திரையில் ஒன்றாக உள்ளமைக்கவும். அதன் password field, தனித்த mail_password site config key-ஐ அமைக்காது.
பிறகு ஒரு உண்மையான மின்னஞ்சலை அனுப்பவும். ஒரு Sales Invoice-ஐ உருவாக்கி, உங்கள் கட்டுப்பாட்டில் உள்ள ஒரு முகவரிக்கு அதை மின்னஞ்சல் செய்யவும். அனுப்பும்போது queue-ஐக் கவனிக்கவும்:
docker compose --project-name erpnext logs -f queue-shortவெளியேறும் மின்னஞ்சல் ஒரு background job என்பதால், மின்னஞ்சல் வந்து சேரவில்லை என்றால், அது browser-ல் பிழையாகக் காட்டப்படாமல், அந்த log-ல் பொதுவாக failed job-ஆகவே காட்டப்படும். அனுப்பும் domain-க்கு SPF (sender policy framework) மற்றும் DKIM (domainkeys identified mail) பதிவுகளைப் பதிவேற்றவும், பிறகு DMARC policy-ஐச் சேர்க்கவும். முறையான authentication இல்லையென்றால், தொழில்நுட்ப ரீதியாகச் சரியான invoice கூட நிராகரிக்கப்படலாம் அல்லது spam-ஆகக் கருதப்படலாம். முழுப் பாதையையும் நீங்களே நிர்வகிக்க விரும்பினால், self-hosted Mailcow mail server உங்களுக்குக் கட்டுப்பாட்டில் உள்ள relay-ஐ, ERP இருக்கும் server-க்கு வெளியே வேறொரு box-ல் வழங்குகிறது.
மீட்டெடுக்கக்கூடிய காப்புப்பிரதிகள் (Backups)
ERPNext-ஐப் பொறுத்தவரை, database dump மட்டும் ஒரு முழுமையான காப்புப்பிரதி ஆகாது. இணைப்புகள் (attachments) மற்றும் தனிப்பட்ட கோப்புகள் (private files) MariaDB-ல் இல்லை, அவை sites கோப்பகத்தில் (directory) உள்ளன. database-ஐ மட்டும் மீட்டெடுத்தால், பதிவேற்றப்பட்ட அனைத்து கொள்முதல் ஆணைகளும் (purchase orders) உடைந்த இணைப்புகளாகவே காட்டும்.
docker compose --project-name erpnext exec backend \
bench --site erp.example.com backup --with-filesஇது sites volume-க்குள் உள்ள sites/erp.example.com/private/backups கோப்பகத்தில் நான்கு கோப்புகளை உருவாக்குகிறது:
- ஒரு
-database.sql.gzdump - பொதுக் கோப்புகளின்
-files.tarகாப்பகம் (archive) - தனிப்பட்ட கோப்புகளின்
-private-files.tarகாப்பகம் - site config-ன்
-site_config_backup.jsonநகல்
நான்காவது கோப்பைத்தான் பலரும் கவனிக்காமல் விட்டுவிடுவார்கள், அதுவே மிக முக்கியமானது. அதில் encryption_key உள்ளது; இது சேமிக்கப்பட்ட கடவுச்சொற்களை (மின்னஞ்சல் கணக்கு விவரங்கள், payment gateway keys, அனைத்து integration secrets) குறியாக்க (encrypt) Frappe பயன்படுத்தும் திறவுகோல் (key) ஆகும். சரியான திறவுகோல் இல்லாமல் database-ஐ மீட்டெடுத்தால், தளம் சாதாரணமாகத் திறக்கும், ஆனால் மின்னஞ்சல் அனுப்பும்போது பின்வரும் பிழை ஏற்படும்:
frappe.exceptions.ValidationError: Encryption key is invalid! Please check site_config.jsonஇந்த நான்கு கோப்புகளையும் எப்போதும் ஒன்றாகவே வைத்திருங்கள்.
அவற்றை server-லிருந்து வெளியேற்றுங்கள். volume-க்குள் இருக்கும் காப்புப்பிரதி server-ன் அழிவைத் தாங்காது. மேலும், bench தானாகவே அவற்றை நீக்கிவிடும்: இயல்பாகவே, 23 மணிநேரத்திற்கு மேல் பழமையான காப்புப்பிரதிகளை அந்த கோப்பகத்திலிருந்து அது நீக்கிவிடும். Frappe 16.20.0 மற்றும் 15.114.0 பதிப்புகளுக்கு முன்பு இந்த கால அளவு 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 மூலம் இயக்குங்கள், பின்னர் அந்த கோப்பகத்தை நீங்கள் நிர்வகிக்காத வேறொரு இடத்திற்கு நகர்த்துங்கள். off-site storage-க்கு குறியாக்கம் செய்யப்பட்ட restic backups என்பதே சரியான கருவி. ஏனெனில் இது பதிவேற்றுவதற்கு முன்பே கோப்புகளைக் குறியாக்கம் செய்கிறது, மேலும் restic check மூலம் அந்த repository இன்னும் வாசிக்கக்கூடிய நிலையில் உள்ளதா என்பதை உறுதிப்படுத்தலாம். ERP காப்புப்பிரதி என்பது உங்கள் முழு கணக்கு விவரங்களின் நகல் என்பதால், அது இந்த வன்பொருளில் (hardware) இல்லாமல், பாதுகாப்பான வேறொரு இடத்தில் குறியாக்கம் செய்யப்பட்டு சேமிக்கப்பட வேண்டும்.
தேவைப்படும் முன் restore-ஐச் சோதிக்கவும்
சோதிக்கப்படாத backup என்பது வெறும் ஊகம் மட்டுமே. அதை அதே server-ல் உள்ள மற்றொரு தளத்தில் சோதிக்கவும்; ஒருபோதும் நேரடி (live) தளத்தில் செய்ய வேண்டாம்.
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-ஐ நகலெடுத்து, restore செய்யப்பட்ட தளத்தில் சேர்க்கவும். இல்லையெனில், அதன் 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-ஐச் சரிபார்க்கவும். Accounts Receivable அறிக்கையைத் திறந்து, அதன் closing balance-ஐ நேரடித் தளத்துடன் ஒப்பிடவும். சமீபத்திய purchase invoice ஒன்றைத் திறந்து, அதில் உள்ள attachment-ஐத் தரவிறக்கம் செய்யவும். ஒரு தளத்தின் login பக்கம் தெரிவது மட்டும் அது சரியாக இயங்குகிறது என்பதற்குச் சான்றாகாது.
சோதனை முடிந்ததும் அந்தத் தளத்தை நீக்கவும்:
docker compose --project-name erpnext exec backend \
bench drop-site restore-test.example.comERPNext-க்கு version pinning ஏன் முக்கியமானது
ஒரு static site-ல், pin செய்யப்படாத image tag என்பது ஒரு எதிர்பாராத restart-ஐ மட்டுமே குறிக்கும். ஆனால் ERPNext-ல், அது ஒரு schema migration-ஐக் குறிக்கும். bench migrate database tables-ஐ மாற்றியமைக்கும், மேலும் document data-வையும் மாற்றக்கூடும்; இதற்கு undo வசதி கிடையாது. எனவே, rollback செய்வது என்பது docker compose down மூலம் செய்வதல்ல, backup-லிருந்து restore செய்வதாகும்.
ஆகவே, tag-ஐ pin செய்யுங்கள். 2026 ஆகஸ்ட் மாதத்தில், repository-ன் சொந்த pwd.yml-ல் ERPNEXT_VERSION=v16.32.1 என்பது pin செய்யப்பட்ட release ஆகும். 2026-11-16 அன்று, pwd.yml மற்றும் example.env ஆகிய இரண்டுமே v16.55.0-ஐ pin செய்திருந்தன. எந்தவொரு எண்ணையும் சரிபார்க்காமல் அடுத்த கட்டத்திற்கு எடுத்துச் செல்ல வேண்டாம். தற்போதைய releases frappe/erpnext releases page-ல் பட்டியலிடப்பட்டுள்ளன, மேலும் தற்போதுள்ள image tags Docker Hub-ல் உள்ளன. நீங்கள் மாறப்போகும் version-க்கான குறிப்புகளை, மாறுவதற்கு முன்பே படித்துப் பாருங்கள்.
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 offMaintenance mode முக்கியமானது, ஏனெனில் migrate இயங்கும்போது schema-வை மாற்றுகிறது. முழுமையாக migrate ஆகாத table-ல் ஒரு பயனர் document-ஐச் சமர்ப்பித்தால், நீங்கள் பதிவுகளைக் கையால் சரிசெய்ய வேண்டிய சூழல் ஏற்படும்.
ஒவ்வொரு major version-ஆக மாறவும், ஒவ்வொரு படிக்கும் இடையில் backup எடுக்கவும். தொடர்வதற்கு முன், ஒவ்வொரு major version-க்கான migration வழிகாட்டுதலையும் சரிபார்க்கவும்.
இந்த repository overrides/compose.migrator.yaml-ஐயும் வழங்குகிறது. இது, sites இருக்கும்போதும் மற்றும் MIGRATE_SITES இயக்கப்பட்டிருக்கும்போதும் (இது default-ஆகவே இருக்கும்), தொடக்கத்தின்போது bench --site all migrate-ஐ இயக்கும் container-ஐச் சேர்க்கிறது. இது வசதியானதுதான். ஆனால், tag மாற்றப்பட்ட ஒரு docker compose up, நீங்கள் கவனிக்காத நேரத்தில் உங்கள் production database-ஐ migrate செய்துவிடும் என்பதையும் இது குறிக்கிறது. ஒரு business system-ல், migrate செய்வதை அந்த நாளில் நீங்கள் எடுத்த ஒரு முடிவாகவே மேற்கொள்ளுங்கள்.
வாடிக்கையாளர் தரவுகளைக் கொண்ட server-ஐப் பாதுகாத்தல்
முதல்முறை login செய்யும்போது Administrator கடவுச்சொல்லை மாற்றவும். மதிப்பீட்டு compose file-ல் admin என்பது கடவுச்சொல்லாக வழங்கப்படுகிறது, பலர் இதை மாற்றாமல் production-லும் பயன்படுத்துகின்றனர்.
example.env-ல் உள்ள 123-லிருந்து DB_PASSWORD-ஐ மாற்றவும். அந்த மதிப்பு, உருவாக்கப்படும் ~/gitops/erpnext.yaml-ல் plain text-ஆக சேமிக்கப்படும், எனவே அந்த கோப்பை chmod 600 செய்து, எந்த git repository-லும் சேர்க்க வேண்டாம். கூடுதல் பாதுகாப்பிற்கு, overrides/compose.mariadb-secrets.yaml-ஐப் பயன்படுத்தி environment variable-க்கு பதிலாக Docker secret கோப்பிலிருந்து கடவுச்சொல்லைப் படிக்கலாம். Docker Compose-ல் env கோப்புகள் மற்றும் secrets-ஐக் கையாளுதல் இதிலுள்ள சாதக பாதகங்களை விளக்குகிறது.
தேவையானவற்றை மட்டும் public-ஆக வெளியிடவும். HTTPS override மூலம், 80 மற்றும் 443 ஆகிய ports மட்டுமே திறக்கப்படுகின்றன. database client இணைப்பை எளிதாக்க db service-க்கு ports mapping-ஐச் சேர்க்க வேண்டாம்: இது MariaDB-ஐ பொது இணையத்தில் வெளிப்படுத்திவிடும். அதற்குப் பதிலாக docker compose --project-name erpnext exec backend bench mariadb-ஐப் பயன்படுத்தவும். Host-ல் 22, 80 மற்றும் 443 ஆகியவற்றை மட்டும் அனுமதித்து, மற்றவற்றைத் தடுக்கவும்; உங்கள் service provider-ன் தனிப்பட்ட network firewall-ஐயும் சரிபார்க்கவும்.
System Manager பங்குள்ள ஒவ்வொரு கணக்கிற்கும் System Settings-ல் two factor authentication-ஐச் செயல்படுத்தவும். அந்தப் பங்கு System Settings-ஐ மாற்றக்கூடியது என்பதால், அதை ஒரு வசதிக்கான கணக்காகக் கருதாமல், administrator கணக்காகக் கருதவும். நீங்கள் பல self-hosted apps-ஐ இயக்கினால், ஒவ்வொரு app-க்கும் தனித்தனி கடவுச்சொல் வைப்பதை விட Authentik-ஐ self-hosted single sign-on provider-ஆகப் பயன்படுத்துதல் சிறந்தது.
Host-ஐப் புதுப்பித்து (patch), kernel updates-க்காக reboot செய்யவும். Stack மீண்டும் இயங்குவதை உறுதி செய்வதற்கு முன், ஒவ்வொரு service-லும் restart policy உள்ளதா எனச் சரிபார்க்கவும், ஏனெனில் அது இல்லையெனில் reboot-க்குப் பிறகு stack இயங்காது. reboot-க்குப் பிறகு Docker Compose stack-ஐ மீண்டும் தொடங்குதல் systemd சார்ந்த வழிமுறைகளை விளக்குகிறது.
ஒரு VPS-ல் ERPNext-ன் செயல்பாடு குறையும்போது
ஒரு VPS நீண்ட காலம் ஒரு சிறிய நிறுவனத்தின் தேவைகளைப் பூர்த்தி செய்யும். அதன் திறன் குறையும்போது கீழ்க்கண்ட அறிகுறிகள் தென்படும்:
- Background jobs தேங்குவதால், மின்னஞ்சல்கள் மற்றும் தரவு இறக்குமதிகள் பல நிமிடங்கள் அல்லது மணிநேரம் தாமதமாகச் சென்றடையும்.
docker inspect,"OOMKilled": trueஅல்லது exit code 137 ஆகிய பிழைகளுடன் containers இயங்குவதாகக் காட்டும்.- இரண்டு வினாடிகளில் முடிவடைந்த அறிக்கைகள் முப்பது வினாடிகள் வரை எடுக்கும், மேலும் MariaDB செயல்முறை CPU-வை அதிகமாகப் பயன்படுத்தும்.
- Backups முடிவதற்குள் அடுத்த backup-க்கான நேரம் வந்துவிடும்.
முதலில் MariaDB-க்குத் தனிப்பட்ட வளங்களை (resources) ஒதுக்குங்கள். ஏனெனில், database மற்றும் Python workers ஒரே நினைவகத்தைப் (memory) பகிர்ந்து கொள்வதால், buffer pool-க்கு அதிக நினைவகம் தேவைப்படுகிறது. மக்கள் எதிர்பார்ப்பதை விட, application server-ஐப் பெரிதாக்குவது குறைவான பலனையே தரும். database-ஐ Docker-ல் அல்லது host-ல் இயக்குவது குறித்த முடிவை இது விளக்குகிறது, மேலும் Docker Compose-ல் memory limits அமைப்பது ஒரு container மற்றவற்றை முடக்காமல் இருப்பதை உறுதி செய்யும்.
அதன்பிறகு, web capacity-ஐ அதிகரிப்பதற்குப் பதிலாக queue workers-ஐச் சேர்க்கவும். ERPNext-ன் மெதுவான செயல்பாடுகள் பெரும்பாலும் background-ல் நடப்பவை: அறிக்கை தயாரித்தல் மற்றும் மொத்தமாகத் தரவுகளை இறக்குமதி செய்தல் போன்றவை. கூடுதல் workers-க்கு அதிக CPU மற்றும் நினைவகத் தேவை இருக்கும்; ஏற்கனவே முழுமையாகப் பயன்படுத்தப்படும் VPS-ல் புதிய containers-ஐச் சேர்ப்பது கூடுதல் திறனைத் தராது.
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 மூலம் அவற்றை ஒரே கோப்பாக உருவாக்கி, அந்த கோப்பை இயக்கவும்.
ERPNext-ஐ உருவாக்கிய உடனேயே எனது தளம் ஏன் அணுக முடியாத நிலையில் உள்ளது?
Frontend, HTTP Host header-ஐ அடிப்படையாகக் கொண்டே எந்தத் தளத்தை வழங்க வேண்டும் என்பதைத் தீர்மானிக்கிறது, எனவே உலாவியில் உள்ள domain பெயரும் தளத்தின் பெயரும் ஒன்றாக இருக்க வேண்டும். erpnext என உருவாக்கப்பட்ட ஒரு தளம் erp.example.com-ல் வழங்கப்படாது. தளத்தை அதன் domain பெயரிலேயே உருவாக்கவும் அல்லது env கோப்பில் FRAPPE_SITE_NAME_HEADER-ஐ தளத்தின் பெயருக்கு அமைத்து, compose கோப்பை மீண்டும் உருவாக்கி, stack-ஐ restart செய்யவும்.
ERPNext backup-ல் என்னென்ன இருக்க வேண்டும்?
நான்கு கோப்புகள் ஒன்றாக இருக்க வேண்டும்: -database.sql.gz dump, -files.tar மற்றும் -private-files.tar archives, மற்றும் -site_config_backup.json config நகல். bench --site erp.example.com backup --with-files-ஐ இயக்குவதன் மூலம் இவை நான்கும் உருவாக்கப்படும். Config நகலில் encryption_key இருப்பதால், அதைத் தவிர்த்து restore செய்தால், சேமிக்கப்பட்ட integration கடவுச்சொற்களை decrypt செய்ய முடியாது; இது Encryption key is invalid! Please check site_config.json பிழையாக வெளிப்படும்.
எனது தரவுகளைப் பாதிக்காமல் ERPNext-ஐ எப்படி upgrade செய்வது?
--with-files மூலம் backup எடுக்கவும், maintenance mode-ஐ இயக்கவும், உங்கள் env கோப்பில் ERPNEXT_VERSION-ஐ மாற்றவும், compose கோப்பை மீண்டும் உருவாக்கி, pull செய்து, stack-ஐத் தொடங்கவும். பின்னர் bench --site erp.example.com migrate-ஐ இயக்கி, maintenance mode-ஐ அணைக்கவும். ஒரு நேரத்தில் ஒரு major version-ஆக மட்டும் மேம்படுத்தவும்; மேம்படுத்துவதற்கு முன் release notes-ஐப் படிக்கவும், ஏனெனில் migrate எந்தவிதமான undo வசதியும் இன்றி schema மற்றும் document தரவுகளை மாற்றியமைக்கும். பழைய நிலைக்குத் திரும்புவது (rollback) என்பது நீங்கள் தொடக்கத்தில் எடுத்த backup-ஐ மீண்டும் restore செய்வதையே குறிக்கும்.