So installieren Sie ERPNext auf Debian 12

ERPNext ist eine Open-Source-Lösung für Enterprise Resource Planning (ERP). ERPNext kann in verschiedenen Branchen wie Fertigung, Distribution, Einzelhandel, Handel, Dienstleistungen, Bildung, Non-Profit und Gesundheitswesen eingesetzt werden. Es bietet auch Module wie Buchhaltung, CRM, Vertrieb, Einkauf, Website, E-Commerce, Point of Sale, Fertigung, Lagerverwaltung, Projektmanagement, Inventar und Dienstleistungen an.

ERPNext ist eine Unternehmens-ERP-Plattform, die unter der GNU General Public Licence v3 lizenziert ist. Es ist hauptsächlich in Python und JavaScript geschrieben und wurde von Frappe Technologies Pvt. Ltd. entwickelt. ERPNext ist eine Anwendung, die unter dem frappeframework, einem Open-Source-Webframework in Python und JavaScript, geschrieben wurde.

ERPNext wurde als Alternative zu Diensten wie NetSuite von Oracle, QAD, Tython, OpenBrave und Odoo entwickelt. In Bezug auf die Funktionalität ähnelt ERPNext Odoo (ehemals OpenERP).

In diesem Tutorial führen wir Sie durch die Installation von ERPNext auf dem Debian 12-Server. Sie installieren ERPNext mit einem MariaDB-Datenbankserver, Nginx als Reverse-Proxy und einem Supervisor-Prozessmanager.

Voraussetzungen

Um zu beginnen, stellen Sie sicher, dass Sie Zugriff auf haben:

• Einen Debian 12-Server.
• Einen Nicht-Root-Benutzer mit sudo-Administratorrechten.
• Einen Domainnamen, der auf die Server-IP-Adresse zeigt.

Abhängigkeiten installieren

ERPNext ist eine Open-Source-ERP- und CRM-Software, die in Python geschrieben ist. Um ERPNext zu installieren, müssen Sie Abhängigkeiten wie Python 3, MariaDB-Server, Node.js, Yarn-Paketmanager, Nginx, Supervisor-Prozessmanager und Redis auf Ihrem Debian-Server installieren.

In diesem ersten Schritt installieren Sie die ERPNext-Abhängigkeiten aus dem Debian-Repository. Dann überprüfen Sie auch jede Abhängigkeit, um sicherzustellen, dass alles installiert ist.

Bevor Sie die Abhängigkeiten installieren, führen Sie den folgenden Befehl aus, um Ihr Debian-Paket-Index zu aktualisieren.

sudo apt update

Führen Sie nun den folgenden Befehl aus, um die Abhängigkeiten für ERPNext zu installieren, einschließlich Python 3.11, Node.js, NPM, MariaDB-Server, Nginx-Webserver, Supervisor-Prozessmanager und Redis-Server.

sudo apt install python3-dev python3-venv nodejs yarnpkg npm redis-server mariadb-server nginx supervisor fail2ban libffi-dev git python3-pip python3-testresources libssl-dev wkhtmltopdf gcc g++ make

Geben Sie y ein, um mit der Installation fortzufahren.

Sobald die Abhängigkeiten installiert sind, überprüfen Sie jede Abhängigkeit, indem Sie den folgenden Befehl ausführen. Sie werden einige Dienste über den systemctl-Befehl überprüfen, um sicherzustellen, dass jeder Dienst läuft und aktiviert ist.

Überprüfen Sie den MariaDB-Server mit dem folgenden Befehl.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

Überprüfen Sie den Nginx-Dienst, um sicherzustellen, dass der Dienst läuft und aktiviert ist.

sudo systemctl is-enabled nginx  
sudo systemctl status nginx

Überprüfen Sie nun den Supervisor-Prozessmanager-Dienst mit dem folgenden Befehl.

sudo systemctl is-enabled supervisor  
sudo systemctl status supervisor

Überprüfen Sie dann Redis, um sicherzustellen, dass es verfügbar und bereit für die ERPNext-Produktion ist.

sudo systemctl is-enabled redis-server  
sudo systemctl status redis-server

Überprüfen Sie als Nächstes die Node.js- und NPM-Versionen mit dem folgenden Befehl.

node --version  
npm --version

Die folgende Ausgabe bestätigt, dass Node.js v18.x und NPM 1.22 installiert sind.

Überprüfen Sie zuletzt die wkhtmltopdf-Version mit dem folgenden Befehl. Sie sollten sehen, dass die wkhtmltopdf-Version 0.12 installiert ist.

wkhtmltopdf --version  
wkhtmltoimage --version

MariaDB-Server konfigurieren

