SSD Nodes Learn Hosting plans →
নির্দেশিকা Matt Connorদ্বারা Matt Connor

Docker ব্যবহার করে VPS-এ ERPNext ইনস্টল করার নিয়ম

Docker ব্যবহার করে VPS-এ ERPNext সেটআপ করার পূর্ণাঙ্গ নির্দেশিকা। এগারোটি কন্টেইনার স্ট্যাক, TLS কনফিগারেশন, ইমেইল সেটিংস এবং ভার্সন পিনিংয়ের মাধ্যমে নিরাপদ ডিপ্লয়মেন্ট নিশ্চিত করুন।

আপনি যা চালানোর জন্য প্রস্তুতি নিচ্ছেন

একটি VPS-এ ERPNext self-host করা একটি অপারেশনাল কাজ, এটি কোনো একটি কমান্ড দিয়ে ইনস্টল করার বিষয় নয়। এর অফিসিয়াল Docker Compose স্ট্যাকটি এগারোটি কন্টেইনার নিয়ে গঠিত এবং এটি আপনার প্রতিষ্ঠানের সাধারণ লেজার (general ledger) ও গ্রাহকের রেকর্ড সংরক্ষণ করে। এটি নিচের প্রতিটি বিষয়ের জন্য মানদণ্ড বাড়িয়ে দেয়: একটি ব্যাকআপ ততক্ষণ পর্যন্ত ব্যাকআপ নয় যতক্ষণ না আপনি তা সফলভাবে রিস্টোর করতে পারছেন, এবং একটি আনপিন করা (unpinned) ইমেজ ট্যাগ যেকোনো সময় স্কিমা মাইগ্রেশনের জটিলতা তৈরি করতে পারে।

পুরো প্রক্রিয়াটিতে কয়েকটি নাম বারবার আসবে। ERPNext হলো মূল বিজনেস অ্যাপ্লিকেশন। Frappe হলো এর নিচের পাইথন ফ্রেমওয়ার্ক। 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 থেকে নেওয়া পরিমাপ নয়। আপনার প্রকৃত document volume-ই প্রয়োজনীয় ক্ষমতা নির্ধারণ করবে। শেষ সারিটি কোনো প্রকাশিত minimum নয়। এটি memory headroom বাড়ায়, কিন্তু memory কখনো শেষ হবে না—এমন নিশ্চয়তা দেয় না।

ছোট plan-গুলোর সীমাবদ্ধতা স্পষ্টভাবে বিবেচনা করুন। 1 GB বা 2 GB VPS-এ দশটি দীর্ঘ সময় চলা container, MariaDB-এর buffer pool এবং report তৈরি করা একটি Python worker চালানোর জন্য খুব কম headroom থাকে। Memory pressure হলে kernel-এর out of memory killer একটি container বন্ধ করে দিতে পারে। তখন docker inspect-এ "OOMKilled": true এবং exit code 137 দেখা যায়। কোনো worker job চলাকালে বন্ধ হয়ে গেলে submitted document-এর background কাজ অসম্পূর্ণ থেকে যায়।

যে company প্রতিদিন ERPNext ব্যবহার করে, তাদের 8 GB RAM, 4 vCPU এবং 100 GB SSD ধরে পরিকল্পনা শুরু করা উচিত। এরপর নিজের workload পরীক্ষা করুন। সবার আগে RAM শেষ হয়। মানুষ যতটা আশা করে, disk তার চেয়ে দ্রুত পূর্ণ হয়, কারণ প্রতিটি attachment এবং প্রতিটি local backup database-এর একই volume-এ সংরক্ষিত হয়।

এগারোটি container এবং প্রতিটির কাজ

