Tự host ERPNext trên VPS bằng Docker
Triển khai ERPNext trên VPS với stack Docker Compose 11 container, TLS, email outbound và image tag được pin; kiểm tra restore backup trước khi chạy production.
Bạn sắp triển khai gì
Tự host ERPNext trên một VPS là công việc vận hành, không phải thao tác cài đặt bằng một lệnh. Stack Docker Compose chính thức gồm 11 container và lưu trữ sổ cái tổng hợp cùng hồ sơ khách hàng của bạn. Vì vậy, mọi bước dưới đây phải tuân theo tiêu chuẩn cao hơn: một bản backup chưa được restore thì chưa thể xem là bản backup, còn image tag không được pin là dấu hiệu một schema migration có thể xảy ra bất cứ lúc nào.
Một số tên sẽ xuất hiện xuyên suốt tài liệu. ERPNext là ứng dụng nghiệp vụ. Frappe là Python framework bên dưới ứng dụng đó. Bench là công cụ command line dùng để quản lý các site và đã được cài sẵn bên trong các container. Một site là một tenant: gồm một database MariaDB và một thư mục chứa các file đã upload. Hầu hết command ở đây chạy bench bên trong container backend và thao tác trên một site được chỉ định tên.
Hướng dẫn này sử dụng repository frappe_docker, là deployment do project duy trì. Tất cả command dưới đây đã được kiểm tra với repository đó vào tháng 8 năm 2026. Nếu Docker Compose còn mới với bạn, chạy Docker Compose trên VPS sẽ trình bày các kiến thức nền mà hướng dẫn này giả định bạn đã biết.
ERPNext cần VPS cấu hình thế nào?
Dữ liệu đằng sau biểu đồ này
[
{
"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
}
]Để đánh giá, hãy bắt đầu với 2 vCPU và 4 GB RAM. Đây là cấu hình cho giai đoạn đánh giá. Các con số này chỉ là điểm bắt đầu, không phải số đo từ hướng dẫn này; dung lượng tài liệu thực tế của bạn mới quyết định con số phù hợp. Dòng cuối hoàn toàn không phải mức tối thiểu được công bố. Nó cho bạn thêm dư địa về bộ nhớ, không đảm bảo rằng bộ nhớ sẽ không bao giờ cạn.
Hãy đánh giá thẳng thắn các gói cấu hình nhỏ. VPS 1 GB hoặc 2 GB có rất ít dư địa cho mười container chạy lâu dài, buffer pool của MariaDB và một Python worker đang tạo báo cáo cùng lúc. Khi thiếu bộ nhớ, kernel out of memory killer có thể dừng một container, sau đó docker inspect trên container đó hiển thị "OOMKilled": true với exit code 137. Worker bị dừng giữa chừng sẽ để lại một tài liệu đã submit nhưng công việc chạy nền mới hoàn thành một phần.
Với công ty sử dụng ERPNext hằng ngày, hãy bắt đầu lập kế hoạch quanh mức 8 GB RAM, 4 vCPU và 100 GB SSD, sau đó kiểm thử workload của bạn. RAM thường cạn trước. Disk tăng nhanh hơn dự kiến vì mọi file đính kèm và mọi bản backup cục bộ đều nằm trên cùng volume với database.
Mười một container và chức năng của từng container
Chạy docker compose ps sau khi stack đã khởi động và có mười container đang chạy. Một container nữa là configurator. Container này thực hiện công việc một lần rồi thoát, nên tổng cộng là mười một container.
backendchạy ứng dụng Frappe bằng gunicorn.benchnằm trong container này.frontendlà nginx. Nó phục vụ static asset và chuyển mọi yêu cầu khác đến backend.queue-shortvàqueue-longlà các worker RQ (Redis Queue). Chúng chạy các background job như gửi email đi, import và tạo report.schedulerchạy các job theo lịch, bao gồm report đã lên lịch và document tự động lặp lại.websocketlà tiến trình socket.io xử lý cập nhật trực tiếp trong browser.dblà MariaDB.redis-cachevàredis-queuelà 2 instance Redis riêng biệt, một instance dùng cho cache và một instance dùng cho job queue.proxylà Traefik, được thêm bởi HTTPS override. Nó quản lý các cổng 80 và 443 và lấy certificate.
Bạn nên nắm rõ cách tách này vì nó cho biết cần đọc log nào. Email bị kẹt là vấn đề của queue worker, nên docker compose logs -f queue-short là command phù hợp. Nếu page tải được nhưng badge thông báo không bao giờ cập nhật, đó là vấn đề của websocket. Đọc log của backend cho một trong hai trường hợp này chỉ làm mất cả buổi chiều.
Cài đặt bằng các file compose production, không dùng bản demo
Repository cung cấp pwd.yml, và README nói rất rõ: “Thiết lập này chỉ dành cho việc đánh giá trong thời gian ngắn. Bạn sẽ không thể cài đặt app tùy chỉnh vào thiết lập này.” Hãy dùng nó để xem qua ERPNext trong một buổi chiều. Không chạy hệ thống công ty trên đó.
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.envMở ~/gitops/erpnext.env và thay đổi 4 giá trị. ERPNEXT_VERSION cố định image tag. DB_PASSWORD được cung cấp dưới dạng 123 trong file mẫu. SITES_RULE là routing rule của Traefik, còn LETSENCRYPT_EMAIL cung cấp email của tài khoản ACME. Let’s Encrypt đã ngừng gửi email thông báo sắp hết hạn từ ngày 4 tháng 6 năm 2025, vì vậy hãy theo dõi thời hạn chứng chỉ riêng.
ERPNEXT_VERSION=v16.32.1
DB_PASSWORD=<a long random password>
SITES_RULE=Host(`erp.example.com`)
LETSENCRYPT_EMAIL=ops@example.comBây giờ hãy render một compose file, rồi khởi động file đó.
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 không khởi động gì cả. Lệnh này gộp file cơ sở với các file override và in ra kết quả sau khi đã thay thế mọi biến. Sau đó, bạn chạy file đã render đó. Bước bổ sung này rất hữu ích: stack đang chạy nằm trong một file mà bạn có thể đọc, nên nội dung của nó không thể thay đổi giữa chừng khi ai đó sửa env file hoặc khi bạn pull repository. cách nhiều Docker Compose file được gộp giải thích chi tiết các quy tắc override.
Export COMPOSE_FILE khiến các lệnh bên dưới sử dụng file đã render. Hãy lặp lại thao tác này trong mỗi shell mới; trong cron, truyền -f ~/gitops/erpnext.yaml một cách tường minh.
Chờ db khởi động và configurator thoát. Quá trình này mất vài giây. Sau đó, hãy tạo 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.comKiểm tra:
docker compose --project-name erpnext ps
docker compose --project-name erpnext exec backend bench --site erp.example.com list-appslist-apps phải in ra frappe và erpnext cùng với version của chúng. Một ps khỏe mạnh hiển thị 10 service ở trạng thái running và không có service nào ở trạng thái restarting.
Có 2 vấn đề thường xảy ra ở đây. --mariadb-user-host-login-scope=% cấp cho database user của site mới phạm vi host wildcard, nhờ đó user vẫn có thể đăng nhập khi Docker gán cho app container một địa chỉ khác. Nếu không có tùy chọn này, Frappe giới hạn user theo host đang kết nối tại thời điểm đó. App container kết nối đến MariaDB qua Docker network, nên nó được xem là một remote host; database user bị giới hạn vào localhost sẽ không thể đăng nhập từ đó. Tùy chọn này thay đổi database user của site, không thay đổi tài khoản root. Phạm vi % cho phép kết nối từ bất kỳ host nào có thể truy cập MariaDB, vì vậy hãy giữ database trên private Docker network.
Vấn đề thứ hai là tên site. Mặc định, frontend chọn site cần phục vụ dựa trên HTTP Host header, nên site được tạo với tên erpnext sẽ không truy cập được tại erp.example.com dù cả 2 site đều tồn tại. Hãy đặt tên site theo domain như trên, hoặc đặt FRAPPE_SITE_NAME_HEADER trong env file thành tên site rồi render lại compose file.
HTTPS và các điều kiện cần có trước khi hoạt động
Override compose.https.yaml chạy Traefik trên cổng 443, chuyển hướng cổng 80 sang đó và yêu cầu chứng chỉ từ Let's Encrypt. TLS (transport layer security) bảo vệ invoice và session cookie để chúng không truyền trên network dưới dạng plain text.
Hai điều kiện phải đúng, nếu không sẽ không có chứng chỉ nào được cấp. Bản ghi DNS A cho erp.example.com phải trỏ đến VPS từ trước. Cổng 80 và 443 phải có thể truy cập từ Internet, vì Let's Encrypt xác minh bạn kiểm soát hostname bằng HTTP-01 challenge trên cổng 80. Hãy kiểm tra network firewall của nhà cung cấp và firewall trên server. Đây là hai lớp kiểm soát riêng biệt, và firewall trong panel là thứ mọi người thường quên.
Chứng chỉ được lưu trong volume cert-data tại /letsencrypt/acme.json. Nếu browser hiển thị chứng chỉ mặc định thay vì chứng chỉ của bạn, hãy tìm tên proxy service trong docker compose --project-name erpnext ps rồi đọc log của service đó để tìm lỗi ACME (automatic certificate management environment). Bạn đang chạy các web app khác trên cùng server? một Traefik instance đứng trước nhiều ứng dụng Docker Compose hướng dẫn cách dùng chung proxy thay vì tranh chấp cổng 443. Ứng dụng thứ hai trên một server như thế này thường phục vụ khách hàng, và một bàn hỗ trợ Chatwoot tự host cũng nằm sau proxy đó, để những người xử lý invoice có thể trả lời email và chat của khách hàng tại cùng một nơi.
Email gửi đi, nếu không thì hóa đơn không bao giờ rời khỏi máy chủ
Đây là bước mà hầu hết hướng dẫn ERPNext bỏ qua, nhưng nó quyết định hệ thống có dùng được hay không. Nếu email gửi đi không hoạt động, không hóa đơn nào đến được khách hàng, email đặt lại mật khẩu không đến nơi, và báo cáo theo lịch không được gửi. Stack này không có mail server.
Không gửi email trực tiếp từ VPS qua port 25. Các nhà cung cấp như AWS mặc định chặn port 25 gửi đi. Một IP gửi mới với ít hoặc không có lịch sử gửi cũng làm tăng nguy cơ bị từ chối hoặc bị đưa vào spam. Cả hai kết quả này đều có thể tránh được. Hãy dùng authenticated relay qua port 587, đồng thời kiểm tra quy tắc outbound của nhà cung cấp trước: DigitalOcean mặc định chặn port 25, 465 và 587 trên Droplet.
Cách được hỗ trợ là dùng màn hình Email Account trong giao diện ERPNext. Màn hình này lưu password ở dạng mã hóa. Bạn cũng có thể ghi các key vào 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 lưu 587 dưới dạng số thay vì chuỗi "587". Đọc lại file và xác nhận hai giá trị đó không có dấu ngoặc kép:
docker compose --project-name erpnext exec backend \
cat sites/erp.example.com/site_config.jsonĐể lưu password ở dạng mã hóa, hãy cấu hình outgoing server, login và password cùng lúc trong màn hình Email Account. Trường password ở đó không thiết lập key site config mail_password riêng biệt.
Sau đó gửi một email thực tế. Tạo một Sales Invoice, gửi email đến địa chỉ do bạn kiểm soát, rồi theo dõi queue trong lúc thực hiện:
docker compose --project-name erpnext logs -f queue-shortEmail gửi đi là một background job. Vì vậy, nếu email không bao giờ đến nơi, log đó thường hiển thị job bị lỗi thay vì trình duyệt hiển thị lỗi. Đồng thời, hãy publish bản ghi SPF (sender policy framework) và DKIM (domainkeys identified mail) cho domain gửi email, rồi thêm chính sách DMARC. Nếu không có authentication, một hóa đơn hợp lệ về mặt kỹ thuật vẫn có nguy cơ bị từ chối hoặc bị đưa vào spam. Nếu muốn tự quản lý toàn bộ đường gửi, mail server Mailcow tự host cung cấp một relay do bạn kiểm soát, chạy trên một máy riêng với ERP.
Bản backup có thể restore thực tế
Chỉ dump database thì chưa phải là backup của ERPNext. File đính kèm và file private nằm trong thư mục sites, không nằm trong MariaDB. Nếu chỉ restore database, mọi purchase order đã upload sẽ trở thành broken link.
docker compose --project-name erpnext exec backend \
bench --site erp.example.com backup --with-filesLệnh này ghi 4 file vào sites/erp.example.com/private/backups trong volume sites:
- dump
-database.sql.gz - archive
-files.tarcủa các file public - archive
-private-files.tarcủa các file private - bản sao
-site_config_backup.jsoncủa cấu hình site
File thứ tư thường bị bỏ đi, nhưng lại là file gây ra vấn đề nghiêm trọng nhất. File này chứa encryption_key, key Frappe dùng để mã hóa các password được lưu trữ: thông tin đăng nhập tài khoản email, key của payment gateway và mọi secret của integration. Nếu restore database mà không có key tương ứng, site vẫn load bình thường nhưng gửi mail sẽ fail với lỗi:
frappe.exceptions.ValidationError: Encryption key is invalid! Please check site_config.jsonLuôn giữ cả 4 file cùng nhau.
Sau đó đưa chúng ra khỏi server. Backup nằm trong volume sẽ không tồn tại nếu server bị mất, và bench cũng tự xóa backup: mặc định, bench xóa các backup cũ hơn 23 giờ trong thư mục đó. Trước Frappe 16.20.0 và 15.114.0, mặc định này là 24 giờ. Key keep_backups_for_hours trong cấu hình site sẽ override giá trị đó.
docker compose --project-name erpnext cp \
backend:/home/frappe/frappe-bench/sites/erp.example.com/private/backups \
~/erpnext-backupsChạy lệnh này từ cron, rồi đẩy thư mục đến nơi bạn không trực tiếp quản trị. backup restic được mã hóa đến storage off-site là công cụ phù hợp vì nó mã hóa trước khi upload, còn restic check xác nhận repository vẫn có thể đọc được. Backup ERP là bản sao của toàn bộ sổ sách kế toán, nên phải được mã hóa khi lưu trữ trên phần cứng không phải server này.
Kiểm tra bản restore trước khi cần dùng
Một bản backup chưa được kiểm tra chỉ là phỏng đoán. Hãy restore vào một site thứ hai trên cùng máy chủ, tuyệt đối không restore vào site đang chạy thật.
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>'Copy encryption key từ config đã backup sang site được restore. Nếu không, các integration của site sẽ tiếp tục bị lỗi:
docker compose --project-name erpnext exec backend \
bench --site restore-test.example.com set-config encryption_key '<value from site_config_backup.json>'Bây giờ hãy kiểm tra bản restore như một kế toán sẽ kiểm tra. Mở báo cáo Accounts Receivable và so sánh số dư cuối kỳ với site đang chạy thật. Mở một purchase invoice gần đây và tải attachment của nó xuống. Một site hiển thị được trang đăng nhập hoàn toàn không chứng minh được gì.
Xóa site kiểm thử khi hoàn tất:
docker compose --project-name erpnext exec backend \
bench drop-site restore-test.example.comVì sao phải pin version chặt hơn với ERPNext
Trên một static site, image tag không được pin chỉ có nghĩa là service có thể bị restart ngoài dự kiến. Với ERPNext, điều đó có nghĩa là chạy migration cho schema. bench migrate viết lại các bảng database và có thể ghi lại dữ liệu document; thao tác này không có cách hoàn tác. Rollback là khôi phục từ backup, không phải một docker compose down.
Vì vậy, hãy pin tag. ERPNEXT_VERSION=v16.32.1 là release được pin trong pwd.yml của chính repository vào tháng 8 năm 2026. Vào 2026-11-16, cả pwd.yml và example.env đều pin v16.55.0. Không tiếp tục dùng một trong hai số này nếu chưa kiểm tra lại. Các release hiện tại được liệt kê trên trang releases của frappe/erpnext, còn các image tag đang tồn tại có trên Docker Hub. Hãy đọc ghi chú của version bạn định chuyển sang trước khi thực hiện.
Upgrade bắt đầu bằng backup và 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 onChỉnh sửa ERPNEXT_VERSION trong ~/gitops/erpnext.env, sau đó render, pull và 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 rất quan trọng vì migrate thay đổi schema trong khi chạy. Nếu user submit document vào một bảng đang migrate dở, bạn có thể phải sửa record thủ công.
Chuyển từng major version một và tạo backup giữa mỗi bước. Đọc hướng dẫn migration cho từng major version trước khi tiếp tục.
Repository cũng cung cấp overrides/compose.migrator.yaml. Thành phần này thêm một container chạy bench --site all migrate khi khởi động nếu có site và MIGRATE_SITES được bật, như mặc định. Cách này tiện. Nhưng một docker compose up có tag đã thay đổi cũng có thể migrate database production mà không có ai theo dõi. Với hệ thống nghiệp vụ, hãy chạy migrate như một quyết định bạn đã chủ động đưa ra vào sáng hôm đó.
Cứng hóa máy chủ lưu trữ hồ sơ khách hàng
Đổi mật khẩu Administrator ngay lần đăng nhập đầu tiên. File compose dùng để đánh giá đặt admin làm mật khẩu đó, và thói quen này có thể theo bạn vào môi trường production.
Đổi DB_PASSWORD khỏi giá trị 123 trong example.env. Giá trị đó xuất hiện dưới dạng plain text trong ~/gitops/erpnext.yaml đã render, vì vậy hãy chmod 600 file này và không đưa nó vào bất kỳ git repository nào. Nếu cần cách mạnh hơn, overrides/compose.mariadb-secrets.yaml sẽ đọc mật khẩu từ Docker secret file thay vì biến môi trường. xử lý env file và secret trong Docker Compose trình bày các đánh đổi.
Chỉ publish những gì bạn cần. Với HTTPS override, chỉ các cổng 80 và 443 được expose. Không thêm mapping ports vào service db chỉ để client database kết nối dễ hơn: việc đó đưa MariaDB lên public Internet. Thay vào đó, hãy dùng docker compose --project-name erpnext exec backend bench mariadb. Trên host, chỉ cho phép 22, 80 và 443, deny các cổng còn lại, đồng thời kiểm tra cả network firewall riêng của nhà cung cấp.
Bật xác thực hai yếu tố trong System Settings cho mọi account có role System Manager. Role này có thể thay đổi System Settings, vì vậy hãy xem đây là account administrator thay vì một tiện ích. Nếu bạn chạy nhiều app self-hosted, Authentik làm nhà cung cấp single sign-on self-hosted sẽ tốt hơn việc thêm một mật khẩu cho mỗi app.
Patch host và reboot để áp dụng các kernel update. Trước khi dựa vào việc stack tự khởi động lại, hãy kiểm tra file đã render để xác nhận policy restart trên từng service, vì stack không có policy này sẽ vẫn dừng sau lần reboot đó. làm cho Docker Compose stack tự khởi động lại sau reboot trình bày phần systemd.
Khi ERPNext không còn đáp ứng tốt trên một VPS
Một VPS có thể vận hành một công ty nhỏ trong thời gian dài. Các dấu hiệu cho thấy VPS đã không còn đủ khả năng:
- Các background job bị dồn lại, khiến email và tác vụ import đến muộn vài phút hoặc vài giờ.
docker inspectbáo cáo các container có"OOMKilled": truehoặc exit code 137.- Báo cáo trước đây chạy mất hai giây nay mất ba mươi giây, còn MariaDB là process chiếm CPU.
- Backup chạy đủ lâu để lần chạy này chồng lên lần chạy theo lịch tiếp theo.
Trước tiên, hãy cấp cho MariaDB các tài nguyên riêng, vì database và các Python worker đang cạnh tranh cùng một lượng memory, trong khi buffer pool là thành phần cần thêm memory. Tăng tài nguyên cho application server thường giúp ít hơn mọi người nghĩ. chạy database trong Docker hoặc trên host giải thích lựa chọn này, còn thiết lập giới hạn memory trong Docker Compose ngăn một container làm cạn tài nguyên của các container khác trong lúc bạn xử lý.
Sau đó, hãy thêm queue worker thay vì tăng web capacity. Các tác vụ chậm của ERPNext chạy ở background, gồm tạo report và import hàng loạt. Nhiều worker hơn cần thêm dư địa về CPU và memory; thêm container vào một VPS vốn đã bão hòa không tạo thêm capacity.
FAQ
ERPNext cần bao nhiêu RAM trên VPS?
Để đánh giá, hãy bắt đầu với 4 GB và 2 vCPU. Với công ty sử dụng hằng ngày, hãy dự trù 8 GB, 4 vCPU và 100 GB SSD. Khi thiếu bộ nhớ, kernel out of memory killer có thể dừng các container. docker inspect báo tình trạng này là "OOMKilled": true với exit code 137. Đây chỉ là mức khởi điểm, không phải số đo thực tế. Hãy theo dõi mức sử dụng bộ nhớ của hệ thống trong tháng đầu tiên.
Tôi có thể chạy pwd.yml trong production không?
Không. README của project mô tả file này chỉ dành cho việc đánh giá trong thời gian ngắn và lưu ý rằng bạn không thể cài custom app vào đó. Hãy dùng compose.yaml với các override cho MariaDB, Redis và HTTPS, render chúng thành một file duy nhất bằng docker compose config, rồi chạy file đó.
Tại sao site ERPNext không truy cập được ngay sau khi tôi tạo?
Mặc định, frontend chọn site cần phục vụ dựa trên HTTP Host header. Vì vậy, tên site phải khớp với domain trong trình duyệt. Site được tạo với tên erpnext sẽ không được phục vụ tại erp.example.com. Bạn có thể tạo site với domain làm tên, hoặc đặt FRAPPE_SITE_NAME_HEADER trong env file thành tên site, render lại compose file rồi restart stack.
Một bản backup ERPNext phải có những gì?
Có 4 file, được giữ cùng nhau: dump -database.sql.gz, các archive -files.tar và -private-files.tar, cùng bản sao config -site_config_backup.json. Chạy bench --site erp.example.com backup --with-files sẽ tạo đủ cả 4 file. Bản sao config chứa encryption_key. Vì vậy, restore không có file này sẽ khiến các integration password đã lưu không thể giải mã. Lỗi này được hiển thị là Encryption key is invalid! Please check site_config.json.
Làm thế nào để upgrade ERPNext mà không làm hỏng dữ liệu?
Backup bằng --with-files, bật maintenance mode, thay đổi ERPNEXT_VERSION trong env file, render lại compose file, pull, khởi động stack, sau đó chạy bench --site erp.example.com migrate và tắt maintenance mode. Mỗi lần chỉ chuyển lên 1 major version. Hãy đọc release notes trước vì migrate sẽ ghi lại schema và document data mà không có cách hoàn tác. Rollback nghĩa là restore bản backup bạn đã tạo lúc bắt đầu.