Nachdem Sie die Abhängigkeiten installiert haben, konfigurieren Sie Ihren MariaDB-Server, um sicherzustellen, dass er bereit für die ERPNext-Installation ist. ERPNext erfordert, dass das Barracuda-Format aktiviert und der Standardzeichensatz auf utf8mb4 konfiguriert ist. Sie werden auch Ihren MariaDB-Server über das Dienstprogramm mariadb-secure-installation sichern.

Führen Sie den Befehl mariadb-secure-installation aus, um Ihre MariaDB-Serverinstallation zu sichern.

sudo mariadb-secure-installation

Geben Sie Y ein, um zu bestätigen, wenn Sie nach den folgenden Konfigurationen gefragt werden:

• Lokale Authentifizierung auf unix_socket umschalten? Geben Sie n für nein ein.
• MariaDB-Root-Passwort einrichten? Geben Sie y ein, geben Sie dann das neue MariaDB-Root-Passwort ein und wiederholen Sie es.
• Den Standard-anonymen Benutzer entfernen? Geben Sie y ein, um zu bestätigen.
• Remote-Login für den Root-Benutzer deaktivieren? Geben Sie y ein, um zu bestätigen.
• Die Standarddatenbank-Test entfernen? Geben Sie y ein, um zu bestätigen.
• Tabellenberechtigungen neu laden und Änderungen anwenden? Geben Sie y ein, um zu bestätigen.

Öffnen Sie nun die MariaDB-Serverkonfiguration /etc/mysql/mariadb.conf.d/50-server.cnf mit dem folgenden Nano-Editor.

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

Fügen Sie die folgende Konfiguration im Abschnitt [mysqld] ein, um das Barracuda-Format zu aktivieren und den Standardzeichensatz auf utf8mb4 einzustellen.