Stack চালু হয়ে দশটি container running অবস্থায় থাকলে docker compose ps চালান। আরও একটি container, configurator, একবার কাজ করে exit করে। মোট এগারোটি container হওয়ার কারণ এটাই।

  • backend gunicorn-এর অধীনে Frappe application চালায়। এখানেই bench থাকে।
  • frontend হলো nginx। এটি static asset সরবরাহ করে এবং বাকি সবকিছু backend-এ পাঠায়।
  • queue-short এবং queue-long হলো RQ (Redis Queue) worker। এগুলো outgoing email, import এবং report build-এর মতো background job চালায়।
  • scheduler সময়ভিত্তিক job চালায়। এর মধ্যে scheduled report এবং auto repeat document রয়েছে।
  • websocket হলো browser-এর live update-এর পেছনে থাকা socket.io process।
  • db হলো MariaDB।
  • redis-cache এবং redis-queue দুটি আলাদা Redis instance। একটি cache-এর জন্য এবং অন্যটি job queue-এর জন্য।
  • proxy হলো Traefik, যা HTTPS override দ্বারা যোগ হয়। এটি port 80 এবং 443 নিয়ন্ত্রণ করে এবং certificate সংগ্রহ করে।

এই বিভাজন জানা গুরুত্বপূর্ণ, কারণ এর মাধ্যমে কোন log পড়তে হবে তা বোঝা যায়। Email আটকে থাকলে এটি queue worker-এর সমস্যা। তাই docker compose logs -f queue-short সঠিক command। কোনো page load হলেও notification badge কখনো update না হলে সেটি websocket-এর সমস্যা। যেকোনো একটি সমস্যার জন্য backend-এর log পড়লে অপ্রয়োজনীয়ভাবে অনেক সময় নষ্ট হবে।

Production compose file দিয়ে ইনস্টল করুন, demo দিয়ে নয়

Repository-তে pwd.yml রয়েছে, এবং README-তে বিষয়টি স্পষ্টভাবে বলা আছে: "এই setup শুধুমাত্র স্বল্পমেয়াদি মূল্যায়নের জন্য। এই setup-এ custom app ইনস্টল করা যাবে না।" এক বিকেল 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 2025 সালের June 4 তারিখে expiration notification email পাঠানো বন্ধ করেছে। তাই certificate-এর মেয়াদ আলাদাভাবে 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 কোনো কিছু start করে না। এটি base file-এর সঙ্গে override file merge করে এবং সব variable-এর মান প্রতিস্থাপন করা সম্পূর্ণ ফলাফল দেখায়। এরপর সেই rendered file চালান। এই অতিরিক্ত ধাপটি গুরুত্বপূর্ণ: চলমান stack একটি পড়ার উপযোগী file-এ নির্দিষ্ট থাকে। তাই কেউ env file সম্পাদনা করলে বা repository pull করলে এটি আপনার অজান্তে পরিবর্তিত হয় না। একাধিক Docker Compose file কীভাবে merge হয় override rule-গুলো বিস্তারিতভাবে ব্যাখ্যা করে।

COMPOSE_FILE export করলে নিচের command-গুলো rendered file ব্যবহার করে। প্রতিটি নতুন shell-এ এটি আবার export করুন। cron-এ -f ~/gitops/erpnext.yaml স্পষ্টভাবে pass করুন।

db start হওয়া এবং configurator exit করা পর্যন্ত অপেক্ষা করুন। এতে কয়েক সেকেন্ড লাগবে। এরপর 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-এর output-এ frappe এবং erpnext-এর version দেখা উচিত। সুস্থ ps-এ running state-এ দশটি service এবং restarting state-এ কোনো service থাকে না।

এখানে প্রায়ই দুটি সমস্যা দেখা যায়। --mariadb-user-host-login-scope=% নতুন site-এর database user-এর জন্য wildcard host scope নির্ধারণ করে। ফলে Docker app container-কে ভিন্ন address দিলেও user লগ ইন করতে পারে। এটি না দিলে Frappe user-টিকে বর্তমান connecting host-এর মধ্যে সীমাবদ্ধ করে। App container Docker network-এর মাধ্যমে MariaDB-তে পৌঁছায়। তাই সেটি remote host হিসেবে আসে, এবং localhost-এ সীমাবদ্ধ database user সেখান থেকে লগ ইন করতে পারে না। এই option site-এর database user পরিবর্তন করে, root account নয়। % scope MariaDB-তে পৌঁছাতে পারে এমন যেকোনো host থেকে connection অনুমোদন করে। তাই database-কে private Docker network-এ রাখুন।

