So installieren Sie ERPNext auf Ubuntu 22.04

ERPNext ist eine kostenlose und Open-Source-ERP-Software, die von Herstellern, Distributoren und Dienstleistern verwendet wird. Es ist mit Python, JavaScript und dem Frappe-Framework entwickelt. Es ist modern, benutzerfreundlich, kostenlos und für kleine und mittelständische Unternehmen konzipiert, die Unternehmen helfen, alle Aspekte ihrer Geschäftsabläufe zu verwalten. Tausende von Unternehmen weltweit nutzen es zur Verwaltung ihrer ERP-Prozesse. Es ist eines der besten ERP-Systeme, das Fertigung, Distribution, Einzelhandel, Handel, Dienstleistungen, Bildung, gemeinnützige Organisationen und mehr unterstützt.

In diesem Tutorial zeigen wir Ihnen, wie Sie die ERPNext-Software auf einem Ubuntu 22.04-Server installieren.

Voraussetzungen

Ein Server, der Ubuntu 22.04 ausführt.
Eine gültige Domain, die auf Ihren Server verweist.
Ein Root-Passwort, das auf Ihrem Server konfiguriert ist.

Erste Schritte

Zuerst müssen Sie einige Python-Abhängigkeiten auf Ihrem System installieren. Sie können alle mit dem folgenden Befehl installieren:

apt-get install python3-dev libffi-dev git python3-pip python3-testresources libssl-dev wkhtmltopdf gcc g++ make python3.10-venv -y

Sobald alle Python-Abhängigkeiten installiert sind, müssen Sie Node.js auf Ihrem Server installieren.

Zuerst fügen Sie das Node.js-Repository mit dem folgenden Befehl hinzu:

curl -sL https://deb.nodesource.com/setup_16.x | bash -

Als nächstes installieren Sie Node.js und den Redis-Server mit dem folgenden Befehl:

apt-get install nodejs redis-server -y

Sobald beide Pakete installiert sind, installieren Sie das Yarn-Paket, indem Sie den folgenden Befehl ausführen:

npm install -g yarn

Sobald Sie fertig sind, können Sie mit dem nächsten Schritt fortfahren.

Installieren und Konfigurieren der MariaDB-Datenbank

Standardmäßig ist MariaDB im Standard-Repository von Ubuntu 22.04 verfügbar. Sie können es mit dem folgenden Befehl installieren:

apt-get install mariadb-server -y

Sobald es installiert ist, sichern Sie die MariaDB und setzen Sie das MariaDB-Root-Passwort mit dem folgenden Befehl:

mysql_secure_installation

Beantworten Sie alle Fragen wie unten gezeigt, um das MariaDB-Root-Passwort festzulegen und die Installation zu sichern:

Geben Sie das aktuelle Passwort für root ein (für keines eingeben):
Root-Passwort festlegen? [Y/n] Y
Neues Passwort:
Neues Passwort erneut eingeben:
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 die MariaDB gesichert ist, melden Sie sich mit dem folgenden Befehl an der MariaDB-Konsole an:

mysql -u root -p

Als nächstes müssen Sie das MariaDB Innodb-Dateiformat auf Barracuda ändern. Sie können dies tun, indem Sie die Datei /etc/mysql/mariadb.conf.d/50-server.cnf bearbeiten:

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

Fügen Sie die folgenden Zeilen hinzu oder ändern Sie sie:

