ERPNext Installation · 7 min read · Oct 12, 2025

Wie man ERPNext auf Ubuntu 18.04 LTS installiert

ERPNext ist eine kostenlose, Open-Source, moderne und benutzerfreundliche Unternehmensverwaltungssoftware, die von Tausenden von Unternehmen weltweit genutzt wird. Es ist eine sehr einfache ERP-Plattform, die den Einzelhandel, Handel, Dienstleistungen, Fertigung, Personalwesen, gemeinnützige Organisationen und andere Sektoren unterstützt. Es ist ein leistungsstarkes und voll ausgestattetes ERP-System, das in Python auf dem Frappe-Framework basiert. Es verwendet Node.js für das Frontend und MariaDB zur Speicherung seiner Daten. ERPNext bietet eine webbasierte Schnittstelle zur Durchführung täglicher Aufgaben. ERPNext bietet ein eingebettetes Berichtssystem mit Integration in die Büroanwendung.

In diesem Tutorial werden wir lernen, wie man ERPNext auf einem Ubuntu 18.04 LTS-Server installiert und konfiguriert.

Anforderungen

  • Ein Server, der Ubuntu 18.04 ausführt.
  • Ein Nicht-Root-Benutzer mit Sudo-Rechten, der auf Ihrem Server eingerichtet ist.

Erste Schritte

Zuerst müssen Sie Ihr System mit der neuesten Version aktualisieren. Sie können dies tun, indem Sie den folgenden Befehl ausführen:

sudo apt-get update -y  
sudo apt-get upgrade -y

Sobald Ihr System aktualisiert ist, müssen Sie einen Benutzer für ERPNext erstellen.

Sie können dies mit dem folgenden Befehl tun:

sudo useradd -m -s /bin/bash erpnext  
sudo passwd erpnext

Als nächstes geben Sie dem ERPNext-Benutzer mit dem folgenden Befehl Sudo-Rechte:

sudo usermod -aG sudo erpnext

Als nächstes melden Sie sich beim ERPNext-Benutzer an und richten Sie die Umgebungsvariable mit dem folgenden Befehl ein:

su - erpnext
nano .bashrc

Fügen Sie die folgende Zeile hinzu:

PATH=$PATH:~/.local/bin/

Speichern und schließen Sie die Datei, wenn Sie fertig sind. Starten Sie dann Ihr System neu, um alle Änderungen anzuwenden.

Installieren Sie die erforderlichen Pakete

Zuerst melden Sie sich mit dem erpnext-Benutzer an und installieren einige Abhängigkeiten, die von ERPNext benötigt werden.

sudo apt-get install libffi-dev python-pip python-dev libssl-dev wkhtmltopdf -y

Als nächstes installieren Sie den Nginx- und MariaDB-Server mit dem folgenden Befehl:

sudo apt-get install nginx mariadb-server -y

Sobald die Installation abgeschlossen ist, müssen Sie einige Änderungen an der Datei 50-server.cnf vornehmen. Sie können dies mit dem folgenden Befehl tun:

sudo nano /etc/mysql/mariadb.conf.d/50-server.cnf

Nehmen Sie die folgenden Änderungen vor:

[mysqld]
innodb-file-format=barracuda
innodb-file-per-table=1
innodb-large-prefix=1
character-set-client-handshake = FALSE
character-set-server = utf8mb4
collation-server = utf8mb4_unicode_ci

[mysql]
default-character-set = utf8mb4

Speichern und schließen Sie die Datei. Starten Sie dann den MariaDB-Dienst neu, um alle Änderungen anzuwenden:

sudo systemctl restart mariadb

Sie können jetzt den Status des MariaDB-Servers mit dem folgenden Befehl überprüfen:

sudo systemctl status mariadb

Sie sollten die folgende Ausgabe sehen:

? mariadb.service - MariaDB 10.1.38-Datenbankserver
   Loaded: loaded (/lib/systemd/system/mariadb.service; enabled; vendor preset: enabled)
   Active: active (running) since Sat 2019-02-16 06:26:48 UTC; 2h 38min ago
     Docs: man:mysqld(8)
           https://mariadb.com/kb/en/library/systemd/
  Process: 4640 ExecStartPost=/bin/sh -c systemctl unset-environment _WSREP_START_POSITION (code=exited, status=0/SUCCESS)
  Process: 4636 ExecStartPost=/etc/mysql/debian-start (code=exited, status=0/SUCCESS)
  Process: 4505 ExecStartPre=/bin/sh -c [ ! -e /usr/bin/galera_recovery ] && VAR= ||   VAR=`/usr/bin/galera_recovery`; [ $? -eq 0 ]   && systemctl set-
  Process: 4503 ExecStartPre=/bin/sh -c systemctl unset-environment _WSREP_START_POSITION (code=exited, status=0/SUCCESS)
  Process: 4482 ExecStartPre=/usr/bin/install -m 755 -o mysql -g root -d /var/run/mysqld (code=exited, status=0/SUCCESS)
 Main PID: 4607 (mysqld)
   Status: "Nehme jetzt Ihre SQL-Anfragen entgegen..."
    Tasks: 31 (limit: 1111)
   CGroup: /system.slice/mariadb.service
           ??4607 /usr/sbin/mysqld

