Installation

Stellen Sie vor Beginn der Installation sicher, dass Ihre Domain korrekt konfiguriert ist. Sie benötigen einen A-Record, der Ihre Domain (z. B. pos.yourdomain.com) auf die IP-Adresse Ihres Servers verweist. Sobald die DNS-Weitergabe abgeschlossen ist, können Sie fortfahren.

Konfigurieren Sie den Webserver-Benutzer

Stellen Sie sicher, dass der Webserver-Benutzer (www-data unter Ubuntu) ordnungsgemäßen Zugriff auf das Projektverzeichnis hat. So werden Berechtigungsprobleme während und nach der Installation vermieden.

sudo chown -R www-data:www-data /var/www && sudo chmod -R 755 /var/www

Wenn Sie in einem benutzerdefinierten Verzeichnis installieren, ersetzen Sie „/var/www“ durch den von Ihnen gewählten Pfad.

Erstellen Sie das NexoPOS-Projekt

Navigieren Sie zu dem Verzeichnis, in dem Sie NexoPOS installieren möchten, und verwenden Sie Composer, um das Projekt zu erstellen:

cd /var/www && composer create-project blair2004/nexopos nexopos --prefer-dist

Nginx oder Apache konfigurieren

Ihr Webserver muss auf das Verzeichnis „/public“ von NexoPOS zeigen.

Nginx-Beispiel:

server {
    listen 80;
    server_name pos.yourdomain.com;

    root /var/www/nexopos/public;
    index index.php index.html;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php8.4-fpm.sock;
    }

    location ~ /\.ht {
        deny all;
    }
}

Apache-Beispiel:

<VirtualHost *:80>
    ServerName pos.yourdomain.com
    DocumentRoot /var/www/nexopos/public

    <Directory /var/www/nexopos/public>
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>

Nachdem Sie die Konfiguration erstellt haben, aktivieren Sie sie und starten Sie Ihren Server neu:

# Nginx
sudo ln -s /etc/nginx/sites-available/nexopos /etc/nginx/sites-enabled/ && sudo systemctl reload nginx

# Apache
sudo a2ensite nexopos.conf && sudo systemctl reload apache2

Erstelle die Datenbank

Greifen Sie auf MariaDB zu und erstellen Sie eine Datenbank sowie einen Benutzer für NexoPOS:

sudo mysql -u root -p

Dann führe Folgendes aus:

CREATE DATABASE nexopos;
CREATE USER 'nexopos_user'@'localhost' IDENTIFIED BY 'strong_password';
GRANT ALL PRIVILEGES ON nexopos.* TO 'nexopos_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Dateiberechtigungen finalisieren

Stellen Sie sicher, dass die Speicher- und Cache-Verzeichnisse beschreibbar sind:

sudo chown -R www-data:www-data /var/www/nexopos && \
sudo chmod -R 775 /var/www/nexopos/storage /var/www/nexopos/bootstrap/cache

Führen Sie den Installationsassistenten aus

Öffnen Sie Ihren Browser und navigieren Sie zu Ihrer Domain:

http://pos.yourdomain.com

Sie werden durch den Installationsassistenten geführt, in dem Sie:

• Datenbankanmeldeinformationen bereitstellen
• Anwendungseinstellungen konfigurieren
• Erstellen Sie das Administratorkonto

Sobald abgeschlossen, ist Ihre NexoPOS-Instanz einsatzbereit.