দ্বিতীয় সমস্যা site name নিয়ে। Frontend defaultভাবে HTTP Host header থেকে কোন site serve করবে তা নির্বাচন করে। তাই erpnext নামে তৈরি site erp.example.com-এ পৌঁছানো যায় না, যদিও উভয় site-ই বিদ্যমান। উপরের মতো domain অনুযায়ী site-এর নাম দিন। অথবা env file-এ FRAPPE_SITE_NAME_HEADER-এর মান site name নির্ধারণ করুন এবং compose file আবার render করুন।

HTTPS এবং এটি কাজ করার পূর্বশর্তসমূহ

compose.https.yaml ওভাররাইডটি Traefik-কে 443 পোর্টে চালায়, 80 পোর্ট থেকে ট্রাফিক রিডাইরেক্ট করে এবং 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 ইনস্ট্যান্স দেখাচ্ছে কীভাবে 443 পোর্টের দখল নিয়ে সংঘাত না করে প্রক্সিকে শেয়ার করা যায়। এই ধরনের সার্ভারে দ্বিতীয় অ্যাপটি প্রায়শই গ্রাহককেন্দ্রিক হয় এবং একটি self-hosted Chatwoot সাপোর্ট ডেস্ক সেই একই প্রক্সির পেছনে থাকে, যাতে যারা ইনভয়েস নিয়ে কাজ করেন তারা একই জায়গা থেকে গ্রাহকের ইমেইল এবং চ্যাটের উত্তর দিতে পারেন।

বহির্গামী ইমেইল, নইলে invoice কখনও server ছাড়বে না

এটি সেই ধাপ, যা অধিকাংশ ERPNext guide এড়িয়ে যায়। কিন্তু সিস্টেমটি কার্যকর হবে কি না, তা এই ধাপই নির্ধারণ করে। বহির্গামী mail কাজ না করলে কোনো invoice customer-এর কাছে পৌঁছায় না, password reset-এর mail আসে না, এবং scheduled report-ও পাঠানো হয় না। এই stack-এ কোনো mail server নেই।

VPS থেকে port 25 ব্যবহার করে সরাসরি mail পাঠানোর চেষ্টা করবেন না। AWS-এর মতো provider-গুলো default-ভাবে outbound port 25 block করে। এ ছাড়া, খুব কম বা কোনো পূর্ববর্তী history না থাকা নতুন sending IP rejection বা spam placement-এর ঝুঁকি বাড়ায়। তবে এই ফলাফল অনিবার্য নয়। Port 587-এ authenticated relay ব্যবহার করুন। এর আগে provider-এর outbound rule পরীক্ষা করুন: DigitalOcean default-ভাবে Droplet-এ port 25, 465 এবং 587 block করে।

সমর্থিত পদ্ধতি হলো ERPNext interface-এর Email Account screen ব্যবহার করা। এটি password encrypted অবস্থায় সংরক্ষণ করে। আপনি site config-এ key-গুলোও লিখতে পারেন:

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 হিসেবে সংরক্ষণ করে। File-টি আবার পড়ে নিশ্চিত করুন যে এই দুই value-এর চারপাশে কোনো quote নেই:

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

Encrypted password storage-এর জন্য Email Account screen-এ outgoing server, login এবং password একসঙ্গে configure করুন। এর password field আলাদা mail_password site config key সেট করে না।

এরপর একটি বাস্তব message পাঠান। একটি Sales Invoice তৈরি করুন, আপনার নিয়ন্ত্রণাধীন একটি address-এ সেটি 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) record-ও publish করুন। এরপর একটি DMARC policy যোগ করুন। Authentication ছাড়া technically সঠিক invoice-ও rejection বা spam placement-এর ঝুঁকিতে থাকে। আপনি যদি পুরো mail path নিজেই পরিচালনা করতে চান, একটি self-hosted Mailcow mail server ব্যবহার করতে পারেন। এতে ERP থেকে আলাদা একটি box-এ আপনার নিয়ন্ত্রণাধীন relay থাকবে।