Aug 16 06:26:47 ubuntu1804 systemd[1]: Starting MariaDB 10.1.38-Datenbankserver...
Aug 16 06:26:48 ubuntu1804 mysqld[4607]: 2019-02-16  6:26:48 140715015396480 [Hinweis] /usr/sbin/mysqld (mysqld 10.1.38-MariaDB-0ubuntu0.18.04.1) startet
Aug 16 06:26:48 ubuntu1804 systemd[1]: Started MariaDB 10.1.38-Datenbankserver.
Aug 16 06:26:48 ubuntu1804 /etc/mysql/debian-start[4642]: Upgrade der MySQL-Tabellen, falls erforderlich.
Aug 16 06:26:48 ubuntu1804 /etc/mysql/debian-start[4659]: /usr/bin/mysql_upgrade: die '--basedir'-Option wird immer ignoriert
Aug 16 06:26:48 ubuntu1804 /etc/mysql/debian-start[4659]: Suche nach 'mysql' als: /usr/bin/mysql
Aug 16 06:26:48 ubuntu1804 /etc/mysql/debian-start[4659]: Suche nach 'mysqlcheck' als: /usr/bin/mysqlcheck
Aug 16 06:26:48 ubuntu1804 /etc/mysql/debian-start[4659]: Diese Installation von MySQL ist bereits auf 10.1.38-MariaDB aktualisiert, verwenden Sie --force, wenn Sie es weiterhin n
Aug 16 06:26:48 ubuntu1804 /etc/mysql/debian-start[4677]: Überprüfung auf unsichere Root-Konten.
Aug 16 06:26:48 ubuntu1804 /etc/mysql/debian-start[4681]: Auslösen von myisam-recover für alle MyISAM-Tabellen und aria-recover für alle Aria-Tabellen

Installieren Sie Redis und Node.js

Als nächstes müssen Sie Redis und Node.js auf Ihrem System installieren. Sie können sie installieren, indem Sie den folgenden Befehl ausführen:

sudo curl --silent --location https://deb.nodesource.com/setup_8.x | sudo bash -  
sudo apt-get install gcc g++ make -y  
sudo apt-get install nodejs redis-server -y  
sudo npm install -g yarn

Konfigurieren Sie MariaDB

Standardmäßig ist die MariaDB-Installation nicht gesichert, daher müssen Sie sie zuerst sichern. Sie können dies mit dem folgenden Befehl tun:

sudo mysql_secure_installation

Beantworten Sie alle Fragen wie unten gezeigt:

    Geben Sie das aktuelle Passwort für root ein (leer für keines):
    Root-Passwort festlegen? [Y/n]: N
    Anonyme Benutzer entfernen? [Y/n]: Y
    Root-Login aus der Ferne verbieten? [Y/n]: Y
    Testdatenbank und Zugriff darauf entfernen? [Y/n]:  Y
    Berechtigungstabellen jetzt neu laden? [Y/n]:  Y

Sobald MariaDB gesichert ist, melden Sie sich mit dem folgenden Befehl an der MariaDB-Shell an:

sudo mysql -u root -p

Geben Sie Ihr Root-Passwort ein, wenn Sie dazu aufgefordert werden. Erstellen Sie dann eine Datenbank und einen Benutzer für ERPNext mit dem folgenden Befehl:

MariaDB [(none)]> create database erpnextdb;  
MariaDB [(none)]> create user erpnextuser@localhost identified by 'password';

Als nächstes gewähren Sie alle Berechtigungen an ERPNext mit dem folgenden Befehl:

MariaDB [(none)]> GRANT ALL ON erpnextdb.* TO 'erpnextuser'@'localhost' IDENTIFIED BY 'password' WITH GRANT OPTION;  
MariaDB [(none)]> GRANT all privileges on *.* to 'root'@'localhost' IDENTIFIED BY 'admin@123' WITH GRANT OPTION;

Als nächstes spülen Sie die Berechtigungen und verlassen Sie die MariaDB-Shell mit dem folgenden Befehl:

MariaDB [(none)]> FLUSH PRIVILEGES;  
MariaDB [(none)]> EXIT;

Installieren Sie ERPNext

Zuerst erstellen Sie ein Verzeichnis für ERPNext und geben die entsprechenden Berechtigungen mit dem folgenden Befehl:

sudo mkdir -p /opt/erpnext  
sudo chown -R erpnext /opt/erpnext/

Als nächstes wechseln Sie in das Verzeichnis erpnext und installieren erpnext mit dem folgenden Befehl:

cd /opt/erpnext
git clone https://github.com/frappe/bench bench-repo

Ausgabe:

Cloning into 'bench-repo'...
remote: Enumerating objects: 19, done.
remote: Counting objects: 100% (19/19), done.
remote: Compressing objects: 100% (14/14), done.
remote: Total 6144 (delta 10), reused 13 (delta 5), pack-reused 6125
Receiving objects: 100% (6144/6144), 29.70 MiB | 231.00 KiB/s, done.
Resolving deltas: 100% (3924/3924), done.

Als nächstes installieren Sie bench mit dem pip-Befehl:

sudo pip install -e bench-repo

Als nächstes initialisieren Sie das Bench-Verzeichnis mit dem Frappe-Framework:

bench init erpnext

Ausgabe:

Building frappe assets...

? Built js/print_format_v3.min.js
? Built js/dialog.min.js
? Built js/web_form.min.js
? Built js/social.min.js
? Built js/modules.min.js
? Built js/form.min.js
? Built js/list.min.js
? Built js/frappe-vue.min.js
? Built js/chat.js
? Built js/desk.min.js
? Built js/control.min.js
? Built css/frappe-rtl.css
? Built css/module.min.css
? Built css/report.min.css
? Built css/form.min.css
? Built css/list.min.css
? Built frappe/css/email.css
? Built css/web_form.css
? Built css/frappe-web.css
? Built css/desk.min.css
? Built js/frappe-web.min.js
? Built js/report.min.js
?  Done in 31.313s
Done in 34.43s.
INFO:bench.utils:setting up backups
no crontab for erpnext
INFO:bench.utils:setting up auto update
no crontab for erpnext
Bench erpnext initialized

Als nächstes wechseln Sie in das Verzeichnis erpnext und erstellen eine neue Site für die Domain node1.example.com mit dem folgenden Befehl:

bench new-site node1.example.com

Sie werden aufgefordert, Ihr MySQL-Root-Passwort anzugeben, wie unten gezeigt:

MySQL root password:

Geben Sie Ihr Root-Passwort ein und drücken Sie die Eingabetaste. Sie sollten die folgende Ausgabe sehen:

Installing frappe...
Updating DocTypes for frappe        : [========================================]
Updating country info               : [========================================]
Set Administrator password: 
Re-enter Administrator password: 
* Scheduler is disabled *

Als nächstes gewähren Sie die entsprechenden Berechtigungen an erpnext mit dem folgenden Befehl:

sudo chown -R erpnext:erpnext /opt/erpnext/erpnext

Schließlich starten Sie den Server mit dem folgenden Befehl:

bench start

Sie sollten die folgende Ausgabe sehen:

06:34:02 web.1            |  * Running on http://0.0.0.0:8000/ (Drücken Sie CTRL+C, um zu beenden)
06:34:02 web.1            |  * Restarting with inotify reloader
06:34:03 watch.1          | yarn run v1.13.0
06:34:03 watch.1          | $ node rollup/watch.js
06:34:03 web.1            |  * Debugger is aktiv!
06:34:04 web.1            |  * Debugger PIN: 159-307-235
06:34:13 watch.1          | 
06:34:13 watch.1          | Rollup Watcher Started
06:34:13 watch.1          | 
06:34:13 watch.1          | Watching...
06:34:15 watch.1          | Rebuilding frappe-web.css

Zugriff auf ERPNext

ERPNext ist jetzt installiert und hört auf Port 8000. Öffnen Sie Ihren Webbrowser und geben Sie die URL http://node1.example.come:8000 ein. Sie werden auf die folgende Seite weitergeleitet:

ERPNext Login

Geben Sie jetzt den Benutzernamen als Administrator und das Passwort ein, das Sie während der Einrichtung angegeben haben. Klicken Sie dann auf die Schaltfläche Anmelden. Sie sollten die folgende Seite sehen:

Sprache auswählen

Wählen Sie als nächstes Ihre Sprache aus und klicken Sie auf die Schaltfläche Weiter. Sie sollten die folgende Seite sehen:

Unternehmensnamen festlegen

Wählen Sie als nächstes Ihr Land aus und klicken Sie auf die Schaltfläche Weiter. Sie sollten die folgende Seite sehen:

Einen ersten Benutzer hinzufügen

Geben Sie als nächstes Ihren vollständigen Namen und Ihre E-Mail-Adresse ein. Klicken Sie dann auf die Schaltfläche Einrichtung abschließen. Sie sollten die folgende Seite sehen:

ERPNext Dashboard

Herzlichen Glückwunsch! Sie haben ERPNext erfolgreich auf dem Ubuntu 18.04-Server installiert und konfiguriert. Sie können ERPNext jetzt einfach in einer Produktionsumgebung einrichten.

Share: X/Twitter LinkedIn
#ERPNext Installation

Erhalte neue Beiträge in deinem Posteingang.

Kein Spam. Jederzeit abmelden.