[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 schließen Sie sie, und starten Sie dann den MariaDB-Dienst neu, um die Änderungen zu implementieren:

systemctl restart mariadb

ERPNext auf Ubuntu 22.04 installieren

Zuerst erstellen Sie einen neuen Benutzer, um ERPNext mit dem folgenden Befehl auszuführen:

useradd -m -s /bin/bash erpnext

Als nächstes setzen Sie das Passwort für ERPNext mit dem folgenden Befehl:

passwd erpnext

Als nächstes fügen Sie den ERPNext-Benutzer zur Sudo-Gruppe mit dem folgenden Befehl hinzu:

usermod -aG sudo erpnext

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

su - erpnext  
nano ~/.bashrc

Fügen Sie die folgende Zeile hinzu:

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

Speichern Sie die Datei und aktivieren Sie die Umgebungsvariable mit dem folgenden Befehl:

source ~/.bashrc

Als nächstes erstellen Sie ein Verzeichnis für ERPNext mit dem folgenden Befehl:

sudo mkdir /opt/bench

Als nächstes setzen Sie den Besitz auf den Benutzer erpnext:

sudo chown -R erpnext:erpnext /opt/bench

Als nächstes wechseln Sie das Verzeichnis zu /opt/bench und klonen das Bench-Repository von GitHub:

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

Als nächstes installieren Sie das Bench-Repo mit dem pip3-Befehl:

pip3 install -e bench-repo

Sobald die Installation abgeschlossen ist, initialisieren Sie das Bench-Verzeichnis mit dem Frappe-Framework mit dem folgenden Befehl:

bench init erpnext

Sie sollten die folgende Ausgabe erhalten:

? Built js/checkout.min.js
? Built js/dialog.min.js
? Built js/social.min.js
? Built js/web_form.min.js
? Built js/list.min.js
? Built js/chat.js
Browserslist: caniuse-lite ist veraltet. Bitte führen Sie den nächsten Befehl aus `yarn upgrade caniuse-lite browserslist`
? Built css/frappe-rtl.css
? Built css/printview.css
? Built js/bootstrap-4-web.min.js
? Built js/barcode_scanner.min.js
? Built css/list.min.css
? Built css/report.min.css
? Built frappe/css/email.css
? Built js/frappe-recorder.min.js
? Built js/desk.min.js
? Built css/frappe-chat-web.css
? Built js/frappe-web.min.js
? Built css/form.min.css
? Built css/web_form.css
? Built css/desk.min.css
? Built css/frappe-web-b4.css
? Built js/control.min.js
? Built js/form.min.js
? Built js/data_import_tools.min.js
? Built js/report.min.js
?  Done in 111.35s
Done in 113.33s.
SUCCESS: Bench erpnext initialisiert

Als nächstes wechseln Sie das Verzeichnis zu erpnext und erstellen eine neue ERPNext-Website mit dem folgenden Befehl:

cd /opt/bench/erpnext  
bench new-site erp.example.com

Sie werden aufgefordert, Ihr MariaDB-Root-Passwort und das Administrator-Passwort wie unten gezeigt einzugeben:

MySQL-Root-Passwort: 

Installing frappe...
Updating DocTypes für frappe        : [========================================] 100%
Updating country info               : [========================================] 100%
Set Administrator-Passwort: 
Neues Administrator-Passwort erneut eingeben: 
* Scheduler ist deaktiviert *
Aktuelle Website auf erp.example.com gesetzt

An diesem Punkt ist ERPNext auf Ihrem System installiert.

Konfigurieren Sie ERPNext für die Produktionsumgebung

Als nächstes müssen Sie Supervisor installieren, um den ERPNext-Prozess zu verwalten, und Nginx als Reverse-Proxy konfigurieren.

Zuerst wechseln Sie den Benutzer zu ERPNext und installieren Supervisor und Nginx mit dem folgenden Befehl:

su - erpnext  
sudo apt-get install supervisor nginx -y

Als nächstes installieren Sie das frappe-bench mit dem folgenden Befehl:

sudo pip3 install frappe-bench

Als nächstes wechseln Sie das Verzeichnis zu /opt/bench/erpnext und richten ERPNext für die Produktionsumgebung mit dem folgenden Befehl ein:

cd /opt/bench/erpnext  
sudo /home/erpnext/.local/bin/bench setup production erpnext

Sobald ERPNext konfiguriert ist, sollten Sie die folgende Ausgabe sehen:

PLAY RECAP ************************************************************************************************************************************
localhost                  : ok=8    changed=4    unreachable=0    failed=0    skipped=1    rescued=0    ignored=0   

$ sudo systemctl restart supervisor
Portkonfigurationsliste:

Website erp.example.com zugewiesener Port: 80
$ /usr/bin/supervisorctl reread
Keine Konfigurationsupdates für Prozesse
$ /usr/bin/supervisorctl update
$ sudo /usr/sbin/nginx -t
nginx: die Konfigurationsdatei /etc/nginx/nginx.conf hat eine korrekte Syntax
nginx: die Konfigurationsdatei /etc/nginx/nginx.conf-Test war erfolgreich
$ sudo systemctl reload nginx

An diesem Punkt ist ERPNext mit Nginx für die Produktionsumgebung konfiguriert.

Zugriff auf die ERPNext-Weboberfläche

Öffnen Sie jetzt Ihren Webbrowser und geben Sie die URL http://erp.example.com ein. Sie werden zur Anmeldeseite von ERPNext weitergeleitet:

ERPNext-Anmeldung

Geben Sie den Benutzernamen als Administrator und ein Passwort, das Sie zuvor festgelegt haben, ein, und klicken Sie auf die Schaltfläche Anmelden. Sie sollten die folgende Seite sehen:

Sprache auswählen

Wählen Sie Ihre gewünschte Sprache, Ihr Land, Ihre Zeitzone und Ihre Währung aus und klicken Sie auf die Schaltfläche Weiter. Sie sollten die folgende Seite sehen:

Benutzer erstellen

Geben Sie Ihren Namen, Ihre E-Mail-Adresse, Ihr Passwort ein und klicken Sie auf die Schaltfläche Einrichtung abschließen. Sie sollten das ERPNext-Dashboard auf der folgenden Seite sehen:

ERPNext-Dashboard

Sichern Sie ERPNext mit Let’s Encrypt SSL

Zuerst müssen Sie den Certbot-Client installieren, um das Let’s Encrypt SSL zu installieren und zu verwalten. Sie können es mit dem folgenden Befehl installieren:

sudo apt-get install certbot python3-certbot-nginx -y

Sobald es installiert ist, führen Sie den folgenden Befehl aus, um Let’s Encrypt SSL für Ihre Domain zu installieren und zu konfigurieren:

sudo certbot --nginx -d erp.example.com

Sie werden aufgefordert, Ihre E-Mail-Adresse anzugeben und den Nutzungsbedingungen zuzustimmen, wie unten gezeigt:

Speichern des Debug-Protokolls unter /var/log/letsencrypt/letsencrypt.log
Ausgewählte Plugins: Authenticator nginx, Installer nginx
Geben Sie die E-Mail-Adresse ein (wird für dringende Erneuerungen und Sicherheitsbenachrichtigungen verwendet) (Geben Sie 'c' ein, um abzubrechen): [email protected]

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Bitte lesen Sie die Nutzungsbedingungen unter
https://letsencrypt.org/documents/LE-SA-v1.2-November-15-2017.pdf. Sie müssen
zustimmen, um sich beim ACME-Server unter
https://acme-v02.api.letsencrypt.org/directory zu registrieren
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
(A) zustimmen/(C) abbrechen: A

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Wären Sie bereit, Ihre E-Mail-Adresse mit der Electronic Frontier
Foundation, einem Gründungspartner des Let's Encrypt-Projekts und der gemeinnützigen
Organisation, die Certbot entwickelt, zu teilen? Wir würden Ihnen gerne E-Mails über unsere Arbeit
zum Verschlüsseln des Webs, EFF-Nachrichten, Kampagnen und Möglichkeiten zur Unterstützung der digitalen Freiheit senden.
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
(J)a/(N)e: Y
Erwerb eines neuen Zertifikats
Durchführung der folgenden Herausforderungen:
http-01-Herausforderung für erp.example.com
Warten auf Überprüfung...
Bereinigung der Herausforderungen
Zertifikat für VirtualHost /etc/nginx/conf.d/erpnext.conf bereitstellen

Als nächstes wählen Sie aus, ob Sie den HTTP-Verkehr auf HTTPS umleiten möchten, wie unten gezeigt:

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
1: Keine Umleitung - Keine weiteren Änderungen an der Webserverkonfiguration vornehmen.
2: Umleitung - Alle Anfragen auf sicheren HTTPS-Zugriff umleiten. Wählen Sie dies für
neue Websites oder wenn Sie sicher sind, dass Ihre Website auf HTTPS funktioniert. Sie können diese
Änderung rückgängig machen, indem Sie die Konfiguration Ihres Webservers bearbeiten.
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Wählen Sie die entsprechende Nummer [1-2] und drücken Sie [Enter] (drücken Sie 'c', um abzubrechen): 2

Geben Sie 2 ein und drücken Sie die Eingabetaste, um den Vorgang abzuschließen. Sie sollten die folgende Ausgabe sehen:

Umleitung aller Datenverkehr auf Port 80 zu SSL in /etc/nginx/conf.d/erpnext.conf

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Herzlichen Glückwunsch! Sie haben erfolgreich https://erp.example.com aktiviert

Sie sollten Ihre Konfiguration testen unter:
https://www.ssllabs.com/ssltest/analyze.html?d=erp.example.com
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

WICHTIGE HINWEISE:
 - Herzlichen Glückwunsch! Ihr Zertifikat und die Kette wurden unter gespeichert:
   /etc/letsencrypt/live/erp.example.com/fullchain.pem
   Ihre Schlüsseldatei wurde gespeichert unter:
   /etc/letsencrypt/live/erp.example.com/privkey.pem
   Ihr Zertifikat läuft am 2022-09-11 ab. Um eine neue oder angepasste
   Version dieses Zertifikats in Zukunft zu erhalten, führen Sie einfach erneut certbot aus
   mit der Option "certonly". Um *alle* Ihre Zertifikate nicht-interaktiv zu erneuern, führen Sie "certbot renew" aus
 - Ihre Kontodaten wurden in Ihrem Certbot
   Konfigurationsverzeichnis unter /etc/letsencrypt gespeichert. Sie sollten jetzt ein
   sicheres Backup dieses Ordners erstellen. Dieses Konfigurationsverzeichnis enthält auch Zertifikate und private Schlüssel, die von Certbot erhalten wurden, sodass
   regelmäßige Backups dieses Ordners ideal sind.
 - Wenn Ihnen Certbot gefällt, ziehen Sie bitte in Betracht, unsere Arbeit zu unterstützen:

   Spenden an ISRG / Let's Encrypt:   https://letsencrypt.org/donate
   Spenden an EFF:                    https://eff.org/donate-le

 - Wir konnten Sie nicht für die EFF-Newsletterliste anmelden, da Ihre
   E-Mail-Adresse ungültig zu sein scheint. Sie können es später erneut versuchen, indem Sie
   https://act.eff.org besuchen.

An diesem Punkt ist Ihre ERPNext-Website mit Let’s Encrypt SSL gesichert. Sie können jetzt sicher auf Ihre Website mit dem HTTPS-Protokoll zugreifen.

Fazit

Herzlichen Glückwunsch! Sie haben ERPNext erfolgreich mit Nginx und Let’s Encrypt SSL auf Ubuntu 22.04 installiert. Zögern Sie nicht, mich zu fragen, wenn Sie Fragen haben. Sie können die ERPNext-Dokumentationsseite für weitere Informationen besuchen.