Umgebung

Wir gehen für diese Dokumentation davon aus, dass Sie bereit sind, NexoPOS in einer Linux-Umgebung zu installieren. Da wir speziell auf Ubuntu 24.04 abzielen, gilt dies auch für 22.04 und 26.06 (weitere Versionen sind derzeit weiterhin kompatibel).

Für eine native Windows-Installation siehe NexoPOS für Windows. Dies kann jedoch auch für Windows Subsystem for Linux (WSL2) gelten.

PHP installieren

Um PHP in Ihrer Umgebung zu installieren, müssen Sie den folgenden Befehl ausführen:

sudo apt update 
sudo apt install -y software-properties-common ca-certificates lsb-release apt-transport-https 
sudo add-apt-repository -y ppa:ondrej/php 
sudo apt update

Nun fahren wir mit der Installation der erforderlichen PHP-Module fort.

sudo apt install -y php8.4 php8.4-cli php8.4-fpm php8.4-common php8.4-mysql php8.4-zip php8.4-gd php8.4-mbstring php8.4-curl php8.4-xml php8.4-bcmath php8.4-intl php8.4-soap php8.4-readline php8.4-opcache php8.4-redis php8.4-imagick php8.4-sqlite3 unzip curl git

Sie können jetzt php -v ausführen, um die installierte PHP-Version zu überprüfen.

Nginx / Apache installieren

Nginx-Installation

Wir beginnen mit Nginx, der Lösung, die wir für die meisten unserer Projekte verwenden.

sudo apt update
sudo apt install -y nginx

Möglicherweise müssen Sie irgendwann den Nginx-Dienst aktivieren, und das können Sie auf diese Weise tun:

sudo systemctl enable nginx 
sudo systemctl start nginx 
sudo systemctl status nginx

möglicherweise möchten Sie den Zugriff auf die Firewall für Nginx freigeben. Dies ist mit dem folgenden Befehl möglich:

sudo ufw allow 'Nginx Full'

Apache-Konfiguration

Wenn Sie Apache statt Nginx verwenden, gilt für Sie der folgende Befehl.

sudo apt update
sudo apt install -y apache2

Wenn Sie den Dienst ebenfalls aktivieren möchten, müssen Sie den folgenden Befehl ausführen:

systemctl enable apache2 
sudo systemctl start apache2 
sudo systemctl status apache2

Die gleiche Firewall-Ausnahme kann auf Apache angewendet werden, indem Sie den folgenden Befehl ausführen:

sudo ufw allow 'Apache Full'

Da Sie Apache für NexoPOS verwenden, muss für Apache ein Modul aktiviert sein:

sudo a2enmod rewrite headers env dir mime && sudo systemctl restart apache2

Composer installieren

Composer ist der Abhängigkeitsmanager, der von Laravel verwendet wird und daher erforderlich ist, um NexoPOS auszuführen. Er übernimmt das Herunterladen und Verwalten aller PHP-Pakete, die die Anwendung benötigt. Ohne Composer kann NexoPOS nicht korrekt installiert oder betrieben werden.

Um Composer global auf Ubuntu 24.04 zu installieren, führen Sie Folgendes aus:

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');" && \
php composer-setup.php --install-dir=/usr/local/bin --filename=composer && \
php -r "unlink('composer-setup.php');"

Sie können die Installation überprüfen mit:

composer --version

MariaDB installieren

MariaDB ist die Datenbank-Engine, die von NexoPOS verwendet wird, um alle Anwendungsdaten zu speichern – einschließlich Verkäufen, Produkten und Konfigurationen. Sie ist vollständig mit Laravel kompatibel und bietet eine zuverlässige, leistungsstarke Alternative zu MySQL.

sudo apt update 
sudo apt install -y mariadb-server mariadb-client 

Wir können den Dienst jetzt mit den folgenden Befehlen aktivieren:

sudo systemctl enable mariadb 
sudo systemctl start mariadb 
sudo systemctl status mariadb

Nach der Installation wird empfohlen, den Datenbankserver abzusichern:

sudo mysql_secure_installation

sudo mysql_secure_installation:

sudo mysql -u root -p

NVM und Node installieren

NVM (Node Version Manager) ermöglicht es dir, mehrere Node.js-Versionen einfach zu installieren und zu verwalten. Das ist für NexoPOS nützlich, wenn du Frontend-Assets mit Tools wie Vite erstellst.

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

Dann lade NVM in deine aktuelle Sitzung:

export NVM_DIR="$HOME/.nvm" && [ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"

Installieren Sie Node.js 24 und legen Sie es als Standardversion fest:

nvm install 24 && nvm use 24 && nvm alias default 24

Sie können alles überprüfen, indem Sie Folgendes ausführen:

node -v && npm -v

Node.js 24 wird jetzt standardmäßig in neuen Terminalsitzungen verwendet.

Erfahren Sie jetzt, wie Sie mit der Installation fortfahren.