Jak zainstalować ERPNext na VPS przy użyciu Docker
Dowiedz się, jak samodzielnie wdrożyć ERPNext na własnym serwerze VPS. Poradnik omawia konfigurację 11 kontenerów, obsługę TLS, pocztę wychodzącą oraz procedurę przywracania danych.
Czym jest uruchamiana usługa
Samodzielne hostowanie ERPNext na VPS to zadanie operacyjne, a nie instalacja za pomocą jednego polecenia. Oficjalny stos Docker Compose składa się z jedenastu kontenerów i przechowuje księgę główną oraz dane klientów. Podnosi to wymagania dla wszystkich poniższych działań: kopia zapasowa nie jest kopią, dopóki nie zostanie przywrócona, a nieprzypięty tag obrazu to zapowiedź problemów przy migracji schematu.
W tekście pojawia się kilka nazw. ERPNext to aplikacja biznesowa. Frappe to framework w języku Python, na którym jest oparta. Bench to narzędzie wiersza poleceń służące do zarządzania witrynami, zainstalowane wewnątrz kontenerów. Witryna (site) to jeden najemca: jedna baza danych MariaDB oraz jeden katalog z przesłanymi plikami. Prawie każde polecenie w tym przewodniku jest wykonywane za pomocą bench wewnątrz kontenera backend dla konkretnej witryny.
Ten przewodnik korzysta z repozytorium frappe_docker, które jest oficjalną metodą wdrażania utrzymywaną przez projekt. Każde poniższe polecenie zostało zweryfikowane w odniesieniu do tego repozytorium w sierpniu 2026 roku. Jeśli Docker Compose jest nowym narzędziem, uruchamianie Docker Compose na VPS zawiera podstawy, na których opiera się ten przewodnik.
Jakich zasobów VPS wymaga ERPNext?
Dane, na których opiera się ten wykres
[
{
"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
}
]W celach ewaluacyjnych należy rozpocząć od 2 vCPU oraz 4 GB pamięci RAM. Jest to poziom ewaluacyjny. Są to wartości początkowe, a nie pomiary wynikające z tego przewodnika; rzeczywiste zapotrzebowanie zależy od wolumenu dokumentów. Ostatni wiersz nie stanowi opublikowanego minimum. Zapewnia on jedynie większy zapas pamięci, a nie gwarancję, że pamięć nigdy się nie wyczerpie.
Należy realistycznie oceniać małe plany. VPS z 1 GB lub 2 GB pamięci RAM pozostawia niewielki margines dla dziesięciu działających w tle kontenerów, puli buforów MariaDB oraz procesu Python generującego raport. Pod wpływem presji pamięci, mechanizm out of memory killer jądra systemu może zatrzymać kontener, a polecenie docker inspect wykaże wtedy "OOMKilled": true z kodem wyjścia 137. Proces przerwany w trakcie pracy pozostawia przesłany dokument z niedokończonymi zadaniami w tle.
W przypadku firmy korzystającej z ERPNext codziennie, należy planować wdrożenie w oparciu o 8 GB pamięci RAM i 4 vCPU z 100 GB przestrzeni SSD, a następnie przetestować obciążenie. Pamięć RAM wyczerpuje się jako pierwsza. Przestrzeń dyskowa rośnie szybciej, niż można oczekiwać, ponieważ każdy załącznik oraz każda lokalna kopia zapasowa trafiają na ten sam wolumen co baza danych.
Jedenaście kontenerów i rola każdego z nich
Uruchom docker compose ps, gdy stos jest gotowy i działa dziesięć kontenerów. Jeden dodatkowy, configurator, wykonuje swoje zadanie jednorazowo i kończy działanie, co daje łącznie jedenaście jednostek.
backenduruchamia aplikację Frappe w środowisku gunicorn. To tutaj znajduje siębench.frontendto nginx. Serwuje zasoby statyczne i przekazuje pozostały ruch do backendu.queue-shortorazqueue-longto procesy robocze RQ (Redis Queue). Obsługują zadania w tle, takie jak wysyłka wiadomości e-mail, importy oraz generowanie raportów.schedulerwyzwala zadania czasowe, w tym zaplanowane raporty i automatyczne powtarzanie dokumentów.websocketto proces socket.io odpowiadający za aktualizacje na żywo w przeglądarce.dbto MariaDB.redis-cacheorazredis-queueto dwie oddzielne instancje Redis, jedna dla pamięci podręcznej, a druga dla kolejki zadań.proxyto Traefik, dodany poprzez nadpisanie konfiguracji HTTPS. Obsługuje porty 80 oraz 443 i pobiera certyfikaty.
Warto poznać ten podział, ponieważ wskazuje on, który dziennik należy analizować. Zablokowana wiadomość e-mail to problem procesu roboczego kolejki, więc właściwym poleceniem jest docker compose logs -f queue-short. Strona, która się ładuje, ale nie aktualizuje powiadomień, wskazuje na problem z websocketami. Analiza logów backend w obu tych przypadkach to strata czasu.
Instalacja z produkcyjnymi plikami compose, a nie demonstracyjnymi
Repozytorium dostarcza pwd.yml, a plik README jasno to określa: „Ta konfiguracja jest przeznaczona wyłącznie do krótkotrwałej oceny. Nie będzie można zainstalować w niej własnych aplikacji”. Użyj jej, aby zapoznać się z ERPNext przez jedno popołudnie. Nie uruchamiaj na niej firmy.
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.envOtwórz ~/gitops/erpnext.env i zmień cztery wartości. ERPNEXT_VERSION przypina tag obrazu. DB_PASSWORD jest dostarczane jako 123 w przykładowym pliku. SITES_RULE to reguła routingu Traefik, a LETSENCRYPT_EMAIL podaje adres e-mail konta ACME. Let’s Encrypt zakończyło wysyłanie powiadomień o wygaśnięciu certyfikatów 4 czerwca 2025 r., więc monitoruj wygaśnięcie certyfikatów oddzielnie.
ERPNEXT_VERSION=v16.32.1
DB_PASSWORD=<a long random password>
SITES_RULE=Host(`erp.example.com`)
LETSENCRYPT_EMAIL=ops@example.comTeraz wygeneruj jeden plik compose, a następnie uruchom go.
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 nie uruchamia niczego. Łączy plik bazowy z nadpisaniami i wyświetla wynik z już podstawionymi wszystkimi zmiennymi. Następnie uruchamiasz ten wygenerowany plik. Ten dodatkowy krok jest uzasadniony: uruchomiony stos to jeden plik, który można odczytać, więc nie zmieni się on w sposób niekontrolowany, gdy ktoś edytuje plik env lub gdy pobierzesz repozytorium. jak łączy się kilka plików Docker Compose wyjaśnia szczegółowo reguły nadpisywania.
Eksport COMPOSE_FILE sprawia, że poniższe polecenia używają wygenerowanego pliku. Powtarzaj go w każdej nowej powłoce; w cronie przekazuj -f ~/gitops/erpnext.yaml jawnie.
Poczekaj, aż db wystartuje, a configurator zakończy działanie, co zajmuje kilka sekund, a następnie utwórz witrynę.
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.comSprawdź to:
docker compose --project-name erpnext ps
docker compose --project-name erpnext exec backend bench --site erp.example.com list-appslist-apps powinno wyświetlić frappe oraz erpnext wraz z ich wersjami. Prawidłowo działający ps pokazuje dziesięć usług w stanie running i żadnej w restarting.
Dwie rzeczy często idą tu nie tak. --mariadb-user-host-login-scope=% nadaje użytkownikowi bazy danych nowej witryny zakres hosta typu wildcard, dzięki czemu może on nadal się zalogować, gdy Docker przypisze kontenerowi aplikacji inny adres. Bez tego Frappe ogranicza użytkownika do bieżącego hosta łączącego się. Kontener aplikacji dociera do MariaDB przez sieć Docker, więc pojawia się jako host zdalny, a użytkownik bazy danych ograniczony do localhost nie może się stamtąd zalogować. Ta opcja zmienia użytkownika bazy danych witryny, a nie konto root. Zakres % zezwala na połączenia z dowolnego hosta, który ma dostęp do MariaDB, więc utrzymuj bazę danych w prywatnej sieci Docker.
Druga kwestia to nazwa witryny. Frontend domyślnie wybiera witrynę do obsługi na podstawie nagłówka HTTP Host, więc witryna utworzona jako erpnext nie jest dostępna pod adresem erp.example.com, mimo że obie istnieją. Nazwij witrynę zgodnie z domeną, jak powyżej, lub ustaw FRAPPE_SITE_NAME_HEADER w pliku env na nazwę witryny i ponownie wygeneruj plik compose.
HTTPS oraz warunki konieczne do poprawnego działania
Nadpisanie compose.https.yaml uruchamia Traefik na porcie 443, przekierowuje na niego ruch z portu 80 i występuje o certyfikaty do Let's Encrypt. TLS (transport layer security) zapobiega przesyłaniu faktur oraz plików cookie sesji w postaci otwartego tekstu.
Muszą zostać spełnione dwa warunki, w przeciwnym razie certyfikat nie zostanie wydany. Rekord DNS A dla erp.example.com musi już wskazywać na VPS. Porty 80 oraz 443 muszą być osiągalne z Internetu, ponieważ Let's Encrypt weryfikuje kontrolę nad domeną za pomocą wyzwania HTTP-01 na porcie 80. Należy sprawdzić zarówno zaporę sieciową u dostawcy, jak i tę skonfigurowaną na serwerze. Są to odrębne mechanizmy kontroli, a o zaporze w panelu zarządzania często się zapomina.
Certyfikaty trafiają do wolumenu cert-data w lokalizacji /letsencrypt/acme.json. Jeśli przeglądarka wyświetla certyfikat domyślny zamiast własnego, należy odnaleźć nazwę usługi proxy w docker compose --project-name erpnext ps i sprawdzić jej dzienniki pod kątem błędów ACME (automatic certificate management environment). Uruchamiasz inne aplikacje webowe na tym samym serwerze? jedna instancja Traefik przed wieloma aplikacjami Docker Compose pokazuje, jak współdzielić proxy zamiast rywalizować o port 443. Druga aplikacja na takim serwerze często służy do obsługi klientów, a własny system wsparcia Chatwoot działa za tym samym proxy, dzięki czemu osoby zajmujące się fakturami mogą również odpowiadać na e-maile i czaty klientów w jednym miejscu.
Poczta wychodząca, czyli faktury, które nie opuszczają serwera
Jest to krok pomijany w większości przewodników po ERPNext, a decyduje on o użyteczności systemu. Bez działającej poczty wychodzącej żadna faktura nie dotrze do klienta, nie nadejdzie reset hasła, ani nie zostanie dostarczony zaplanowany raport. Stos technologiczny nie zawiera serwera pocztowego.
Nie należy próbować wysyłać poczty bezpośrednio z VPS przez port 25. Dostawcy tacy jak AWS domyślnie blokują port 25, a nowy adres IP nadawcy bez historii zwiększa ryzyko odrzucenia wiadomości lub zakwalifikowania jej jako spam. Żaden z tych scenariuszy nie jest nieunikniony. Należy użyć uwierzytelnionego przekaźnika (relay) na porcie 587 i najpierw sprawdzić zasady ruchu wychodzącego u dostawcy: DigitalOcean domyślnie blokuje porty 25, 465 oraz 587 na instancjach Droplet.
Wspieraną metodą jest ekran Email Account w interfejsie ERPNext, który przechowuje hasło w formie zaszyfrowanej. Można również zapisać klucze bezpośrednio w konfiguracji witryny:
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 przechowuje 587 jako liczbę, a nie ciąg znaków "587". Należy odczytać plik i potwierdzić, że te dwie wartości nie są ujęte w cudzysłowy:
docker compose --project-name erpnext exec backend \
cat sites/erp.example.com/site_config.jsonW celu zaszyfrowanego przechowywania hasła należy skonfigurować serwer wychodzący, login oraz hasło bezpośrednio w ekranie Email Account. Pole hasła w tym interfejsie nie ustawia osobnego klucza konfiguracyjnego mail_password.
Następnie należy wysłać rzeczywistą wiadomość. Należy utworzyć Sales Invoice, wysłać go na kontrolowany przez siebie adres e-mail i monitorować kolejkę w trakcie operacji:
docker compose --project-name erpnext logs -f queue-shortPoczta wychodząca jest zadaniem w tle, więc wiadomość, która nie dociera, zazwyczaj pojawia się w tym dzienniku jako nieudane zadanie, a nie jako błąd w przeglądarce. Należy również opublikować rekordy SPF (Sender Policy Framework) oraz DKIM (DomainKeys Identified Mail) dla domeny nadawcy, a następnie dodać politykę DMARC. Bez uwierzytelnienia technicznie poprawna faktura narażona jest na odrzucenie lub trafienie do spamu. Jeśli preferowane jest pełne zarządzanie ścieżką dostarczania, samodzielnie hostowany serwer pocztowy Mailcow zapewnia przekaźnik pod pełną kontrolą, działający na osobnej maszynie niż ERP.
Kopie zapasowe, które faktycznie można przywrócić
Sam zrzut bazy danych nie stanowi kopii zapasowej ERPNext. Załączniki i pliki prywatne znajdują się w katalogu sites, a nie w MariaDB. Przywrócenie wyłącznie bazy danych spowoduje, że każde przesłane zamówienie zakupu będzie wyświetlane jako uszkodzony link.
docker compose --project-name erpnext exec backend \
bench --site erp.example.com backup --with-filesPolecenie to zapisuje cztery pliki w sites/erp.example.com/private/backups wewnątrz wolumenu sites:
- zrzut
-database.sql.gz - archiwum
-files.tarplików publicznych - archiwum
-private-files.tarplików prywatnych - kopię
-site_config_backup.jsonkonfiguracji witryny
Czwarty plik jest tym, który użytkownicy często pomijają, co prowadzi do problemów. Zawiera on encryption_key, klucz używany przez Frappe do szyfrowania przechowywanych haseł: danych uwierzytelniających kont e-mail, kluczy bramek płatności oraz wszystkich sekretów integracji. Przywrócenie bazy danych bez pasującego klucza spowoduje, że witryna załaduje się poprawnie, jednak wysyłka wiadomości e-mail zakończy się błędem:
frappe.exceptions.ValidationError: Encryption key is invalid! Please check site_config.jsonWszystkie cztery pliki należy zawsze przechowywać razem.
Następnie należy przenieść je poza serwer. Kopia zapasowa znajdująca się wewnątrz wolumenu nie przetrwa awarii serwera, a narzędzie bench i tak ją usuwa: domyślnie usuwa ono kopie starsze niż 23 godziny z tego katalogu. Przed wersjami Frappe 16.20.0 oraz 15.114.0 wartość ta wynosiła 24 godziny, a klucz keep_backups_for_hours w konfiguracji witryny pozwala na nadpisanie tego ustawienia.
docker compose --project-name erpnext cp \
backend:/home/frappe/frappe-bench/sites/erp.example.com/private/backups \
~/erpnext-backupsPolecenie to należy uruchamiać za pomocą cron, a następnie przesyłać katalog w miejsce, które nie jest administrowane przez ten sam podmiot. Szyfrowane kopie zapasowe restic do pamięci zewnętrznej są właściwym rozwiązaniem, ponieważ szyfrują dane przed wysyłką, a restic check potwierdza, że repozytorium jest nadal czytelne. Kopia zapasowa ERP to kopia całej księgi rachunkowej, dlatego powinna być przechowywana w formie zaszyfrowanej na sprzęcie innym niż serwer źródłowy.
Przetestuj przywracanie danych przed wystąpieniem awarii
Nietestowana kopia zapasowa to tylko przypuszczenie. Przetestuj ją w odizolowanej lokalizacji na tym samym serwerze, nigdy w środowisku produkcyjnym.
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>'Skopiuj klucz szyfrujący z kopii zapasowej konfiguracji do przywróconej witryny, w przeciwnym razie integracje pozostaną nieaktywne:
docker compose --project-name erpnext exec backend \
bench --site restore-test.example.com set-config encryption_key '<value from site_config_backup.json>'Teraz zweryfikuj przywrócone dane w sposób rzetelny. Otwórz raport należności i porównaj saldo końcowe z witryną produkcyjną. Otwórz niedawną fakturę zakupu i pobierz załącznik. Sam fakt, że strona logowania się wyświetla, nie stanowi dowodu poprawności danych.
Po zakończeniu usuń witrynę testową:
docker compose --project-name erpnext exec backend \
bench drop-site restore-test.example.comDlaczego przypinanie wersji jest kluczowe dla ERPNext
W przypadku statycznej witryny nieprzypięty tag obrazu oznacza jedynie nieoczekiwany restart. W ERPNext oznacza to migrację schematu. bench migrate modyfikuje tabele bazy danych i może nadpisać dane dokumentów, a operacja ta jest nieodwracalna. Wycofanie zmian wymaga przywrócenia kopii zapasowej, a nie wykonania docker compose down.
Dlatego należy przypinać tagi. ERPNEXT_VERSION=v16.32.1 było wersją przypiętą w pliku pwd.yml repozytorium w sierpniu 2026 roku. W dniu 2026-11-16 zarówno pwd.yml, jak i example.env miały przypięte v16.55.0. Nie należy przenosić żadnego z tych numerów bez jego uprzedniej weryfikacji. Bieżące wydania są wymienione na stronie wydań frappe/erpnext, a istniejące tagi obrazów znajdują się w serwisie Docker Hub. Przed przystąpieniem do aktualizacji należy zapoznać się z informacjami dotyczącymi wersji docelowej.
Sama aktualizacja rozpoczyna się od wykonania kopii zapasowej i włączenia trybu konserwacji.
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 onNależy edytować ERPNEXT_VERSION w ~/gitops/erpnext.env, a następnie wygenerować konfigurację, pobrać obrazy i przeprowadzić migrację.
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 offTryb konserwacji jest istotny, ponieważ migrate zmienia schemat w trakcie działania. Użytkownik przesyłający dokument w trakcie migracji tabeli prowadzi do sytuacji, w której konieczna jest ręczna naprawa rekordów.
Aktualizacje należy przeprowadzać o jedną wersję główną naraz, wykonując kopię zapasową pomiędzy każdym krokiem. Przed kontynuacją należy sprawdzić wytyczne dotyczące migracji dla każdej wersji głównej.
Repozytorium dostarcza również overrides/compose.migrator.yaml, który dodaje kontener uruchamiający bench --site all migrate przy starcie, jeśli istnieją witryny, a MIGRATE_SITES jest włączone (co jest ustawieniem domyślnym). Jest to wygodne rozwiązanie. Oznacza ono jednak, że docker compose up ze zmienionym tagiem przeprowadzi migrację produkcyjnej bazy danych bez nadzoru. W systemach biznesowych decyzję o uruchomieniu migracji należy podejmować świadomie w wybranym momencie.
Zabezpieczanie serwera przechowującego dane klientów
Zmień hasło administratora przy pierwszym logowaniu. Plik compose w wersji ewaluacyjnej zawiera admin jako hasło domyślne, a nawyk ten jest często przenoszony do środowisk produkcyjnych.
Zmień DB_PASSWORD na inną wartość niż 123 w pliku example.env. Wartość ta trafia do wygenerowanego pliku ~/gitops/erpnext.yaml w postaci jawnego tekstu, dlatego należy użyć chmod 600 dla tego pliku i nie umieszczać go w żadnym repozytorium git. Aby uzyskać wyższy poziom bezpieczeństwa, overrides/compose.mariadb-secrets.yaml odczytuje hasło z pliku Docker secret zamiast ze zmiennej środowiskowej. Artykuł obsługa plików env i sekretów w Docker Compose omawia wady i zalety tego rozwiązania.
Udostępniaj tylko niezbędne zasoby. Przy użyciu nadpisania HTTPS, jedynymi wystawionymi portami powinny być 80 oraz 443. Nie dodawaj mapowania ports do usługi db w celu ułatwienia połączenia z klientem bazy danych: powoduje to wystawienie MariaDB bezpośrednio do publicznego Internetu. Zamiast tego użyj docker compose --project-name erpnext exec backend bench mariadb. Na hoście zezwól na ruch na portach 22, 80 oraz 443, zablokuj pozostałe i sprawdź również zewnętrzny firewall sieciowy dostawcy.
Włącz uwierzytelnianie dwuskładnikowe w ustawieniach systemowych dla każdego konta posiadającego rolę System Manager. Rola ta pozwala na zmianę ustawień systemowych, więc należy traktować ją jak konto administratora, a nie jako udogodnienie. Jeśli uruchamiasz kilka aplikacji we własnej infrastrukturze, rozwiązanie Authentik jako dostawca SSO jest lepsze niż zarządzanie kolejnym hasłem dla każdej aplikacji z osobna.
Aktualizuj hosta i wykonuj restart po aktualizacjach jądra. Zanim założysz, że stos usług uruchomi się automatycznie, sprawdź w wygenerowanym pliku politykę restart dla każdej usługi, ponieważ stos bez zdefiniowanej polityki pozostanie wyłączony po restarcie. Artykuł automatyczne uruchamianie stosu Docker Compose po restarcie omawia konfigurację po stronie systemd.
Gdy ERPNext przestaje działać wydajnie na jednym VPS
Jeden VPS może obsługiwać małą firmę przez długi czas. Oznaki, że zasoby stały się niewystarczające:
- Zadania w tle gromadzą się w kolejce, przez co e-maile i importy docierają z opóźnieniem wynoszącym minuty lub godziny.
docker inspectzgłasza kontenery z"OOMKilled": truelub kodem wyjścia 137.- Raporty, które generowały się dwie sekundy, wymagają teraz trzydziestu, a MariaDB jest procesem obciążającym CPU.
- Kopie zapasowe trwają tak długo, że nakładają się na kolejny zaplanowany proces.
Należy zacząć od przydzielenia MariaDB zasobów, których nie będzie współdzielić, ponieważ baza danych i procesy robocze Python rywalizują o tę samą pamięć, a pula buforów (buffer pool) jest elementem, który wymaga jej najwięcej. Zwiększenie zasobów serwera aplikacji pomaga rzadziej, niż można oczekiwać. uruchomienie bazy danych w Dockerze lub na hoście opisuje tę decyzję, a ustawienie limitów pamięci w Docker Compose zapobiega sytuacji, w której jeden kontener wyczerpuje zasoby pozostałych podczas wprowadzania zmian.
Następnie należy zwiększyć liczbę procesów roboczych kolejki (queue workers), zamiast zwiększać wydajność serwera WWW. Wolne działanie ERPNext wynika zazwyczaj z zadań w tle: generowania raportów i masowych importów. Więcej procesów roboczych wymaga zapasu CPU i pamięci; dodawanie kontenerów do już nasyconego VPS nie zwiększa wydajności.
FAQ
Ile pamięci RAM wymaga ERPNext na serwerze VPS?
W celach testowych należy rozpocząć od 4 GB pamięci RAM oraz 2 vCPU. W przypadku codziennego użytkowania firmowego należy zaplanować 8 GB pamięci RAM oraz 4 vCPU wraz z 100 GB przestrzeni SSD. W warunkach niedoboru pamięci mechanizm kernel out of memory killer może zatrzymać kontenery, co docker inspect raportuje jako "OOMKilled": true z kodem wyjścia 137. Są to wartości początkowe, a nie docelowe, dlatego należy monitorować zużycie pamięci przez pierwszy miesiąc pracy.
Czy można używać pwd.yml w środowisku produkcyjnym?
Nie. Plik README projektu wskazuje, że jest on przeznaczony wyłącznie do krótkotrwałych testów i nie pozwala na instalację własnych aplikacji. Należy użyć compose.yaml z odpowiednimi nadpisaniami dla MariaDB, Redis oraz HTTPS, wygenerować pojedynczy plik za pomocą docker compose config i uruchomić go.
Dlaczego witryna ERPNext jest niedostępna zaraz po utworzeniu?
Frontend domyślnie wybiera witrynę do obsłużenia na podstawie nagłówka HTTP Host, dlatego nazwa witryny musi być zgodna z domeną wpisaną w przeglądarce. Witryna utworzona jako erpnext nie będzie dostępna pod adresem erp.example.com. Należy utworzyć witrynę używając domeny jako jej nazwy lub ustawić FRAPPE_SITE_NAME_HEADER w pliku env na nazwę witryny, ponownie wygenerować plik compose i zrestartować stos.
Co musi zawierać kopia zapasowa ERPNext?
Cztery pliki przechowywane razem: zrzut -database.sql.gz, archiwa -files.tar i -private-files.tar oraz kopię konfiguracji -site_config_backup.json. Uruchomienie bench --site erp.example.com backup --with-files generuje wszystkie cztery elementy. Kopia konfiguracji zawiera encryption_key, więc przywrócenie danych bez niej uniemożliwia odszyfrowanie zapisanych haseł integracji, co objawia się błędem Encryption key is invalid! Please check site_config.json.
Jak zaktualizować ERPNext bez utraty danych?
Należy wykonać kopię zapasową za pomocą --with-files, włączyć tryb konserwacji, zmienić ERPNEXT_VERSION w pliku env, ponownie wygenerować plik compose, pobrać obrazy, uruchomić stos, a następnie wykonać bench --site erp.example.com migrate i wyłączyć tryb konserwacji. Aktualizacje należy przeprowadzać o jedną wersję główną naraz, czytając wcześniej informacje o wydaniu, ponieważ migrate zmienia schemat bazy danych oraz dane dokumentów bez możliwości cofnięcia zmian. Powrót do poprzedniej wersji wymaga przywrócenia kopii zapasowej wykonanej przed rozpoczęciem procesu.