ERPNext mit Docker auf einem VPS selbst hosten
Betreiben Sie ERPNext mit elf Containern auf dem eigenen VPS. Erfahren Sie mehr über Dimensionierung, TLS, E-Mail-Versand, feste Versionen und getestete Wiederherstellung.
Wofür Sie sich beim Betrieb entscheiden
ERPNext selbst auf einem VPS zu hosten, ist eine Betriebsaufgabe und keine Installation mit einem einzigen Befehl. Der offizielle Docker-Compose-Stack besteht aus elf Containern und enthält Ihr Hauptbuch sowie Ihre Kundendaten. Dadurch gelten für alle folgenden Schritte höhere Anforderungen: Ein Backup ist erst dann ein Backup, wenn Sie es wiederhergestellt haben. Ein nicht festgelegter Image-Tag kann jederzeit eine Schema-Migration auslösen.
Im gesamten Text werden einige Bezeichnungen verwendet. ERPNext ist die Geschäftsanwendung. Frappe ist das zugrunde liegende Python-Framework. Bench ist das Befehlszeilenwerkzeug zur Verwaltung von Sites und bereits in den Containern installiert. Eine Site ist ein Mandant: eine MariaDB-Datenbank und ein Verzeichnis mit hochgeladenen Dateien. Fast jeder Befehl in diesem Text wird bench innerhalb des Containers backend für eine bestimmte Site ausgeführt.
Diese Anleitung verwendet das Repository frappe_docker, das vom Projekt gepflegt wird. Jeder folgende Befehl wurde im August 2026 gegen dieses Repository geprüft. Falls Docker Compose für Sie neu ist, behandelt Docker Compose auf einem VPS ausführen die Grundlagen, die diese Anleitung voraussetzt.
Wie viel VPS benötigt ERPNext?
Die Daten hinter diesem Diagramm
[
{
"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
}
]Beginnen Sie für die Evaluierung mit 2 vCPU und 4 GB RAM. Das ist die Evaluierungsstufe. Diese Werte sind Ausgangspunkte und keine Messwerte aus diesem Leitfaden. Das tatsächliche Ergebnis hängt vom Umfang Ihrer Dokumente ab. Die letzte Zeile ist überhaupt kein veröffentlichtes Mindestmaß. Sie bietet mehr Speicherreserve, ist aber keine Garantie dafür, dass der Arbeitsspeicher niemals ausgeht.
Seien Sie bei kleinen Tarifen realistisch. Ein VPS mit 1 GB oder 2 GB lässt wenig Reserve für zehn dauerhaft laufende Container, den Buffer Pool von MariaDB und einen Python-Worker, der einen Bericht erstellt. Unter Speicherdruck kann der Out-of-Memory-Killer des Kernels einen Container beenden. docker inspect zeigt dann "OOMKilled": true mit Exit-Code 137 an. Wenn ein Worker während eines Auftrags beendet wird, bleibt ein übermitteltes Dokument mit nur teilweise ausgeführter Hintergrundverarbeitung zurück.
Für ein Unternehmen, das ERPNext täglich nutzt, sollten Sie zunächst mit 8 GB RAM, 4 vCPU und 100 GB SSD planen und anschließend Ihre Arbeitslast testen. Der Arbeitsspeicher ist zuerst erschöpft. Der belegte Speicherplatz wächst schneller als erwartet, weil jeder Anhang und jedes lokale Backup auf demselben Volume wie die Datenbank gespeichert wird.
Die elf Container und ihre jeweiligen Aufgaben
Führen Sie docker compose ps aus, nachdem der Stack gestartet wurde und zehn Container ausgeführt werden. Ein weiterer Container, configurator, führt seine Aufgabe einmal aus und wird dann beendet. Daher ergibt sich die Gesamtzahl von elf Containern.
backendführt die Frappe-Anwendung unter gunicorn aus. Dort befindet sichbench.frontendist nginx. Der Dienst stellt statische Ressourcen bereit und leitet alle übrigen Anfragen an das Backend weiter.queue-shortundqueue-longsind RQ-Worker (Redis Queue). Sie führen Hintergrundaufgaben wie den Versand ausgehender E-Mails, Importe und die Erstellung von Berichten aus.schedulerstartet zeitgesteuerte Aufgaben, darunter geplante Berichte und automatisch wiederholte Dokumente.websocketist der socket.io-Prozess hinter den Live-Aktualisierungen im Browser.dbist MariaDB.redis-cacheundredis-queuesind zwei separate Redis-Instanzen: eine für den Cache und eine für die Jobwarteschlange.proxyist Traefik, das durch den HTTPS-Override hinzugefügt wird. Der Dienst verwendet die Ports 80 und 443 und ruft die Zertifikate ab.
Diese Aufteilung sollten Sie kennen, weil sie zeigt, welches Log Sie lesen müssen. Eine festhängende E-Mail ist ein Problem des Queue-Workers. Daher ist docker compose logs -f queue-short der richtige Befehl. Eine Seite, die geladen wird, aber das Benachrichtigungs-Badge nie aktualisiert, weist auf ein WebSocket-Problem hin. Die Logs von backend zu lesen, ist in beiden Fällen eine unnötige Zeitverschwendung.
Mit den produktiven Compose-Dateien installieren, nicht mit der Demo
Das Repository enthält pwd.yml, und die README weist ausdrücklich darauf hin: „Dieses Setup ist nur für eine kurzlebige Evaluierung vorgesehen. Sie können in diesem Setup keine benutzerdefinierten Apps installieren.“ Verwenden Sie es, um ERPNext einen Nachmittag lang zu testen. Betreiben Sie damit kein Unternehmen.
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Öffnen Sie ~/gitops/erpnext.env und ändern Sie vier Werte. ERPNEXT_VERSION legt den Image-Tag fest. DB_PASSWORD wird in der Beispieldatei als 123 ausgeliefert. SITES_RULE ist die Traefik-Routing-Regel, und LETSENCRYPT_EMAIL liefert die E-Mail-Adresse des ACME-Kontos. Let’s Encrypt hat Benachrichtigungen per E-Mail über das Ablaufdatum am 4. Juni 2025 eingestellt. Überwachen Sie den Ablauf der Zertifikate daher separat.
ERPNEXT_VERSION=v16.32.1
DB_PASSWORD=<a long random password>
SITES_RULE=Host(`erp.example.com`)
LETSENCRYPT_EMAIL=ops@example.comErzeugen Sie jetzt eine Compose-Datei und starten Sie sie anschließend.
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 startet nichts. Der Befehl führt die Basisdatei mit den Überschreibungen zusammen und gibt das Ergebnis aus, wobei bereits alle Variablen ersetzt sind. Anschließend führen Sie diese erzeugte Datei aus. Dieser zusätzliche Schritt ist sinnvoll: Der laufende Stack steht in einer einzigen lesbaren Datei. Dadurch kann er sich nicht ändern, während jemand die env-Datei bearbeitet oder Sie das Repository aktualisieren. wie mehrere Docker-Compose-Dateien zusammengeführt werden erläutert die Regeln für Überschreibungen im Detail.
Der Export COMPOSE_FILE sorgt dafür, dass die folgenden Befehle die erzeugte Datei verwenden. Wiederholen Sie ihn in jeder neuen Shell. Verwenden Sie in cron stattdessen -f ~/gitops/erpnext.yaml explizit.
Warten Sie, bis db gestartet ist und configurator beendet wurde. Das dauert einige Sekunden. Erstellen Sie anschließend die 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.comPrüfen Sie sie:
docker compose --project-name erpnext ps
docker compose --project-name erpnext exec backend bench --site erp.example.com list-appslist-apps sollte frappe und erpnext mit ihren Versionen ausgeben. Ein funktionsfähiges ps zeigt zehn Dienste im Zustand running und keinen im Zustand restarting.
Hier treten häufig zwei Probleme auf. --mariadb-user-host-login-scope=% gibt dem Datenbankbenutzer der neuen Site einen beliebigen Hostbereich. Dadurch kann er sich weiterhin anmelden, wenn Docker dem App-Container eine andere Adresse zuweist. Ohne diese Option begrenzt Frappe den Benutzer auf den Host, von dem die aktuelle Verbindung stammt. Der App-Container erreicht MariaDB über das Docker-Netzwerk und tritt daher als entfernter Host auf. Ein auf localhost begrenzter Datenbankbenutzer kann sich von dort nicht anmelden. Diese Option ändert den Datenbankbenutzer der Site, nicht das root-Konto. Der Bereich % erlaubt Verbindungen von jedem Host, der MariaDB erreichen kann. Betreiben Sie die Datenbank daher weiterhin im privaten Docker-Netzwerk.
Das zweite Problem ist der Name der Site. Das Frontend wählt standardmäßig anhand des HTTP-Host-Headers aus, welche Site ausgeliefert wird. Eine als erpnext erstellte Site ist daher unter erp.example.com nicht erreichbar, obwohl beide vorhanden sind. Benennen Sie die Site wie oben nach der Domain. Alternativ setzen Sie FRAPPE_SITE_NAME_HEADER in der env-Datei auf den Namen der Site und erzeugen die Compose-Datei erneut.
HTTPS und welche Voraussetzungen dafür erfüllt sein müssen
Der compose.https.yaml-Override startet Traefik auf Port 443, leitet Port 80 dorthin um und fordert Zertifikate bei Let's Encrypt an. TLS (Transport Layer Security) verhindert, dass eine Rechnung und ein Sitzungscookie unverschlüsselt übertragen werden.
Zwei Voraussetzungen müssen erfüllt sein, sonst wird kein Zertifikat ausgestellt. Der DNS-A-Record für erp.example.com muss bereits auf den VPS zeigen. Die Ports 80 und 443 müssen aus dem Internet erreichbar sein, weil Let's Encrypt mit einer HTTP-01-Challenge auf Port 80 nachweist, dass Sie den Namen kontrollieren. Prüfen Sie zusätzlich zur Firewall auf dem Server auch die Netzwerk-Firewall Ihres Anbieters. Das sind getrennte Kontrollen, und die Panel-Firewall wird häufig vergessen.
Die Zertifikate werden im Volume cert-data unter /letsencrypt/acme.json gespeichert. Wenn der Browser statt Ihres Zertifikats ein Standardzertifikat anzeigt, ermitteln Sie den Namen des Proxy-Dienstes in docker compose --project-name erpnext ps und lesen Sie dessen Logs auf einen ACME-Fehler (Automatic Certificate Management Environment) hin. Betreiben Sie weitere Webanwendungen auf demselben Server? Eine Traefik-Instanz vor mehreren Docker-Compose-Anwendungen zeigt, wie Sie den Proxy gemeinsam nutzen, statt Port 443 zwischen den Anwendungen aufzuteilen. Die zweite Anwendung auf einem solchen Server ist häufig für Kunden erreichbar. Ein selbst gehostetes Chatwoot-Supportdesk läuft hinter demselben Proxy, sodass die Mitarbeiter, die Rechnungen bearbeiten, Kunden-E-Mails und Chats an einem zentralen Ort beantworten können.
Ausgehende E-Mails, sonst verlassen die Rechnungen den Server nie
Dies ist der Schritt, den die meisten ERPNext-Anleitungen überspringen. Er entscheidet, ob das System praktisch nutzbar ist. Ohne funktionierende ausgehende E-Mails erreicht keine Rechnung einen Kunden, keine E-Mail zum Zurücksetzen des Passworts kommt an und kein geplanter Bericht wird zugestellt. Der Stack enthält keinen Mailserver.
Versuchen Sie nicht, E-Mails direkt vom VPS über Port 25 zu senden. Anbieter wie AWS blockieren den ausgehenden Port 25 standardmäßig. Außerdem erhöht eine neue Sende-IP mit wenig oder keiner Historie das Risiko einer Ablehnung oder Einstufung als Spam. Keine dieser Folgen ist unvermeidbar. Verwenden Sie ein authentifiziertes Relay über Port 587. Prüfen Sie vorher die Regeln Ihres Anbieters für ausgehenden Datenverkehr: DigitalOcean blockiert auf Droplets standardmäßig die Ports 25, 465 und 587.
Der unterstützte Weg führt über die Ansicht Email Account in der ERPNext-Oberfläche. Das Passwort wird dort verschlüsselt gespeichert. Sie können die Schlüssel auch in die Site-Konfiguration schreiben:
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 speichert 587 als Zahl und nicht als Zeichenfolge "587". Lesen Sie die Datei anschließend erneut ein und prüfen Sie, dass diese beiden Werte nicht von Anführungszeichen eingeschlossen sind:
docker compose --project-name erpnext exec backend \
cat sites/erp.example.com/site_config.jsonFür die verschlüsselte Speicherung des Passworts konfigurieren Sie ausgehenden Server, Anmeldung und Passwort gemeinsam in der Ansicht Email Account. Das Passwortfeld setzt nicht den separaten Site-Konfigurationsschlüssel mail_password.
Senden Sie anschließend eine echte Nachricht. Erstellen Sie eine Sales Invoice, senden Sie sie per E-Mail an eine von Ihnen kontrollierte Adresse und überwachen Sie dabei die Warteschlange:
docker compose --project-name erpnext logs -f queue-shortAusgehende E-Mails werden als Hintergrundauftrag verarbeitet. Eine Nachricht, die nie ankommt, erscheint daher meistens als fehlgeschlagener Auftrag in diesem Log und nicht als Fehler im Browser. Veröffentlichen Sie außerdem SPF-Datensätze (Sender Policy Framework) und DKIM-Datensätze (DomainKeys Identified Mail) für die sendende Domain. Fügen Sie anschließend eine DMARC-Richtlinie hinzu. Ohne Authentifizierung kann eine technisch korrekte Rechnung abgelehnt oder als Spam eingestuft werden. Wenn Sie den gesamten Versandweg selbst betreiben möchten, bietet ein selbst gehosteter Mailcow-Mailserver ein Relay, das Sie kontrollieren und auf einem separaten Server außerhalb von ERPNext betreiben.
Backups, die sich tatsächlich wiederherstellen lassen
Ein Datenbankdump allein ist kein Backup von ERPNext. Anhänge und private Dateien liegen im Verzeichnis sites, nicht in MariaDB. Wenn Sie nur die Datenbank wiederherstellen, wird jeder hochgeladene Bestellbeleg als defekter Link angezeigt.
docker compose --project-name erpnext exec backend \
bench --site erp.example.com backup --with-filesDamit werden vier Dateien in sites/erp.example.com/private/backups innerhalb des Volumes sites geschrieben:
- ein
-database.sql.gz-Dump - ein
-files.tar-Archiv der öffentlichen Dateien - ein
-private-files.tar-Archiv der privaten Dateien - eine
-site_config_backup.json-Kopie der Site-Konfiguration
Die vierte Datei wird häufig weggeworfen. Genau das verursacht später Probleme. Sie enthält encryption_key, den Schlüssel, den Frappe zum Verschlüsseln gespeicherter Passwörter verwendet: Zugangsdaten für E-Mail-Konten, Schlüssel für Zahlungs-Gateways und alle Secrets von Integrationen. Wenn Sie eine Datenbank ohne den zugehörigen Schlüssel wiederherstellen, wird die Site normal geladen. Das Senden von E-Mails schlägt jedoch mit folgender Meldung fehl:
frappe.exceptions.ValidationError: Encryption key is invalid! Please check site_config.jsonBewahren Sie alle vier Dateien immer zusammen auf.
Übertragen Sie sie anschließend vom Server. Ein Backup innerhalb des Volumes übersteht den Ausfall des Servers nicht. Außerdem entfernt bench die Backups ohnehin: Standardmäßig löscht es aus diesem Verzeichnis Backups, die älter als 23 Stunden sind. Vor Frappe 16.20.0 und 15.114.0 betrug dieser Standardwert 24 Stunden. Der Schlüssel keep_backups_for_hours in der Site-Konfiguration überschreibt diesen Wert.
docker compose --project-name erpnext cp \
backend:/home/frappe/frappe-bench/sites/erp.example.com/private/backups \
~/erpnext-backupsFühren Sie den Befehl über cron aus. Übertragen Sie das Verzeichnis anschließend an einen Speicherort, den Sie nicht selbst administrieren. Verschlüsselte restic-Backups in einen externen Speicher sind dafür geeignet, weil restic die Daten vor der Übertragung verschlüsselt und restic check bestätigt, dass das Repository weiterhin lesbar ist. Ein ERP-Backup ist eine Kopie Ihres gesamten Buchungsbestands. Es gehört daher verschlüsselt im Ruhezustand auf Hardware, die nicht dieser Server ist.
Testen Sie die Wiederherstellung, bevor Sie sie benötigen
Ein nicht getestetes Backup ist nur eine Vermutung. Testen Sie es auf demselben Server in einer zweiten Site, niemals in der produktiven Site.
docker compose --project-name erpnext exec backend \
bench new-site --mariadb-user-host-login-scope=% \
--db-root-password '<your DB_PASSWORD>' \
--admin-password '<a strong admin password>' \
restore-test.example.com
docker compose --project-name erpnext exec backend \
bench --site restore-test.example.com --force restore \
sites/erp.example.com/private/backups/<stamp>-erp_example_com-database.sql.gz \
--with-public-files sites/erp.example.com/private/backups/<stamp>-erp_example_com-files.tar \
--with-private-files sites/erp.example.com/private/backups/<stamp>-erp_example_com-private-files.tar \
--db-root-password '<your DB_PASSWORD>'Kopieren Sie den Verschlüsselungsschlüssel aus der gesicherten Konfiguration in die wiederhergestellte Site. Andernfalls funktionieren deren Integrationen weiterhin nicht:
docker compose --project-name erpnext exec backend \
bench --site restore-test.example.com set-config encryption_key '<value from site_config_backup.json>'Prüfen Sie die Wiederherstellung nun wie ein Buchhalter. Öffnen Sie den Bericht „Accounts Receivable“ und vergleichen Sie den Endsaldo mit der produktiven Site. Öffnen Sie eine aktuelle Eingangsrechnung und laden Sie deren Anhang herunter. Eine Site, die lediglich ihre Anmeldeseite anzeigt, beweist überhaupt nichts.
Entfernen Sie die Test-Site, sobald Sie fertig sind:
docker compose --project-name erpnext exec backend \
bench drop-site restore-test.example.comWarum das Festlegen von Versionen bei ERPNext wichtiger ist
Bei einer statischen Website bedeutet ein nicht festgelegter Image-Tag einen unerwarteten Neustart. Bei ERPNext bedeutet er eine Schema-Migration. bench migrate schreibt Datenbanktabellen neu und kann Dokumentdaten neu schreiben. Eine Rücknahme ist nicht möglich. Ein Rollback erfolgt durch die Wiederherstellung eines Backups, nicht durch ein docker compose down.
Legen Sie den Tag daher fest. ERPNEXT_VERSION=v16.32.1 war die Version, die im eigenen Repository-pwd.yml im August 2026 festgelegt war. Am 2026-11-16 legten sowohl pwd.yml als auch example.env v16.55.0 fest. Übernehmen Sie keine dieser Nummern, ohne sie zu prüfen. Aktuelle Releases sind auf der frappe/erpnext-Releases-Seite aufgeführt. Vorhandene Image-Tags finden Sie auf Docker Hub. Lesen Sie die Hinweise für die Version, auf die Sie aktualisieren, bevor Sie das Update durchführen.
Das Upgrade beginnt mit einem Backup und dem Wartungsmodus.
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 onBearbeiten Sie ERPNEXT_VERSION in ~/gitops/erpnext.env. Rendern Sie anschließend die Konfiguration, laden Sie das Image herunter und führen Sie die Migration aus.
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 offDer Wartungsmodus ist wichtig, weil migrate während der Ausführung das Schema ändert. Wenn ein Benutzer ein Dokument in eine teilweise migrierte Tabelle schreibt, müssen Sie die Datensätze möglicherweise manuell reparieren.
Führen Sie jeweils nur ein Major-Release-Upgrade durch und erstellen Sie zwischen den einzelnen Schritten ein Backup. Prüfen Sie vor dem Fortfahren die Migrationshinweise für jedes Major-Release.
Das Repository liefert außerdem overrides/compose.migrator.yaml aus. Dadurch wird ein Container hinzugefügt, der beim Start bench --site all migrate ausführt, wenn Sites vorhanden sind und MIGRATE_SITES aktiviert ist, wie es standardmäßig der Fall ist. Das ist praktisch. Es bedeutet aber auch, dass ein docker compose up mit einem geänderten Tag Ihre Produktionsdatenbank migriert, ohne dass jemand den Vorgang überwacht. Führen Sie migrate auf einem Geschäftssystem als bewusst getroffene Entscheidung für diesen Tag aus.
Hardening eines Servers mit Kundendaten
Ändern Sie das Administratorpasswort bei der ersten Anmeldung. Die Evaluierungs-Compose-Datei verwendet admin als dieses Passwort, und diese Gewohnheit wird oft in Produktionsumgebungen übernommen.
Ändern Sie DB_PASSWORD und ersetzen Sie damit den 123 in example.env. Dieser Wert landet im gerenderten ~/gitops/erpnext.yaml im Klartext. Schützen Sie daher chmod 600 und halten Sie die Datei aus jedem git-Repository heraus. Für eine sicherere Lösung liest overrides/compose.mariadb-secrets.yaml das Passwort aus einer Docker-Secret-Datei statt aus einer Umgebungsvariablen. Umgebungsdateien und Secrets in Docker Compose verwalten erläutert die jeweiligen Vor- und Nachteile.
Veröffentlichen Sie nur die benötigten Ports. Mit dem HTTPS-Override sind nur die Ports 80 und 443 exponiert. Fügen Sie dem Dienst db kein ports-Mapping hinzu, nur damit sich ein Datenbank-Client leichter verbinden kann: Dadurch wäre MariaDB direkt aus dem Internet erreichbar. Verwenden Sie stattdessen docker compose --project-name erpnext exec backend bench mariadb. Erlauben Sie auf dem Host die Ports 22, 80 und 443 und verweigern Sie alle übrigen. Prüfen Sie außerdem die separate Netzwerk-Firewall des Providers.
Aktivieren Sie in den Systemeinstellungen für jedes Konto mit der Rolle System Manager die Zwei-Faktor-Authentifizierung. Diese Rolle kann die Systemeinstellungen ändern. Behandeln Sie sie daher als Administratorkonto und nicht als reine Komfortfunktion. Wenn Sie mehrere selbst gehostete Anwendungen betreiben, ist Authentik als selbst gehosteter Single-Sign-on-Provider besser als ein weiteres Passwort pro Anwendung.
Installieren Sie Sicherheitsupdates auf dem Host und führen Sie bei Kernel-Updates einen Neustart durch. Bevor Sie sich darauf verlassen, dass der Stack wieder startet, prüfen Sie die gerenderte Datei für jeden Dienst auf eine restart-Richtlinie. Ohne eine solche Richtlinie bleibt ein Stack nach diesem Neustart deaktiviert. einen Docker-Compose-Stack nach einem Neustart wieder automatisch starten erläutert die Konfiguration mit systemd.
Wenn ERPNext auf einem VPS nicht mehr ausreicht
Ein VPS kann ein kleines Unternehmen lange Zeit zuverlässig betreiben. Folgende Anzeichen zeigen, dass das nicht mehr der Fall ist:
- Hintergrundaufträge sammeln sich an. E-Mails und Importe treffen daher erst Minuten oder Stunden später ein.
docker inspectmeldet Container mit"OOMKilled": trueoder dem Exit-Code 137.- Berichte, die zuvor zwei Sekunden benötigten, dauern nun dreißig Sekunden. MariaDB belegt dabei den größten Teil der CPU.
- Backups laufen so lange, dass ein Lauf mit dem nächsten geplanten Lauf überlappt.
Geben Sie MariaDB zunächst Ressourcen, die es nicht mit anderen Diensten teilen muss. Die Datenbank und die Python-Worker konkurrieren um denselben Arbeitsspeicher. Der Buffer Pool benötigt davon besonders viel. Ein größerer Anwendungsserver bringt meist weniger als erwartet. Die Datenbank in Docker oder auf dem Host betreiben behandelt diese Entscheidung. Speicherlimits in Docker Compose festlegen verhindert, dass ein Container die anderen aushungert, während Sie die Konfiguration anpassen.
Fügen Sie anschließend Queue-Worker hinzu, statt die Webkapazität zu erhöhen. Die langsamen Aufgaben von ERPNext laufen im Hintergrund, etwa die Berichtserstellung und der Massenimport. Zusätzliche Worker benötigen Reserven bei CPU und Arbeitsspeicher. Container auf einem bereits ausgelasteten VPS zu ergänzen, erhöht die Kapazität nicht.
FAQ
Wie viel RAM benötigt ERPNext auf einem VPS?
Für eine Evaluierung beginnen Sie mit 4 GB und 2 vCPU. Für ein Unternehmen, das ERPNext täglich nutzt, planen Sie 8 GB RAM, 4 vCPU und 100 GB SSD-Speicher ein. Unter Speicherdruck kann der Out-of-Memory-Killer des Kernels Container stoppen. docker inspect meldet dies als "OOMKilled": true mit dem Exit-Code 137. Diese Werte sind Ausgangspunkte und keine Messwerte. Überwachen Sie daher im ersten Monat Ihre tatsächliche Speichernutzung.
Kann ich pwd.yml in der Produktion ausführen?
Nein. Die README des Projekts beschreibt die Datei als ausschließlich für kurzzeitige Evaluierungen vorgesehen. Außerdem weist sie darauf hin, dass darin keine benutzerdefinierten Apps installiert werden können. Verwenden Sie compose.yaml mit den MariaDB-, Redis- und HTTPS-Overrides, erzeugen Sie daraus mit docker compose config eine einzelne Datei und führen Sie diese Datei aus.
Warum ist meine ERPNext-Site direkt nach der Erstellung nicht erreichbar?
Das Frontend wählt standardmäßig anhand des HTTP-Host-Headers aus, welche Site ausgeliefert wird. Der Site-Name muss daher mit der Domain im Browser übereinstimmen. Eine als erpnext erstellte Site wird nicht unter erp.example.com ausgeliefert. Erstellen Sie die Site entweder mit der Domain als Namen, oder setzen Sie FRAPPE_SITE_NAME_HEADER in der env-Datei auf den Site-Namen. Erzeugen Sie die Compose-Datei erneut und starten Sie den Stack neu.
Was muss ein ERPNext-Backup enthalten?
Vier Dateien, die zusammen aufbewahrt werden müssen: der -database.sql.gz-Dump, die Archive -files.tar und -private-files.tar sowie die Konfigurationskopie -site_config_backup.json. bench --site erp.example.com backup --with-files erzeugt alle vier Dateien. Die Konfigurationskopie enthält encryption_key. Ohne diese Datei können gespeicherte Passwörter für Integrationen bei einer Wiederherstellung nicht entschlüsselt werden. Das zeigt sich als Encryption key is invalid! Please check site_config.json.
Wie aktualisiere ich ERPNext, ohne meine Daten zu beschädigen?
Erstellen Sie mit --with-files ein Backup, aktivieren Sie den Wartungsmodus, ändern Sie ERPNEXT_VERSION in Ihrer env-Datei, erzeugen Sie die Compose-Datei erneut, führen Sie pull aus und starten Sie den Stack. Führen Sie anschließend bench --site erp.example.com migrate aus und deaktivieren Sie den Wartungsmodus. Aktualisieren Sie jeweils nur um eine Hauptversion und lesen Sie vorher die Release Notes. migrate schreibt Schema- und Dokumentdaten ohne Rückgängig-Funktion um. Für ein Rollback müssen Sie das Backup wiederherstellen, das Sie zu Beginn erstellt haben.