VPS Üzerinde Docker ile ERPNext Kurulumu
ERPNext uygulamasını kendi VPS sunucunuzda Docker ile barındırın. On bir container yapısı, TLS yapılandırması, e-posta ayarları ve sürüm sabitleme ile güvenli kurulum rehberi.
Çalıştırmayı taahhüt ettiğiniz sistem
ERPNext uygulamasını bir VPS üzerinde kendi sunucunuzda barındırmak (self-hosting), tek komutla kurulumdan ziyade bir operasyonel yönetim işidir. Resmi Docker Compose yığını on bir adet container içerir ve genel muhasebe kayıtlarınız ile müşteri verilerinizi barındırır. Bu durum, aşağıda belirtilen her şey için standartları yükseltir: bir yedek, geri yükleme testi yapılmadığı sürece yedek sayılmaz; sabitlenmemiş bir image etiketi ise gerçekleşmeyi bekleyen bir şema migrasyonu riskidir.
Kılavuz boyunca birkaç isim öne çıkmaktadır. ERPNext, iş uygulamasıdır. Frappe, onun altındaki Python çatısıdır. Bench, siteleri yöneten ve container'ların içinde halihazırda kurulu olan komut satırı aracıdır. Bir site, tek bir kiracıyı ifade eder: bir adet MariaDB veritabanı ve bir adet yüklenen dosyalar dizini. Buradaki neredeyse her komut, bench içinde, backend container'ı üzerinde, belirli bir site için çalıştırılır.
Bu kılavuz, projenin sürdürdüğü dağıtım olan frappe_docker deposunu kullanır. Aşağıdaki her komut, Ağustos 2026 itibarıyla bu depo üzerinde doğrulanmıştır. Eğer Docker Compose sizin için yeniyse, bir VPS üzerinde Docker Compose çalıştırma başlıklı içerik, bu kılavuzun temel aldığı bilgileri kapsamaktadır.
ERPNext ne kadar VPS kaynağına ihtiyaç duyar?
Bu grafiğin arkasındaki veriler
[
{
"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
}
]Değerlendirme amaçlı kurulumlar için 2 vCPU ve 4 GB RAM ile başlayın. Bu, değerlendirme katmanıdır. Bunlar başlangıç noktalarıdır; bu rehberden alınan kesin ölçümler değildir ve gerçek ihtiyaç miktarı belge hacminize göre belirlenir. Son satır, yayınlanmış bir minimum değer değildir. Sadece daha fazla bellek alanı sağlar, belleğin asla tükenmeyeceğinin garantisi değildir.
Küçük planlar konusunda gerçekçi olun. 1 GB veya 2 GB RAM'e sahip bir VPS; on adet uzun süreli çalışan container, MariaDB tampon havuzu ve rapor oluşturan bir Python işçisi için çok az alan bırakır. Bellek baskısı altında, çekirdeğin "out of memory killer" mekanizması bir container'ı durdurabilir ve bu durumda docker inspect komutu, "OOMKilled": true çıktısını 137 çıkış koduyla gösterir. İşin ortasında sonlandırılan bir süreç, gönderilen bir belgenin arka plan işlemlerinin yarım kalmasına neden olur.
ERPNext'i günlük olarak kullanan bir şirket için 8 GB RAM ve 4 vCPU ile 100 GB SSD kapasitesini planlayın ve ardından iş yükünüzü test edin. RAM ilk tükenen kaynaktır. Disk alanı, insanların beklediğinden daha hızlı dolar; çünkü her ek dosya ve her yerel yedekleme, veritabanı ile aynı birim üzerinde saklanır.
On bir container ve her birinin işlevi
Stack ayağa kalktıktan ve on container çalışır duruma geldikten sonra docker compose ps komutunu çalıştırın. Bir diğeri olan configurator, görevini bir kez yapıp çıkar; toplam on bir sayısına bu şekilde ulaşılır.
backend, Frappe uygulamasını gunicorn altında çalıştırır.benchburada barınır.frontend, nginx servisidir. Statik varlıkları sunar ve diğer tüm istekleri arka uca iletir.queue-shortvequeue-long, RQ (Redis Queue) işçileridir. Giden e-postalar, içe aktarma işlemleri ve rapor oluşturma gibi arka plan görevlerini yürütürler.scheduler, zamanlanmış raporlar ve otomatik tekrarlanan belgeler dahil olmak üzere zamana dayalı görevleri tetikler.websocket, tarayıcıdaki canlı güncellemelerin arkasındaki socket.io sürecidir.db, MariaDB veritabanıdır.redis-cacheveredis-queue, biri önbellek diğeri iş kuyruğu için olmak üzere iki ayrı Redis örneğidir.proxy, HTTPS geçersiz kılma (override) ile eklenen Traefik'tir. 80 ve 443 numaralı portları yönetir ve sertifikaları temin eder.
Bu ayrımı öğrenmek faydalıdır, çünkü hangi günlüğü okumanız gerektiğini belirler. Takılan bir e-posta kuyruk işçisi sorunudur, bu yüzden doğru komut docker compose logs -f queue-short'dır. Yüklenen ancak bildirim rozetini güncellemeyen bir sayfa ise websocket sorunudur. Her iki durum için de backend günlüklerini okumak zaman kaybına yol açar.
Demo yerine üretim compose dosyalarıyla kurulum yapın
Depo pwd.yml ile birlikte gelir ve README dosyası bu konuda nettir: "Bu kurulum yalnızca kısa süreli değerlendirme amaçlıdır. Bu kuruluma özel uygulamalar yükleyemezsiniz." Bunu ERPNext'i bir öğleden sonra incelemek için kullanın. Bir şirketi bunun üzerinde çalıştırmayı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.env~/gitops/erpnext.env dosyasını açın ve dört değeri değiştirin. ERPNEXT_VERSION, image etiketini sabitler. DB_PASSWORD, örnek dosyada 123 olarak gelir. SITES_RULE, Traefik yönlendirme kuralıdır ve LETSENCRYPT_EMAIL, ACME hesap e-postasını sağlar. Let’s Encrypt, 4 Haziran 2025 tarihinde süresi dolan bildirim e-postalarını sonlandırdı, bu nedenle sertifika geçerlilik süresini ayrı olarak izleyin.
ERPNEXT_VERSION=v16.32.1
DB_PASSWORD=<a long random password>
SITES_RULE=Host(`erp.example.com`)
LETSENCRYPT_EMAIL=ops@example.comŞimdi tek bir compose dosyası oluşturun ve ardından başlatın.
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 hiçbir şeyi başlatmaz. Temel dosyayı geçersiz kılmalarla (overrides) birleştirir ve tüm değişkenlerin halihazırda yerine yerleştirildiği sonucu yazdırır. Ardından bu oluşturulan dosyayı çalıştırırsınız. Bu fazladan adım işe yarar: çalışan yığın, okuyabileceğiniz tek bir dosyadır; bu nedenle biri env dosyasını düzenlediğinde veya depoyu güncellediğinizde (pull) sizin bilginiz dışında değişemez. birden fazla Docker Compose dosyasının nasıl birleştiği konusu, geçersiz kılma kurallarını ayrıntılı olarak açıklar.
COMPOSE_FILE dışa aktarma işlemi, aşağıdaki komutların oluşturulan dosyayı kullanmasını sağlar. Bunu her yeni kabukta (shell) tekrarlayın; cron içinde -f ~/gitops/erpnext.yaml değerini açıkça belirtin.
db servisinin başlamasını ve configurator servisinin çıkış yapmasını bekleyin; bu işlem birkaç saniye sürer, ardından siteyi oluşturun.
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.comKontrol edin:
docker compose --project-name erpnext ps
docker compose --project-name erpnext exec backend bench --site erp.example.com list-appslist-apps, frappe ve erpnext değerlerini sürümleriyle birlikte yazdırmalıdır. Sağlıklı bir ps, on servisi running durumunda ve hiçbirini restarting durumunda göstermemelidir.
Burada genellikle iki şey ters gider. --mariadb-user-host-login-scope=%, yeni sitenin veritabanı kullanıcısına joker karakterli bir host kapsamı verir; böylece Docker, uygulama container'ına farklı bir adres atadığında kullanıcı hala giriş yapabilir. Bu olmadan Frappe, kullanıcıyı mevcut bağlantı kuran host ile sınırlar. Uygulama container'ı, MariaDB'ye Docker ağı üzerinden ulaşır, bu yüzden uzak bir host olarak gelir ve localhost ile sınırlandırılmış bir veritabanı kullanıcısı oradan giriş yapamaz. Bu seçenek, sitenin veritabanı kullanıcısını değiştirir, root hesabını değil. % kapsamı, MariaDB'ye ulaşabilen herhangi bir hosttan bağlantıya izin verir, bu nedenle veritabanını özel Docker ağında tutun.
İkincisi ise site adıdır. Frontend, varsayılan olarak hangi siteye hizmet vereceğini HTTP Host başlığından seçer; bu nedenle erpnext olarak oluşturulan bir siteye, her ikisi de mevcut olsa bile erp.example.com üzerinden ulaşılamaz. Siteyi yukarıdaki gibi alan adına göre adlandırın veya env dosyasında FRAPPE_SITE_NAME_HEADER değerini site adına ayarlayıp compose dosyasını yeniden oluşturun.
HTTPS ve çalışması için gereken ön koşullar
compose.https.yaml geçersiz kılma ayarı, Traefik'i 443 numaralı portta çalıştırır, 80 numaralı portu buraya yönlendirir ve Let's Encrypt üzerinden sertifika talep eder. TLS (transport layer security), fatura verilerinin ve oturum çerezlerinin ağ üzerinden düz metin olarak iletilmesini engelleyen mekanizmadır.
Sertifikanın düzenlenebilmesi için iki koşulun sağlanması gerekir. erp.example.com için tanımlanan DNS A kaydı, VPS adresini işaret etmelidir. 80 ve 443 numaralı portlar internete açık olmalıdır; çünkü Let's Encrypt, alan adı üzerindeki kontrolünüzü 80 numaralı port üzerinden HTTP-01 challenge ile doğrular. Sunucu üzerindeki güvenlik duvarının yanı sıra servis sağlayıcınızın ağ güvenlik duvarını da kontrol edin. Bunlar birbirinden bağımsız kontrollerdir ve genellikle panel üzerindeki güvenlik duvarı gözden kaçırılır.
Sertifikalar cert-data birimi içerisinde /letsencrypt/acme.json yoluna kaydedilir. Tarayıcı sizin sertifikanız yerine varsayılan bir sertifika gösteriyorsa, docker compose --project-name erpnext ps içerisinden proxy servis adını bulun ve ACME (automatic certificate management environment) hatalarını görmek için log kayıtlarını inceleyin. Aynı sunucuda başka web uygulamaları mı çalıştırıyorsunuz? birden fazla Docker Compose uygulamasının önünde tek bir Traefik örneği rehberi, 443 numaralı port için çakışma yaşamadan proxy'nin nasıl paylaşılacağını gösterir. Bu tür bir sunucuda barındırılan ikinci uygulama genellikle müşteri odaklıdır ve self-hosted Chatwoot destek masası aynı proxy arkasında çalışarak fatura işlemleriyle ilgilenen personelin müşteri e-postalarını ve sohbetlerini tek bir noktadan yönetmesine olanak tanır.
Giden e-posta veya faturaların sunucudan çıkmaması
Bu adım, çoğu ERPNext kılavuzunun atladığı ancak sistemin kullanışlı olup olmayacağına karar veren kısımdır. Çalışan bir giden posta servisi olmadan hiçbir fatura müşteriye ulaşmaz, şifre sıfırlama e-postası gelmez ve zamanlanmış raporlar gönderilemez. Yığın içerisinde bir posta sunucusu bulunmaz.
VPS üzerinden 25 numaralı portu kullanarak doğrudan e-posta göndermeye çalışmayın. AWS gibi sağlayıcılar 25 numaralı giden portu varsayılan olarak engeller; ayrıca geçmişi olmayan yeni bir gönderim IP adresi, reddedilme veya spam kutusuna düşme riskini artırır. Bu sonuçların hiçbiri kaçınılmaz değildir. 587 numaralı port üzerinden kimlik doğrulamalı bir aktarıcı (relay) kullanın ve öncelikle sağlayıcınızın giden trafik kurallarını kontrol edin: DigitalOcean, Droplet'lerde 25, 465 ve 587 numaralı portları varsayılan olarak engeller.
Desteklenen yöntem, şifreyi şifrelenmiş olarak saklayan ERPNext arayüzündeki Email Account ekranıdır. Anahtarları site yapılandırma dosyasına da yazabilirsiniz:
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 değerini "587" dizgisi yerine bir sayı olarak saklar. Dosyayı tekrar okuyun ve bu iki değerin etrafında tırnak işareti olmadığını doğrulayın:
docker compose --project-name erpnext exec backend \
cat sites/erp.example.com/site_config.jsonŞifreli şifre depolaması için giden sunucuyu, kullanıcı adını ve şifreyi Email Account ekranında birlikte yapılandırın. Buradaki şifre alanı, ayrı bir mail_password site yapılandırma anahtarı oluşturmaz.
Ardından gerçek bir mesaj gönderin. Bir Sales Invoice oluşturun, kontrolünüz altındaki bir adrese e-posta ile gönderin ve bu sırada kuyruğu izleyin:
docker compose --project-name erpnext logs -f queue-shortGiden posta bir arka plan işidir; bu nedenle ulaşmayan bir mesaj genellikle tarayıcıda bir hata olarak değil, ilgili günlük kaydında başarısız bir iş olarak görünür. Gönderen alan adı için SPF (sender policy framework) ve DKIM (domainkeys identified mail) kayıtlarını yayınlayın, ardından bir DMARC politikası ekleyin. Kimlik doğrulama olmadan, teknik olarak doğru bir fatura bile reddedilme veya spam kutusuna düşme riski taşır. Tüm süreci kendiniz yönetmek isterseniz, kendi barındırdığınız bir Mailcow posta sunucusu, ERP'den ayrı bir makinede kontrol edebileceğiniz bir aktarıcı sağlar.
Gerçekten geri yüklenebilen yedekler
Yalnızca bir veritabanı dökümü, ERPNext için tam bir yedekleme sayılmaz. Ekler ve özel dosyalar MariaDB içinde değil, sites dizininde bulunur. Sadece veritabanını geri yüklerseniz, yüklenmiş olan tüm satın alma siparişleri bozuk bağlantı olarak görünür.
docker compose --project-name erpnext exec backend \
bench --site erp.example.com backup --with-filesBu komut, sites birimi içindeki sites/erp.example.com/private/backups dizinine dört dosya yazar:
- bir
-database.sql.gzdökümü - genel dosyaların bir
-files.tararşivi - özel dosyaların bir
-private-files.tararşivi - site yapılandırmasının bir
-site_config_backup.jsonkopyası
Dördüncü dosya, insanların genellikle göz ardı ettiği ancak eksikliği en çok hissedilen dosyadır. Bu dosya, Frappe'nin saklanan parolaları (e-posta hesabı kimlik bilgileri, ödeme ağ geçidi anahtarları ve tüm entegrasyon sırları) şifrelemek için kullandığı encryption_key anahtarını tutar. Veritabanını eşleşen anahtar olmadan geri yüklerseniz site normal şekilde açılır, ancak e-posta gönderimi şu hata ile başarısız olur:
frappe.exceptions.ValidationError: Encryption key is invalid! Please check site_config.jsonDört dosyayı her zaman bir arada tutun.
Ardından bu dosyaları sunucudan dışarı aktarın. Birim içindeki bir yedekleme, sunucu arızasından sağ çıkamaz; ayrıca bench aracı zaten bu dosyaları temizler: varsayılan olarak, o dizindeki 23 saatten eski yedekleri siler. Bu varsayılan süre Frappe 16.20.0 ve 15.114.0 sürümlerinden önce 24 saatti ve site yapılandırmasındaki keep_backups_for_hours anahtarı bu değeri geçersiz kılar.
docker compose --project-name erpnext cp \
backend:/home/frappe/frappe-bench/sites/erp.example.com/private/backups \
~/erpnext-backupsBu komutu cron üzerinden çalıştırın ve ardından dizini yönetmediğiniz başka bir yere gönderin. sunucu dışı depolama alanına şifreli restic yedekleri, doğru araçtır; çünkü veriyi yüklemeden önce şifreler ve restic check komutu ile deponun hala okunabilir olduğu doğrulanır. Bir ERP yedeği tüm muhasebe kayıtlarınızın bir kopyasıdır, bu nedenle bu donanımdan farklı bir donanımda, şifrelenmiş halde saklanmalıdır.
Geri yükleme işlemini ihtiyaç duymadan önce test edin
Test edilmemiş bir yedekleme, sadece bir tahmindir. Yedeklemeyi canlı sistem üzerinde değil, aynı sunucu üzerinde ikinci bir alanda test edin.
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>'Şifreleme anahtarını yedeklenmiş yapılandırmadan kopyalayıp geri yüklenen siteye aktarın; aksi takdirde entegrasyonlar çalışmayacaktır:
docker compose --project-name erpnext exec backend \
bench --site restore-test.example.com set-config encryption_key '<value from site_config_backup.json>'Şimdi geri yüklemeyi bir muhasebeci titizliğiyle kontrol edin. Alacak Hesapları raporunu açın ve kapanış bakiyesini canlı siteyle karşılaştırın. Yakın tarihli bir satın alma faturasını açın ve ekini indirin. Sadece giriş sayfasını görüntüleyebilen bir site, yedeğin başarılı olduğu anlamına gelmez.
İşleminiz bittiğinde test sitesini kaldırın:
docker compose --project-name erpnext exec backend \
bench drop-site restore-test.example.comERPNext için sürüm sabitlemenin önemi
Statik bir sitede sabitlenmemiş bir imaj etiketi, sürpriz bir yeniden başlatma anlamına gelir. ERPNext tarafında ise bu, bir şema migrasyonu demektir. bench migrate veritabanı tablolarını yeniden yazar ve belge verilerini değiştirebilir; bunun bir geri alma (undo) mekanizması yoktur. Geri dönüş, bir docker compose down ile değil, yedekten geri yükleme ile yapılır.
Bu nedenle etiketi sabitleyin. ERPNEXT_VERSION=v16.32.1, Ağustos 2026'da deponun kendi pwd.yml dosyasında sabitlenmiş sürümdü. 2026-11-16 tarihinde hem pwd.yml hem de example.env, v16.55.0 sürümünü sabitlemişti. Herhangi bir numarayı kontrol etmeden bir sonrakine taşımayın. Güncel sürümler frappe/erpnext sürümler sayfasında listelenmiştir ve mevcut imaj etiketleri Docker Hub üzerinde görülebilir. Geçiş yapmadan önce, geçeceğiniz sürüme ait notları okuyun.
Yükseltme işlemi, yedekleme ve bakım modu ile başlar.
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 içindeki ERPNEXT_VERSION dosyasını düzenleyin, ardından render, pull ve migrate işlemlerini gerçekleştirin.
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 offBakım modu önemlidir çünkü migrate çalışırken şemayı değiştirir. Bir kullanıcının, henüz yarısı tamamlanmış bir migrasyon tablosuna belge göndermesi, kayıtları elle onarmak zorunda kalmanıza neden olur.
Her adım arasında yedek alarak, her seferinde bir ana sürüm yükseltmesi yapın. Devam etmeden önce her ana sürüm için migrasyon kılavuzunu kontrol edin.
Depo ayrıca overrides/compose.migrator.yaml ile birlikte gelir; bu, siteler mevcut olduğunda ve varsayılan olarak etkin olan MIGRATE_SITES açık olduğunda, başlangıçta bench --site all migrate çalıştıran bir container ekler. Bu kullanışlıdır. Ancak aynı zamanda, etiketi değiştirilmiş bir docker compose up işleminin, siz izlemiyorken üretim veritabanınızı migrasyona tabi tutacağı anlamına gelir. Bir iş sisteminde, migrate işlemini o sabah verdiğiniz bir karar doğrultusunda çalıştırın.
Müşteri kayıtlarını barındıran bir sunucunun güvenliğini sağlama
İlk girişte Yönetici parolasını değiştirin. Değerlendirme amaçlı compose dosyası, parola olarak admin değerini kullanır ve bu alışkanlık üretim ortamına da taşınır.
DB_PASSWORD değerini example.env içindeki 123 değerinden farklı bir değerle değiştirin. Bu değer, oluşturulan ~/gitops/erpnext.yaml dosyasında düz metin olarak yer alır; bu nedenle dosyayı chmod 600 ile koruyun ve herhangi bir git deposuna eklemeyin. Daha güçlü bir yöntem için overrides/compose.mariadb-secrets.yaml, parolayı bir ortam değişkeni yerine Docker secret dosyasından okur. Docker Compose içinde ortam dosyalarını ve secret'ları yönetme konusu, bu yöntemlerin avantaj ve dezavantajlarını ele alır.
Yalnızca ihtiyacınız olanı dış dünyaya açın. HTTPS geçersiz kılma (override) ile yalnızca 80 ve 443 numaralı portlar dışarıya açılır. Veritabanı istemcisinin bağlantısını kolaylaştırmak için db servisine bir ports eşlemesi eklemeyin; bu işlem MariaDB'yi genel internete açar. Bunun yerine docker compose --project-name erpnext exec backend bench mariadb kullanın. Sunucu üzerinde 22, 80 ve 443 numaralı portlara izin verin, geri kalanını engelleyin ve ayrıca servis sağlayıcınızın sunduğu ağ güvenlik duvarını da kontrol edin.
Sistem Yöneticisi rolüne sahip her hesap için Sistem Ayarları kısmından iki faktörlü kimlik doğrulamayı etkinleştirin. Bu rol Sistem Ayarlarını değiştirebildiği için, onu bir kolaylık aracı olarak değil, bir yönetici hesabı olarak değerlendirin. Birden fazla self-hosted uygulama çalıştırıyorsanız, her uygulama için ayrı bir parola belirlemek yerine self-hosted tek oturum açma sağlayıcısı olarak Authentik kullanmak daha iyidir.
Sunucuyu yamalayın ve çekirdek güncellemeleri için yeniden başlatın. Yığının (stack) yeniden ayağa kalkacağına güvenmeden önce, her servis için oluşturulan dosyada bir restart politikası olup olmadığını kontrol edin; çünkü bu politika olmadan yığın, yeniden başlatma sonrasında kapalı kalır. Docker Compose yığınını yeniden başlatma sonrasında otomatik başlatma konusu, systemd tarafındaki yapılandırmayı ele alır.
ERPNext tek bir VPS üzerinde yetersiz kaldığında
Tek bir VPS, küçük bir şirketi uzun süre idare edebilir. Artık yetersiz kaldığının işaretleri şunlardır:
- Arka plan işleri birikir, bu nedenle e-postalar ve içe aktarımlar dakikalar veya saatler sonra ulaşır.
docker inspect,"OOMKilled": trueveya 137 çıkış koduyla container hataları bildirir.- İki saniye süren raporlar otuz saniye sürer ve CPU'yu meşgul eden süreç MariaDB'dir.
- Yedeklemeler o kadar uzun sürer ki, bir sonraki planlanmış yedekleme ile çakışır.
İşe, MariaDB'ye paylaşmadığı kaynakları vererek başlayın; çünkü veritabanı ve Python işçileri aynı bellek için rekabet eder ve daha fazlasına ihtiyaç duyan kısım buffer pool'dur. Daha büyük bir uygulama sunucusu, insanların beklediğinden daha az fayda sağlar. Veritabanını Docker içinde veya ana makinede çalıştırmak bu kararı kapsar ve Docker Compose içinde bellek sınırlarını ayarlamak, siz yapılandırmayı yaparken bir container'ın diğerlerini aç bırakmasını engeller.
Bundan sonra, web kapasitesinden ziyade kuyruk işçileri (queue workers) ekleyin. ERPNext'in yavaş işleri arka plan işleridir: rapor oluşturma ve toplu içe aktarımlar. Daha fazla işçi, CPU ve bellek kapasitesi gerektirir; halihazırda doymuş bir VPS'ye container eklemek kapasite artırmaz.
FAQ
ERPNext bir VPS üzerinde ne kadar RAM gerektirir?
Değerlendirme amaçlı kurulumlar için 4 GB RAM ve 2 vCPU ile başlayın. Günlük kullanım yapan bir şirket için 8 GB RAM, 4 vCPU ve 100 GB SSD planlayın. Bellek baskısı altında çekirdeğin "out of memory killer" mekanizması container'ları durdurabilir; bu durum docker inspect tarafından 137 çıkış kodu ile "OOMKilled": true olarak raporlanır. Bunlar kesin ölçümler değil başlangıç noktalarıdır; bu nedenle ilk ay boyunca kendi bellek kullanımınızı izleyin.
pwd.yml dosyasını üretim ortamında çalıştırabilir miyim?
Hayır. Projenin README dosyası, bu dosyanın yalnızca kısa süreli değerlendirmeler için tasarlandığını ve içine özel uygulamalar yükleyemeyeceğinizi belirtir. MariaDB, Redis ve HTTPS geçersiz kılmaları (override) ile compose.yaml kullanın, bunları docker compose config ile tek bir dosyada birleştirin ve bu dosyayı çalıştırın.
ERPNext sitemi oluşturduktan hemen sonra neden erişilemez durumda?
Önyüz, varsayılan olarak HTTP Host başlığına göre hangi sitenin sunulacağını seçer; bu nedenle site adı tarayıcıdaki alan adı ile eşleşmelidir. erpnext olarak oluşturulan bir site, erp.example.com adresinde sunulmaz. Siteyi alan adı ile aynı isimde oluşturun veya env dosyasında FRAPPE_SITE_NAME_HEADER değerini site adı olarak ayarlayın, compose dosyasını yeniden oluşturun ve stack'i yeniden başlatın.
Bir ERPNext yedeğinde neler bulunmalıdır?
Birlikte saklanan dört dosya: -database.sql.gz dökümü, -files.tar ve -private-files.tar arşivleri ve -site_config_backup.json yapılandırma kopyası. bench --site erp.example.com backup --with-files komutunu çalıştırmak bu dört dosyayı da üretir. Yapılandırma kopyası encryption_key değerini tutar; bu dosya olmadan yapılan bir geri yüklemede depolanan entegrasyon parolaları şifresi çözülemez hale gelir ve bu durum Encryption key is invalid! Please check site_config.json hatası olarak ortaya çıkar.
Verilerimi bozmadan ERPNext sürümünü nasıl yükseltebilirim?
--with-files ile yedek alın, bakım modunu açın, env dosyanızdaki ERPNEXT_VERSION değerini değiştirin, compose dosyasını yeniden oluşturun, pull işlemini yapın, stack'i ayağa kaldırın, ardından bench --site erp.example.com migrate komutunu çalıştırın ve bakım modunu kapatın. Her seferinde bir ana sürüm yükseltin ve önce sürüm notlarını okuyun; çünkü migrate şemayı ve belge verilerini geri alınamaz şekilde yeniden yazar. Geri dönmek, başlangıçta aldığınız yedeği geri yüklemek anlamına gelir.