যে ব্যাকআপ সত্যিই restore করা যায়

শুধু database dump থাকলেই ERPNext-এর ব্যাকআপ হয় না। Attachments এবং private files sites directory-তে থাকে, MariaDB-তে নয়। শুধু database restore করলে প্রতিটি upload করা 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-এ চারটি file লেখে:

  • একটি -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 থাকে। Frappe এই key ব্যবহার করে সংরক্ষিত password encrypt করে: email account credential, payment gateway key এবং প্রতিটি integration secret। মিল থাকা key ছাড়া database restore করলে site স্বাভাবিকভাবে load হয়, কিন্তু mail পাঠানো ব্যর্থ হয়:

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

সবসময় চারটি file একসঙ্গে রাখুন।

এরপর এগুলো server-এর বাইরে নিয়ে যান। volume-এর ভিতরের backup server নষ্ট হলে টিকে থাকে না। উপরন্তু, bench এটি নিজেই prune করে: default হিসেবে ওই directory থেকে 23 ঘণ্টার বেশি পুরোনো backup মুছে ফেলে। 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-টি এমন কোথাও পাঠান যা আপনি administer করেন না। off-site storage-এ encrypted restic backup এর জন্য উপযুক্ত tool, কারণ এটি upload-এর আগে encrypt করে এবং restic check প্রমাণ করে যে repository এখনও read করা যায়। ERP backup আপনার সম্পূর্ণ ledger-এর একটি copy। তাই এটি এই server নয়, এমন hardware-এ at rest অবস্থায় encrypted করে রাখা উচিত।

প্রয়োজনের আগেই restore পরীক্ষা করুন

পরীক্ষা না করা backup কেবল একটি অনুমান। একই box-এ দ্বিতীয় 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-এ রাখুন। তা না হলে এর 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 করুন। কোনো site শুধু 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 table পুনর্লিখতে পারে এবং document data-ও পরিবর্তন করতে পারে; এর কোনো undo নেই। Rollback করতে backup restore করতে হয়, কোনো docker compose down নয়।

তাই tag pin করুন। আগস্ট 2026-এ repository-এর নিজস্ব pwd.yml-এ ERPNEXT_VERSION=v16.32.1 release-টি pinned ছিল। 2026-11-16 তারিখে pwd.yml এবং example.env উভয়ই v16.55.0 pin করেছিল। যাচাই না করে এই নম্বরগুলোর কোনোটি পরবর্তী সময়ে ব্যবহার করবেন না। বর্তমান release-গুলোর তালিকা frappe/erpnext releases page-এ আছে, আর বিদ্যমান image tag-গুলো Docker Hub-এ পাওয়া যায়। যে version-এ যেতে চান, upgrade করার আগে সেই 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 পরিবর্তন করে। অর্ধেক migration হওয়া table-এর বিরুদ্ধে কোনো user document submit করলে record হাতে মেরামত করতে হতে পারে।

একবারে একটি major version-এ যান। প্রতিটি ধাপের আগে backup নিন। এগিয়ে যাওয়ার আগে প্রতিটি major version-এর migration নির্দেশনা পরীক্ষা করুন।

Repository-তে overrides/compose.migrator.yaml-ও রয়েছে। এটি এমন একটি container যোগ করে, যা start হওয়ার সময় site থাকলে এবং MIGRATE_SITES enabled থাকলে bench --site all migrate চালায়; MIGRATE_SITES default-ভাবে enabled থাকে। এটি সুবিধাজনক। তবে এর অর্থ হলো, tag পরিবর্তন করে একটি docker compose up চালু করলে কেউ পর্যবেক্ষণ না করেও আপনার production database migrate হয়ে যেতে পারে। একটি business system-এ migrate চালানো সেই সকালের সচেতন সিদ্ধান্ত হিসেবে নিন।

