Paymenter installieren

Paymenter ist eine quelloffene Abrechnungs- und Shop-Software für Hosting-Anbieter, digitale Produkte und Dienstleistungen. Diese Anleitung zeigt die Installation auf einem eigenen Linux-Server – klassisch („Bare-Metal“) oder per Docker – und die Schritte, die danach für einen sicheren Betrieb wichtig sind.

Voraussetzungen

• Ein Linux-Server, zum Beispiel Ubuntu 24.04 oder Debian 12, mit Root- oder sudo-Zugang
• Eine Domain, die auf den Server zeigt (für HTTPS)
• PHP 8.3 mit den üblichen Laravel-Erweiterungen, MariaDB oder MySQL, Redis, Nginx und Composer
• Etwa 30 Minuten Zeit

Variante A: Bare-Metal-Installation

1. Pakete installieren. Installiere PHP 8.3 samt Erweiterungen, MariaDB, Redis, Nginx und Composer. Die genaue Paketliste für deine Distribution steht in der offiziellen Paymenter-Dokumentation.

2. Datenbank anlegen. Erstelle eine Datenbank und einen eigenen Benutzer mit Rechten nur für diese Datenbank:

CREATE DATABASE paymenter;
CREATE USER 'paymenter'@'127.0.0.1' IDENTIFIED BY 'ein-starkes-passwort';
GRANT ALL PRIVILEGES ON paymenter.* TO 'paymenter'@'127.0.0.1';
FLUSH PRIVILEGES;

3. Paymenter herunterladen. Lade die aktuelle Version nach /var/www/paymenter und setze die Schreibrechte:

mkdir -p /var/www/paymenter && cd /var/www/paymenter
curl -Lo paymenter.tar.gz https://github.com/paymenter/paymenter/releases/latest/download/paymenter.tar.gz
tar -xzvf paymenter.tar.gz && rm paymenter.tar.gz
chmod -R 755 storage/* bootstrap/cache/

4. Konfigurieren. Umgebungsdatei anlegen, Abhängigkeiten installieren, Schlüssel erzeugen:

cp .env.example .env
composer install --no-dev --optimize-autoloader
php artisan key:generate --force
php artisan storage:link

Trage anschließend die Datenbank-Zugangsdaten in die .env ein (DB_DATABASE, DB_USERNAME, DB_PASSWORD).

Wichtig: Sichere den APP_KEY aus der .env an einem zweiten Ort. Mit ihm werden sensible Daten verschlüsselt – geht er verloren, sind diese Daten auch mit einem Datenbank-Backup nicht wiederherstellbar.

5. Datenbank einrichten und initialisieren.

php artisan migrate --force --seed
php artisan app:init
php artisan app:user:create

app:init fragt nach Firmenname und URL, app:user:create legt dein Admin-Konto an.

6. Hintergrunddienste. Paymenter braucht einen Cronjob für geplante Aufgaben und einen Queue-Worker für E-Mails und Bereitstellungen:

# crontab -e (als root)
* * * * * php /var/www/paymenter/artisan schedule:run >> /dev/null 2>&1

Den Queue-Worker richtest du als systemd-Dienst ein (php artisan queue:work, Benutzer www-data, Restart=always) und aktivierst ihn mit systemctl enable --now.

7. Webserver und HTTPS. Richte einen Nginx-Server-Block mit Document-Root /var/www/paymenter/public ein und hole ein Zertifikat, etwa mit Certbot. Zum Schluss den Besitzer setzen: chown -R www-data:www-data /var/www/paymenter/*.

Variante B: Docker

Paymenter stellt offizielle Container und eine Compose-Datei bereit. Der Ablauf:

1. Compose-Datei und .env aus der offiziellen Dokumentation übernehmen und Passwörter setzen.
2. Container starten: docker compose up -d.
3. Einmalig initialisieren: docker compose exec paymenter php artisan app:init und docker compose exec paymenter php artisan app:user:create.
4. Einen Reverse-Proxy (z. B. Traefik oder Nginx) mit HTTPS davorschalten.

Docker trennt Paymenter sauber vom System und erleichtert Updates. Eigene Themes werden dabei im Container gebaut, nicht auf dem Host – das ist bei Erweiterungen wie Tindra zu beachten.

Nach der Installation: die fünf wichtigsten Schritte

1. Backups: Datenbank, .env und storage/ regelmäßig sichern – auf ein getrenntes System.
2. Updates: Paymenter und das Betriebssystem aktuell halten; vor jedem Update ein Backup.
3. E-Mail-Versand: SMTP einrichten und testen, sonst kommen Rechnungen und Passwort-Links nicht an.
4. Zahlungsanbieter: Mindestens ein Gateway aktivieren und eine Testbestellung durchspielen.
5. Rechtstexte: Impressum, Datenschutzerklärung und AGB anlegen, bevor der Shop öffentlich erreichbar ist.

Wie Holzmodem helfen kann

Mit Tindra gestaltest du Startseite und Shop ohne Code, AuthentikSSO bringt Single Sign-On, Faktora erzeugt E-Rechnungen nach EN 16931. Und wenn du Paymenter gar nicht selbst betreiben möchtest, übernehmen wir das im Managed Self-Hosting.