[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

Speichern Sie die Datei und beenden Sie den Editor, wenn Sie fertig sind.

Öffnen Sie als Nächstes die Datei /etc/mysql/mariadb.conf.d/50-mysql-clients.cnf mit dem Nano-Editor, um die MariaDB-Clientverbindung zu konfigurieren.

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

Fügen Sie die folgende Konfiguration im Abschnitt [mysql] hinzu.

[mysql]  
default-character-set = utf8mb4

Speichern und beenden Sie die Datei.

Führen Sie zuletzt den folgenden Befehl aus, um den MariaDB-Server neu zu starten und die neue Konfiguration anzuwenden.

sudo systemctl restart mariadb

Bench-Befehlszeilentool installieren

Ein Bench ist ein Befehlszeilentool zur Verwaltung von Frappe-Frameworks, einschließlich Anwendungen und Sites. ERPNext ist eine Webanwendung, die mit dem Frappe-Framework geschrieben wurde, Sie müssen es über Bench installieren.

Vervollständigen Sie den folgenden Abschnitt, um einen neuen Benutzer zu erstellen, der für ERPNext verwendet wird, und installieren Sie dann das Bench-Dienstprogramm auf Ihrem Debian-System.

Zuerst führen Sie den folgenden Befehl aus, um einen neuen Benutzer frappe hinzuzufügen, geben Sie das neue Passwort ein und wiederholen Sie es.

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

Fügen Sie den Benutzer frappe zur Sudo-Gruppe hinzu, um ihm zu erlauben, den Sudo-Befehl auszuführen.

sudo usermod -aG sudo frappe

Melden Sie sich als neuer Benutzer frappe an und installieren Sie das frappe-bench oder das Bench-Paket über den Pip-Python-Paketmanager.

su - frappe  
sudo pip3 install frappe-bench --break-system-packages

Sobald das frappe-bench installiert ist, überprüfen Sie es mit dem folgenden Befehl. In diesem Beispiel ist Bench 5.17 unter /usr/local/bin/bench installiert.

which bench  
bench --version

ERPNext über Bench installieren

In diesem Abschnitt installieren Sie ERPNext über die Bench-Befehlszeile. Sie initialisieren das Frappe-Framework-Projekt, erstellen eine neue Site und laden dann die ERPNext-Anwendung in das Frapper-Projekt herunter und installieren sie.

Zuerst führen Sie den folgenden Bench-Befehl aus, um das Frappe-Framework 14 im Verzeichnis frappe-bench zu initialisieren.

bench init --python python3.11 --frappe-branch version-14 frappe-bench

Unten sollten Sie sehen, dass die Installation des Frappe-Frameworks beginnt.

Sobald es initialisiert ist, sollten Sie die folgende Ausgabe erhalten:

Führen Sie nun den folgenden Befehl aus, um Benutzern zu erlauben, das Frappe-Framework auszuführen. Dies ermöglicht Gruppen wie www-data, das Frappe-Framework auszuführen.

sudo chmod -R o+rx /home/frappe/frappe-bench

Wechseln Sie als Nächstes in das Installationsverzeichnis des Frappe-Frameworks ~/frappe-bench und erstellen Sie eine neue Site erp.howtoforge.local.

cd ~/frappe-bench  
bench new-site erp.howtoforge.local --admin-password 'erpadmin' --mariadb-root-username root --mariadb-root-password 'password'

Unten ist die Ausgabe, die Sie erhalten, nachdem die neue Site erstellt wurde.

Wechseln Sie zur neuen Site erp.howtoforge.local, indem Sie den folgenden Bench-Befehl ausführen.

bench use erp.howtoforge.local

Sobald Sie gewechselt haben, sollten Sie die Ausgabe Aktuelle Site auf erp.howtoforge.local gesetzt sehen.

Führen Sie nun den folgenden Bench-Befehl aus, um die Zahlungen und die nächsten Anwendungen herunterzuladen.

bench get-app payments  
bench get-app --branch version-14 erpnext

Sobald erpnext heruntergeladen ist, führen Sie den folgenden Befehl aus, um es auf der Site erp.howtoforge.local zu installieren. Dies wird auch automatisch die Zahlungsanwendung installieren.

bench --site erp.howtoforge.local install-app erpnext

Nachdem die Installation abgeschlossen ist, führen Sie den folgenden Befehl aus, um den Scheduler zu aktivieren und die Wartung auf der Site erp.howtoforge.local zu deaktivieren.

bench --site erp.howtoforge.local enable-scheduler  
bench --site erp.howtoforge.local set-maintenance-mode off

An diesem Punkt ist ERPNext installiert, Sie werden ERPNext konfigurieren, indem Sie Nginx als Reverse-Proxy und Supervisor als Prozessmanager für Ihre ERPNext-Installation hinzufügen.

ERPNext für die Produktion vorbereiten

In diesem Schritt richten Sie ERPNext für die Produktion ein, indem Sie Nginx als Reverse-Proxy und Supervisor als Prozessmanager konfigurieren, was automatisch über Bench erfolgen kann.

Führen Sie den folgenden Befehl aus, um die ERPNext-Installation zu konfigurieren. Dies wird Ansible herunterladen und installieren und dann Nginx automatisch als Reverse-Proxy und Supervisor-Prozessmanager konfigurieren.

sudo pip3 install ansible --break-system-packages  
sudo bench setup production frappe

Unten ist eine automatische Konfiguration von Nginx und Supervisor für Ihre ERPNext-Installation.

Wenn ein Fehler auftritt, können Sie auch sowohl Nginx als auch Supervisor mit dem folgenden Befehl konfigurieren.

sudo bench setup supervisor  
sudo bench setup nginx  
sudo bench setup production frappe

Starten Sie als Nächstes die Nginx- und Supervisor-Dienste neu, um sicherzustellen, dass die neuen Änderungen angewendet werden.

sudo systemctl restart nginx supervisor

Führen Sie nun den folgenden Befehl aus, um den Nginx-Dienst zu überprüfen und sicherzustellen, dass der Dienst läuft.

sudo systemctl status nginx

Die folgende Ausgabe zeigt an, dass Nginx läuft.

Führen Sie zuletzt den Befehl supervisorctl aus, um die Liste der ERPNext-Prozesse mit dem Supervisor zu überprüfen.

sudo supervisorctl status

Wenn alles gut geht, sollten Sie jeden Prozess mit dem Status RUNNING sehen.

Mit Nginx und Supervisor konfiguriert, sind Sie bereit, Ihre ERPNext-Installation über Ihren Webbrowser zu starten.

ERPNext-Installation über den Webinstaller

Starten Sie Ihren Webbrowser und besuchen Sie den Domainnamen Ihrer ERPNext-Installation, z. B. http://erp.howtoforge.local/. Wenn Ihre ERPNext-Installation erfolgreich ist, sollten Sie die Anmeldeseite von ERPNext sehen.

Geben Sie den Standardbenutzer Administrator und das Passwort ein, das Sie konfiguriert haben, und klicken Sie auf Anmelden.

Wählen Sie die Standardsprache, die Zeitzone, das Land und die Währung aus. Klicken Sie dann auf Weiter, um fortzufahren.

Geben Sie nun die Details Ihres ersten ERPNext-Benutzers ein und klicken Sie auf Weiter.

Geben Sie zuletzt die Details Ihrer Organisation ein und klicken Sie auf die Schaltfläche Einrichtung abschließen, um die ERPNext-Installation abzuschließen.

Wenn Ihre Installation erfolgreich ist, sollten Sie das ERPNext-Dashboard wie folgt erhalten:

Jetzt ist die ERPNext-Installation abgeschlossen.

Fazit

Herzlichen Glückwunsch! Sie haben die Installation von ERPNext auf Debian 12 mit dem MariaDB-Server und dem Nginx-Webserver abgeschlossen. Sie haben ERPNext über die Bench-Befehlszeile auf Ihrem Debian-Server installiert, und jetzt können Sie ERPNext als Ihre Enterprise Resource Planning für Ihre Organisation verwenden.