গ্রাহকের রেকর্ড থাকা সার্ভার শক্তিশালী করা

প্রথমবার login করার সময় Administrator-এর password পরিবর্তন করুন। evaluation compose file-এ admin password হিসেবে দেওয়া থাকে, এবং এই অভ্যাস production environment-এও থেকে যায়।

example.env-এর 123 থেকে DB_PASSWORD-এর মান পরিবর্তন করুন। এই মানটি rendered ~/gitops/erpnext.yaml-এ plain text হিসেবে থাকে। তাই chmod 600 করুন এবং ফাইলটি কোনো git repository-তে রাখবেন না। আরও নিরাপদ পদ্ধতির জন্য overrides/compose.mariadb-secrets.yaml environment variable-এর পরিবর্তে Docker secret file থেকে password পড়ে। Docker Compose-এ env file ও secret ব্যবস্থাপনা-এ এর সুবিধা ও সীমাবদ্ধতা ব্যাখ্যা করা হয়েছে।

শুধু প্রয়োজনীয় port publish করুন। HTTPS override ব্যবহার করলে 80 এবং 443-ই একমাত্র exposed port থাকে। database client-এ সংযোগ সহজ করার জন্য db service-এ ports mapping যোগ করবেন না। এতে MariaDB public internet-এ উন্মুক্ত হয়ে যায়। এর পরিবর্তে docker compose --project-name erpnext exec backend bench mariadb ব্যবহার করুন। host-এ 22, 80 এবং 443 অনুমোদন করুন, বাকি port deny করুন। Provider-এর আলাদা network firewall-ও পরীক্ষা করুন।

System Settings-এ System Manager role থাকা প্রতিটি account-এর জন্য two-factor authentication চালু করুন। এই role থেকে System Settings পরিবর্তন করা যায়। তাই এটিকে convenience account নয়, administrator account হিসেবে বিবেচনা করুন। একাধিক self-hosted app চালালে প্রতিটি app-এর জন্য আরেকটি password রাখার চেয়ে self-hosted single sign-on provider হিসেবে Authentik ব্যবহার করা ভালো।

host patch করুন এবং kernel update-এর জন্য reboot করুন। Stack আবার চালু হবে বলে নির্ভর করার আগে প্রতিটি service-এর জন্য rendered file-এ restart policy আছে কি না পরীক্ষা করুন। এই policy না থাকলে reboot-এর পরে stack চালু হবে না। reboot-এর পরে Docker Compose stack আবার চালু করা-এ systemd-সংক্রান্ত পদ্ধতি ব্যাখ্যা করা হয়েছে।

একটি VPS-এ ERPNext আর স্বচ্ছন্দে না চললে

একটি ছোট কোম্পানি দীর্ঘ সময় একটি VPS-এই চলতে পারে। এটি আর যথেষ্ট নয়—এর লক্ষণগুলো হলো:

  • Background job জমে যায়। ফলে email এবং import কয়েক মিনিট বা কয়েক ঘণ্টা দেরিতে পৌঁছায়।
  • docker inspect report-এ container-এর "OOMKilled": true অথবা exit code 137 দেখা যায়।
  • যে report তৈরি হতে দুই সেকেন্ড লাগত, সেটিতে এখন ত্রিশ সেকেন্ড লাগে। MariaDB তখন CPU ধরে রাখে।
  • Backup এত সময় ধরে চলে যে পরবর্তী নির্ধারিত run শুরু হওয়ার আগেই আগেরটি শেষ হয় না।

প্রথমে MariaDB-কে এমন resource দিন, যা অন্য process-এর সঙ্গে ভাগ করতে হবে না। Database এবং Python worker একই memory-এর জন্য প্রতিযোগিতা করে। Buffer pool-এরই বেশি memory প্রয়োজন। Application server বড় করলেও প্রত্যাশার তুলনায় কম উপকার হয়। database Docker-এ বা host-এ চালানো এই সিদ্ধান্তটি ব্যাখ্যা করে। আর Docker Compose-এ memory limit নির্ধারণ করা একটি container-কে অন্যগুলোর resource শেষ করে ফেলা থেকে আটকায়।

