Cara Menjalankan ERPNext di VPS dengan Docker
Panduan self-host ERPNext di VPS dengan Docker: kebutuhan server, 11 container, TLS, email keluar, pin versi, serta uji pemulihan backup.
Apa yang Anda setujui untuk dijalankan
Menjalankan ERPNext secara self-hosted pada VPS adalah pekerjaan operasional, bukan instalasi dengan satu perintah. Stack Docker Compose resmi terdiri dari sebelas container dan menyimpan buku besar umum serta data pelanggan Anda. Karena itu, standar untuk semua langkah berikut harus lebih tinggi: backup belum dapat disebut backup sampai Anda berhasil memulihkannya, dan tag image yang tidak dipatok versinya dapat menyebabkan migrasi skema yang tidak direncanakan.
Beberapa nama akan muncul di seluruh panduan ini. ERPNext adalah aplikasi bisnisnya. Frappe adalah framework Python yang mendasarinya. Bench adalah alat command line untuk mengelola site, dan sudah terpasang di dalam container. Site adalah satu tenant: satu database MariaDB dan satu direktori file yang diunggah. Hampir semua perintah di sini dijalankan bench di dalam container backend untuk satu site bernama tertentu.
Panduan ini menggunakan repository frappe_docker, yaitu deployment yang dikelola oleh proyek tersebut. Semua perintah di bawah telah diperiksa terhadap repository itu pada Agustus 2026. Jika Docker Compose masih baru bagi Anda, menjalankan Docker Compose pada VPS membahas dasar-dasar yang diasumsikan oleh panduan ini.
Berapa kapasitas VPS yang dibutuhkan ERPNext?
Data di balik grafik ini
[
{
"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
}
]Untuk evaluasi, mulai dengan 2 vCPU dan 4 GB RAM. Itu adalah tingkat evaluasi. Angka ini merupakan titik awal, bukan hasil pengukuran dari panduan ini. Volume dokumen Anda sendiri yang menentukan angka sebenarnya. Baris terakhir sama sekali bukan batas minimum resmi. Baris tersebut memberi ruang memori yang lebih besar, bukan jaminan bahwa memori tidak akan pernah habis.
Bersikaplah realistis terhadap paket VPS kecil. VPS 1 GB atau 2 GB menyisakan sedikit ruang untuk sepuluh container yang berjalan lama, buffer pool MariaDB, dan worker Python yang sedang membuat laporan. Saat memori tertekan, kernel dapat menghentikan container melalui out-of-memory killer, lalu docker inspect pada container tersebut menampilkan "OOMKilled": true dengan exit code 137. Worker yang dihentikan di tengah job dapat meninggalkan dokumen yang sudah dikirim dengan pekerjaan latar belakang yang belum selesai.
Untuk perusahaan yang menggunakan ERPNext setiap hari, mulailah merencanakan 8 GB RAM, 4 vCPU, dan 100 GB SSD, lalu uji workload Anda. RAM biasanya habis lebih dahulu. Penggunaan disk bertambah lebih cepat dari perkiraan karena setiap lampiran dan setiap backup lokal disimpan pada volume yang sama dengan database.
Sebelas container dan fungsi masing-masing
Jalankan docker compose ps setelah stack aktif dan sepuluh container berjalan. Satu container lainnya, configurator, menjalankan tugasnya satu kali lalu berhenti. Inilah asal total sebelas container.
backendmenjalankan aplikasi Frappe dengan gunicorn.benchberada di container ini.frontendadalah nginx. Container ini menyajikan aset statis dan meneruskan permintaan lainnya ke backend.queue-shortdanqueue-longadalah worker RQ (Redis Queue). Keduanya menjalankan pekerjaan latar belakang, seperti email keluar, impor, dan pembuatan laporan.schedulermenjalankan pekerjaan berbasis waktu, termasuk laporan terjadwal dan dokumen pengulangan otomatis.websocketadalah proses socket.io yang menangani pembaruan langsung di browser.dbadalah MariaDB.redis-cachedanredis-queueadalah dua instance Redis terpisah. Salah satunya digunakan untuk cache, dan yang lainnya untuk antrean pekerjaan.proxyadalah Traefik, yang ditambahkan oleh override HTTPS. Traefik menggunakan port 80 dan 443 serta mengambil sertifikat.
Pembagian ini penting untuk dipahami karena membantu menentukan log yang harus dibaca. Email yang macet menunjukkan masalah pada worker antrean, sehingga docker compose logs -f queue-short adalah perintah yang tepat. Halaman yang dimuat tetapi lencana notifikasinya tidak pernah diperbarui menunjukkan masalah websocket. Membaca log backend untuk salah satu masalah tersebut hanya membuang waktu.
Instal dengan file compose production, bukan demo
Repository ini menyediakan pwd.yml, dan README menjelaskannya secara tegas: "Setup ini hanya ditujukan untuk evaluasi jangka pendek. Anda tidak dapat menginstal aplikasi kustom pada setup ini." Gunakan setup tersebut untuk mencoba ERPNext selama satu sore. Jangan gunakan setup ini untuk menjalankan operasional perusahaan.
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.envBuka ~/gitops/erpnext.env dan ubah empat nilai. ERPNEXT_VERSION menetapkan tag image. DB_PASSWORD disediakan sebagai 123 dalam file contoh. SITES_RULE adalah aturan routing Traefik, sedangkan LETSENCRYPT_EMAIL menetapkan email akun ACME. Let’s Encrypt menghentikan email pemberitahuan kedaluwarsa pada 4 Juni 2025, jadi pantau kedaluwarsa sertifikat secara terpisah.
ERPNEXT_VERSION=v16.32.1
DB_PASSWORD=<a long random password>
SITES_RULE=Host(`erp.example.com`)
LETSENCRYPT_EMAIL=ops@example.comSekarang render satu file compose, lalu jalankan file tersebut.
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 tidak memulai apa pun. Perintah ini menggabungkan file dasar dengan override, lalu mencetak hasilnya setelah semua variabel disubstitusikan. Selanjutnya, jalankan file hasil render tersebut. Langkah tambahan ini penting: stack yang sedang berjalan menggunakan satu file yang dapat dibaca, sehingga file tersebut tidak berubah saat seseorang mengedit file env atau saat Anda melakukan pull repository. cara beberapa file Docker Compose digabungkan menjelaskan aturan override secara terperinci.
Ekspor COMPOSE_FILE membuat perintah di bawah menggunakan file hasil render. Ulangi ekspor ini di setiap shell baru; dalam cron, teruskan -f ~/gitops/erpnext.yaml secara eksplisit.
Tunggu hingga db dimulai dan configurator selesai, yang memerlukan waktu beberapa detik, lalu buat site tersebut.
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.comPeriksa hasilnya:
docker compose --project-name erpnext ps
docker compose --project-name erpnext exec backend bench --site erp.example.com list-appslist-apps seharusnya mencetak frappe dan erpnext beserta versinya. ps yang sehat menampilkan sepuluh service dalam status running dan tidak ada yang berstatus restarting.
Ada dua hal yang sering menyebabkan masalah di sini. --mariadb-user-host-login-scope=% memberikan cakupan host wildcard kepada user database site baru, sehingga user tersebut tetap dapat login saat Docker menetapkan alamat yang berbeda untuk container aplikasi. Tanpa opsi ini, Frappe membatasi user ke host yang sedang terhubung. Container aplikasi mengakses MariaDB melalui jaringan Docker, sehingga koneksinya berasal dari host jarak jauh. Akibatnya, user database yang dibatasi ke localhost tidak dapat login dari sana. Opsi ini mengubah user database milik site, bukan account root. Cakupan % mengizinkan koneksi dari host mana pun yang dapat menjangkau MariaDB, jadi pertahankan database pada jaringan Docker privat.
Masalah kedua adalah nama site. Secara default, frontend memilih site yang akan dilayani berdasarkan header HTTP Host. Karena itu, site yang dibuat sebagai erpnext tidak dapat diakses melalui erp.example.com, meskipun keduanya ada. Gunakan domain sebagai nama site, seperti di atas, atau tetapkan FRAPPE_SITE_NAME_HEADER dalam file env ke nama site, lalu render kembali file compose.
HTTPS dan prasyarat agar dapat berfungsi
Override compose.https.yaml menjalankan Traefik pada port 443, mengalihkan port 80 ke port tersebut, dan meminta sertifikat dari Let's Encrypt. TLS (keamanan lapisan transport) menjaga invoice dan cookie sesi agar tidak dikirim dalam teks biasa melalui jaringan.
Dua hal harus terpenuhi. Jika tidak, sertifikat tidak akan pernah diterbitkan. A record DNS untuk erp.example.com harus sudah mengarah ke VPS. Port 80 dan 443 harus dapat dijangkau dari Internet karena Let's Encrypt memverifikasi bahwa Anda mengendalikan nama tersebut melalui tantangan HTTP-01 pada port 80. Periksa firewall jaringan provider dan firewall pada server. Keduanya merupakan kontrol yang terpisah, dan firewall pada panel sering terlupakan.
Sertifikat tersimpan di volume cert-data pada /letsencrypt/acme.json. Jika browser menampilkan sertifikat default, bukan sertifikat Anda, cari nama service proxy di docker compose --project-name erpnext ps, lalu baca log-nya untuk menemukan error ACME (automatic certificate management environment). Menjalankan aplikasi web lain pada server yang sama? satu instance Traefik di depan beberapa aplikasi Docker Compose menunjukkan cara berbagi proxy tanpa berebut port 443. Aplikasi kedua pada server seperti ini sering ditujukan untuk pelanggan, dan meja bantuan Chatwoot yang di-host sendiri berada di belakang proxy yang sama. Dengan demikian, orang yang menangani invoice juga dapat menjawab email dan chat pelanggan di satu tempat.
Email keluar, atau faktur tidak pernah meninggalkan server
Ini adalah langkah yang sering dilewati panduan ERPNext. Langkah ini menentukan apakah sistem benar-benar dapat digunakan. Tanpa email keluar yang berfungsi, tidak ada faktur yang sampai ke pelanggan, tidak ada email pengaturan ulang kata sandi yang diterima, dan tidak ada laporan terjadwal yang dikirimkan. Stack ini tidak menyertakan server email.
Jangan mencoba mengirim email langsung dari VPS melalui port 25. Provider seperti AWS secara default memblokir port keluar 25. Selain itu, IP pengirim baru dengan sedikit atau tanpa riwayat pengiriman meningkatkan risiko penolakan atau masuk ke folder spam. Kedua hal tersebut tidak selalu terjadi. Gunakan relay terautentikasi pada port 587. Periksa terlebih dahulu aturan trafik keluar dari provider Anda: DigitalOcean secara default memblokir port 25, 465, dan 587 pada Droplet.
Metode yang didukung adalah layar Email Account pada antarmuka ERPNext. Layar ini menyimpan kata sandi dalam bentuk terenkripsi. Anda juga dapat menulis key tersebut ke konfigurasi site:
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 menyimpan 587 sebagai angka, bukan string "587". Baca kembali file tersebut dan pastikan kedua nilai itu tidak diapit tanda kutip:
docker compose --project-name erpnext exec backend \
cat sites/erp.example.com/site_config.jsonUntuk menyimpan kata sandi secara terenkripsi, konfigurasikan server keluar, login, dan kata sandi secara bersamaan pada layar Email Account. Field kata sandi tersebut tidak menetapkan key konfigurasi site mail_password yang terpisah.
Selanjutnya, kirim pesan sungguhan. Buat Sales Invoice, kirimkan melalui email ke alamat yang Anda kendalikan, lalu pantau antrean saat proses berlangsung:
docker compose --project-name erpnext logs -f queue-shortEmail keluar merupakan background job. Karena itu, pesan yang tidak pernah tiba biasanya muncul sebagai failed job di log tersebut, bukan sebagai error pada browser. Publikasikan juga record SPF (sender policy framework) dan DKIM (domainkeys identified mail) untuk domain pengirim, lalu tambahkan kebijakan DMARC. Tanpa autentikasi, faktur yang secara teknis benar tetap berisiko ditolak atau masuk ke folder spam. Jika Anda ingin mengelola seluruh jalur pengiriman sendiri, server email Mailcow yang di-host sendiri menyediakan relay yang Anda kendalikan pada server terpisah dari ERP.
Backup yang benar-benar dapat dipulihkan
Dump database saja bukanlah backup ERPNext. Lampiran dan file privat berada di direktori sites, bukan di MariaDB. Jika hanya database yang dipulihkan, setiap purchase order yang diunggah akan kembali sebagai tautan yang rusak.
docker compose --project-name erpnext exec backend \
bench --site erp.example.com backup --with-filesPerintah tersebut menulis empat file ke dalam sites/erp.example.com/private/backups pada volume sites:
- dump
-database.sql.gz - arsip file publik
-files.tar - arsip file privat
-private-files.tar - salinan konfigurasi site
-site_config_backup.json
File keempat sering dibuang, padahal file inilah yang paling bermasalah jika hilang. File tersebut berisi encryption_key, yaitu kunci yang digunakan Frappe untuk mengenkripsi password yang tersimpan: kredensial akun email, kunci payment gateway, dan setiap secret integrasi. Jika database dipulihkan tanpa kunci yang sesuai, site tetap dimuat secara normal, tetapi pengiriman email gagal dengan:
frappe.exceptions.ValidationError: Encryption key is invalid! Please check site_config.jsonSimpan keempat file tersebut secara bersamaan.
Selanjutnya, pindahkan backup keluar dari server. Backup yang disimpan di dalam volume tidak akan bertahan jika server rusak, dan bench juga akan menghapusnya: secara default, bench menghapus backup yang berusia lebih dari 23 jam dari direktori tersebut. Sebelum Frappe 16.20.0 dan 15.114.0, nilai default ini adalah 24 jam. Kunci keep_backups_for_hours dalam konfigurasi site dapat menggantikan nilai tersebut.
docker compose --project-name erpnext cp \
backend:/home/frappe/frappe-bench/sites/erp.example.com/private/backups \
~/erpnext-backupsJalankan perintah tersebut dari cron, lalu unggah direktori itu ke lokasi yang tidak Anda administrasikan. backup restic terenkripsi ke penyimpanan di luar lokasi adalah alat yang tepat karena mengenkripsi data sebelum diunggah, dan restic check membuktikan bahwa repository masih dapat dibaca. Backup ERP adalah salinan seluruh buku besar Anda, sehingga harus disimpan dalam keadaan terenkripsi pada perangkat keras yang bukan server ini.
Uji pemulihan sebelum diperlukan
Cadangan yang belum diuji hanyalah perkiraan. Uji cadangan tersebut pada site kedua di server yang sama, bukan pada site aktif.
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>'Salin kunci enkripsi dari konfigurasi yang dicadangkan ke site hasil pemulihan. Jika tidak, integrasi pada site tersebut tetap bermasalah:
docker compose --project-name erpnext exec backend \
bench --site restore-test.example.com set-config encryption_key '<value from site_config_backup.json>'Sekarang periksa hasil pemulihan seperti yang dilakukan seorang akuntan. Buka laporan Accounts Receivable dan bandingkan saldo akhir dengan site aktif. Buka faktur pembelian terbaru dan unduh lampirannya. Site yang hanya dapat menampilkan halaman login sama sekali belum membuktikan bahwa pemulihan berhasil.
Hapus site pengujian setelah selesai:
docker compose --project-name erpnext exec backend \
bench drop-site restore-test.example.comMengapa version pinning lebih penting untuk ERPNext
Pada situs statis, tag image yang tidak dipin berarti restart yang tidak terduga. Pada ERPNext, artinya migrasi schema. bench migrate menulis ulang tabel database dan dapat menulis ulang data dokumen, serta tidak memiliki fitur undo. Rollback dilakukan dengan memulihkan backup, bukan dengan docker compose down.
Karena itu, pin tag tersebut. ERPNEXT_VERSION=v16.32.1 adalah release yang dipin di pwd.yml milik repository pada Agustus 2026. Pada 2026-11-16, pwd.yml dan example.env sama-sama mem-pin v16.55.0. Jangan gunakan kembali nomor mana pun tanpa memeriksanya. Daftar release terbaru tersedia di halaman release frappe/erpnext, sedangkan tag image yang tersedia tercantum di Docker Hub. Baca catatan untuk versi yang akan Anda gunakan sebelum memulai upgrade.
Upgrade dimulai dengan backup dan 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 onEdit ERPNEXT_VERSION di ~/gitops/erpnext.env, lalu lakukan render, pull, dan migrasi.
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 penting karena migrate mengubah schema saat berjalan. Jika pengguna mengirimkan dokumen ke tabel yang baru dimigrasikan sebagian, Anda harus memperbaiki record secara manual.
Lakukan upgrade satu major version setiap kali, dengan backup di antara setiap langkah. Periksa panduan migrasi untuk setiap major version sebelum melanjutkan.
Repository tersebut juga menyediakan overrides/compose.migrator.yaml, yang menambahkan container untuk menjalankan bench --site all migrate saat start jika terdapat site dan MIGRATE_SITES diaktifkan, seperti pada konfigurasi default. Fitur ini praktis. Namun, artinya docker compose up dengan tag yang berubah dapat memigrasikan database production Anda tanpa pengawasan. Pada sistem bisnis, jalankan migrate sebagai keputusan yang Anda ambil pada hari itu.
Mengeraskan keamanan server yang menyimpan data pelanggan
Ubah kata sandi Administrator saat login pertama. File compose evaluasi menyediakan admin sebagai kata sandi tersebut, dan kebiasaan ini dapat terbawa ke lingkungan produksi.
Ubah DB_PASSWORD dari 123 dalam example.env. Nilai tersebut akan muncul dalam ~/gitops/erpnext.yaml yang dirender dalam teks biasa, jadi chmod 600 file tersebut dan jangan menyimpannya di repositori git mana pun. Untuk keamanan yang lebih baik, overrides/compose.mariadb-secrets.yaml membaca kata sandi dari file Docker secret, bukan dari variabel lingkungan. menangani file env dan secret di Docker Compose menjelaskan berbagai komprominya.
Publikasikan hanya yang diperlukan. Dengan override HTTPS, hanya port 80 dan 443 yang diekspos. Jangan menambahkan pemetaan ports ke service db agar client database lebih mudah terhubung: tindakan tersebut menempatkan MariaDB di Internet publik. Gunakan docker compose --project-name erpnext exec backend bench mariadb sebagai gantinya. Di host, izinkan 22, 80, dan 443, tolak port lainnya, serta periksa firewall jaringan terpisah milik provider.
Aktifkan autentikasi dua faktor di System Settings untuk setiap akun yang memiliki peran System Manager. Peran tersebut dapat mengubah System Settings, jadi perlakukan akun itu sebagai akun administrator, bukan sekadar akun untuk kemudahan. Jika Anda menjalankan beberapa aplikasi self-hosted, Authentik sebagai penyedia single sign-on self-hosted lebih baik daripada menambahkan satu kata sandi lagi untuk setiap aplikasi.
Terapkan patch pada host dan lakukan reboot untuk pembaruan kernel. Sebelum mengandalkan stack agar berjalan kembali, periksa file yang dirender untuk memastikan setiap service memiliki kebijakan restart, karena stack tanpa kebijakan tersebut akan tetap berhenti setelah reboot. membuat stack Docker Compose berjalan kembali setelah reboot membahas konfigurasi systemd.
Saat ERPNext tidak lagi nyaman dijalankan pada satu VPS
Satu VPS dapat menjalankan kebutuhan perusahaan kecil dalam waktu lama. Berikut tanda-tanda bahwa kapasitasnya tidak lagi memadai:
- Pekerjaan latar belakang menumpuk sehingga email dan proses impor tiba beberapa menit atau beberapa jam lebih lambat.
docker inspectmelaporkan container dengan"OOMKilled": trueatau exit code 137.- Laporan yang sebelumnya selesai dalam dua detik kini memerlukan tiga puluh detik, dan MariaDB menjadi proses yang menggunakan CPU.
- Proses pencadangan berlangsung sangat lama sehingga satu proses tumpang tindih dengan jadwal berikutnya.
Mulailah dengan menyediakan resource khusus untuk MariaDB karena database dan worker Python menggunakan memori yang sama untuk bersaing, sementara buffer pool membutuhkan lebih banyak memori. Menambah kapasitas application server memberikan dampak yang lebih kecil daripada perkiraan banyak orang. menjalankan database di Docker atau pada host membahas pilihan tersebut, sedangkan menetapkan batas memori di Docker Compose mencegah satu container menghabiskan resource container lain selama Anda melakukan penyesuaian.
Setelah itu, tambahkan queue worker, bukan kapasitas web. Pekerjaan ERPNext yang lambat berjalan di latar belakang, seperti pembuatan laporan dan impor massal. Worker tambahan memerlukan ruang CPU dan memori; menambahkan container ke VPS yang sudah jenuh tidak menambah kapasitas.
FAQ
Berapa RAM yang dibutuhkan ERPNext pada VPS?
Untuk evaluasi, mulai dengan 4 GB dan 2 vCPU. Untuk perusahaan yang menggunakannya setiap hari, siapkan 8 GB dan 4 vCPU dengan SSD berkapasitas 100 GB. Saat memori tidak mencukupi, kernel dapat menghentikan container melalui out-of-memory killer. docker inspect melaporkan kondisi ini sebagai "OOMKilled": true dengan exit code 137. Nilai ini adalah titik awal, bukan hasil pengukuran. Pantau penggunaan memori Anda sendiri selama bulan pertama.
Dapatkah saya menjalankan pwd.yml di production?
Tidak. README proyek menjelaskan bahwa file tersebut hanya ditujukan untuk evaluasi jangka pendek dan mencatat bahwa Anda tidak dapat menginstal aplikasi kustom ke dalamnya. Gunakan compose.yaml dengan override MariaDB, Redis, dan HTTPS, render semuanya menjadi satu file dengan docker compose config, lalu jalankan file tersebut.
Mengapa site ERPNext saya tidak dapat diakses segera setelah dibuat?
Secara default, frontend menentukan site yang akan dilayani berdasarkan header HTTP Host. Karena itu, nama site harus sama dengan domain pada browser. Site yang dibuat sebagai erpnext tidak dilayani pada erp.example.com. Buat site menggunakan domain sebagai namanya, atau tetapkan FRAPPE_SITE_NAME_HEADER dalam file env ke nama site, render ulang file compose, lalu restart stack.
Apa saja yang harus ada dalam backup ERPNext?
Empat file yang disimpan bersama: dump -database.sql.gz, arsip -files.tar dan -private-files.tar, serta salinan konfigurasi -site_config_backup.json. Menjalankan bench --site erp.example.com backup --with-files menghasilkan keempat file tersebut. Salinan konfigurasi berisi encryption_key. Karena itu, restore tanpa file tersebut membuat password integrasi yang tersimpan tidak dapat didekripsi, dan kondisi ini muncul sebagai Encryption key is invalid! Please check site_config.json.
Bagaimana cara melakukan upgrade ERPNext tanpa merusak data?
Buat backup dengan --with-files, aktifkan maintenance mode, ubah ERPNEXT_VERSION dalam file env, render ulang file compose, lakukan pull, jalankan stack, kemudian jalankan bench --site erp.example.com migrate dan nonaktifkan maintenance mode. Lakukan upgrade satu major version pada satu waktu dan baca release notes terlebih dahulu, karena migrate menulis ulang schema dan data dokumen tanpa opsi undo. Untuk rollback, restore backup yang dibuat pada awal proses.