এরপর web capacity না বাড়িয়ে queue worker যোগ করুন। ERPNext-এর ধীর কাজগুলো background-এ চলে, যেমন report তৈরি এবং bulk import। অতিরিক্ত worker-এর জন্য CPU ও memory headroom দরকার। ইতিমধ্যে সম্পূর্ণ ব্যবহৃত VPS-এ container যোগ করলে capacity বাড়ে না।

FAQ

VPS-এ ERPNext-এর কত RAM প্রয়োজন?

পরীক্ষামূলক ব্যবহারের জন্য 4 GB RAM এবং 2 vCPU দিয়ে শুরু করুন। প্রতিদিন ব্যবহারকারী কোনো প্রতিষ্ঠানের জন্য 8 GB RAM, 4 vCPU এবং 100 GB SSD রাখার পরিকল্পনা করুন। মেমরির চাপ থাকলে kernel-এর out of memory killer container বন্ধ করে দিতে পারে। তখন docker inspect এটিকে exit code 137-সহ "OOMKilled": true হিসেবে রিপোর্ট করে। এগুলো প্রাথমিক নির্দেশনা, পরিমাপ করা প্রয়োজনীয়তা নয়। তাই প্রথম মাসে নিজের মেমরি ব্যবহার পর্যবেক্ষণ করুন।

production-এ কি pwd.yml চালানো যায়?

না। প্রকল্পের README-তে বলা হয়েছে, এটি শুধু স্বল্পমেয়াদি পরীক্ষামূলক ব্যবহারের জন্য। সেখানে আরও বলা আছে যে এতে custom app install করা যায় না। MariaDB, Redis এবং HTTPS override-সহ compose.yaml ব্যবহার করুন। docker compose config দিয়ে সেগুলো একটি ফাইলে render করুন এবং সেই ফাইল চালান।

site তৈরি করার পরপরই আমার ERPNext site-এ কেন সংযোগ করা যাচ্ছে না?

ডিফল্টভাবে frontend HTTP Host header থেকে কোন site পরিবেশন করবে তা নির্ধারণ করে। তাই browser-এর domain-টির সঙ্গে site-এর নাম মিলতে হবে। erpnext হিসেবে তৈরি site erp.example.com-এ পরিবেশন হবে না। হয় domain-টিকে site-এর নাম হিসেবে ব্যবহার করে site তৈরি করুন, অথবা env file-এ FRAPPE_SITE_NAME_HEADER-কে site-এর নামে সেট করুন। এরপর compose file আবার render করে stack restart করুন।

ERPNext backup-এ কী কী থাকতে হবে?

চারটি ফাইল একসঙ্গে রাখতে হবে: -database.sql.gz dump, -files.tar এবং -private-files.tar archive, এবং -site_config_backup.json config copy। bench --site erp.example.com backup --with-files চালালে চারটিই তৈরি হয়। config copy-তে encryption_key থাকে। তাই এটি ছাড়া restore করলে সংরক্ষিত integration password decrypt করা যায় না। এর ফল Encryption key is invalid! Please check site_config.json হিসেবে দেখা যায়।

ডেটা নষ্ট না করে ERPNext কীভাবে upgrade করব?

--with-files দিয়ে backup নিন, maintenance mode চালু করুন, env file-এ ERPNEXT_VERSION পরিবর্তন করুন, compose file আবার render করুন, image pull করুন, stack চালু করুন, তারপর bench --site erp.example.com migrate চালিয়ে maintenance mode বন্ধ করুন। একবারে একটি major version অতিক্রম করুন এবং আগে release notes পড়ুন। কারণ migrate schema ও document data এমনভাবে rewrite করে, যার কোনো undo নেই। rollback করতে হলে শুরুতে নেওয়া backup restore করুন।

এই লেখাটি কি কাজে লেগেছে?