Zum Inhalt springen
PPlazello
Suchen…Ctrl K

Fehlerbehebung

Hier finden Sie typische Meldungen bei Installation, Start und Updates einer selbst gehosteten Installation – und wie Sie sie beheben.

Erste Anlaufstelle: die Startseite und das Protokoll

Die Startseite im Browser. Kann der Shop nicht starten, zeigt er unter seiner Adresse die Seite Der Shop konnte nicht starten – bis zum Abschluss der Einrichtung mit der genauen Ursache, Hinweisen in einfachen Worten und den letzten Protokollzeilen. Nach der Einrichtung sehen Besucher nur noch eine neutrale Meldung; die Details stehen dann im Protokoll. Während des Starts erscheint Der Shop startet gerade …; diese Seite lädt sich von selbst neu.

Das Protokoll. Alles, was der Shop ausgibt, landet zusätzlich in der Datei data/logs/shop.log (ältere Einträge in shop.log.1). Sie ist über den Dateimanager des Hosting-Panels erreichbar, auch wenn das Protokoll des Panels selbst schwer zu finden ist. Bei Docker: docker compose logs app.

Fehler-ID. Zeigt der Admin eine Fehlerseite wie Da ist etwas schiefgelaufen mit einer Fehler-ID, suchen Sie diese ID in data/logs/shop.log – dort steht die zugehörige Fehlermeldung.

Start und Hosting-Panel

Anzeichen Lösung
Fehler 500 oder „Web application could not be started“ Anwendungsstamm muss der Ordner sein, der server.js enthält; Startdatei server.js. Öffnen Sie die Adresse des Shops – die Startseite nennt meist die Ursache. Zeigt sie nichts, den Anwendungsmodus im Panel vorübergehend auf development stellen, App neu starten und die Seite neu laden.
„Cannot find module“ Anwendungsstamm prüfen. Das Paket als Archiv hochladen und auf dem Server entpacken – nicht Datei für Datei hochladen, dabei gehen leicht Dateien verloren.
„Node.js … is too old“, „Unsupported engine“ oder Syntaxfehler Node.js-Version zu alt. Im Panel Node.js 22 oder 24 wählen (mindestens 20.12).
502/503 direkt nach dem Start Der erste Start legt die Datenbanktabellen an und dauert etwa eine halbe Minute. Kurz warten, dann das Protokoll prüfen.
„The data folder … is not writable“ Dem Benutzer, unter dem Node.js läuft, Schreibrechte auf den Ordner data/ geben.
Zu wenig Arbeitsspeicher („JavaScript heap out of memory“, „Killed“) Der Shop braucht rund 600 MB Arbeitsspeicher. Speicherlimit im Hosting-Paket prüfen.
Konfigurationsdateien sind im Browser abrufbar Der Dokumentenstamm zeigt auf den Anwendungsordner. Stellen Sie ihn auf den leeren Ordner public innerhalb des Anwendungsordners um.

Web-Installer

Anzeichen Lösung
„Der Installations-Code stimmt nicht.“ Den Code aus data/setup-token.txt verwenden (bei Docker im Protokoll). Geht die Datei verloren, App neu starten – bis zum Abschluss der Einrichtung wird ein Code erzeugt und ins Protokoll geschrieben.
„Benutzername oder Passwort ist falsch.“ Zugangsdaten des Datenbank-Benutzers im Panel prüfen oder ein neues Passwort setzen.
„Diese Datenbank gibt es nicht.“ Datenbank im Panel anlegen oder den Namen prüfen.
„Der Benutzer hat keine Rechte auf diese Datenbank“ Den Benutzer im Panel der Datenbank zuweisen (mit dem Recht, Tabellen anzulegen).
„Unter diesem Host und Port antwortet keine Datenbank.“ Host und Port prüfen – auf Webhosting oft localhost oder eine interne Adresse, Port 3306.
„Zeitüberschreitung …“ Der Datenbankserver ist vom Shop aus nicht erreichbar (Firewall oder falscher Host).
Meldung zur Zeichenkodierung Die Datenbank verwendet kein UTF-8. Legen Sie sie im Panel mit UTF-8 (MySQL/MariaDB: utf8mb4) neu an.
„Zu viele Versuche.“ Einige Minuten warten und erneut versuchen.

Datenbank im laufenden Betrieb

Anzeichen Lösung
Shop startet nicht mehr, im Protokoll ER_ACCESS_DENIED oder „password authentication failed“ Die Datenbank-Zugangsdaten haben sich geändert. Passen Sie die Zeile DATABASE_URL=… in data/database.env an (Sonderzeichen im Passwort URL-kodiert) bzw. DATABASE_URL in Ihrer .env, dann App neu starten.
ECONNREFUSED im Protokoll Die Datenbank ist unter Host/Port nicht erreichbar. Läuft der Datenbankserver? Der Shop versucht den Start alle 30 Sekunden erneut.
„DATABASE_URL must start with mysql://, mariadb:// or postgres://“ Die Verbindungsadresse in .env oder in den Umgebungsvariablen korrigieren.
SQL-Syntaxfehler bei der Einrichtung mit MariaDB DATABASE_URL mit mariadb:// statt mysql:// beginnen lassen.
Hinweis zur Anmeldemethode (caching_sha2_password) Im Panel ein neues Passwort für den MySQL-Benutzer setzen oder den Benutzer neu anlegen.
Warnung zur Zeichenkodierung unter Einstellungen → System Die Datenbank verwendet kein UTF-8, E-Mails mit Sonderzeichen können scheitern. Datenbank mit UTF-8 neu anlegen und die Daten übertragen – Ihr Hoster hilft dabei.

Updates und Konto-Verknüpfung

Anzeichen Lösung
„Update auf … fehlgeschlagen – die vorherige Version läuft weiter.“ Die neue Version ist nicht betriebsbereit geworden, der Shop läuft mit der bisherigen weiter. Den Grund nennt die Meldung, Details stehen im Protokoll. Beheben Sie die Ursache (z. B. Speicherplatz, Arbeitsspeicher) und versuchen Sie es erneut – oder aktualisieren Sie manuell.
„Update-Server nicht erreichbar“ Der Server muss ausgehende HTTPS-Verbindungen erlauben. Prüfen Sie außerdem die Angaben unter Einstellungen → System → Plazello-Verbindung – im Normalfall bleiben sie unverändert.
Automatisches Update wird nicht installiert Der Bereich Automatische Updates nennt den Grund, etwa außerhalb des Zeitfensters, manuelle Schritte, neue Hauptversion oder ein früherer Fehlschlag dieser Version.
Verknüpfungscode abgelaufen Der Code gilt 30 Minuten. Die Verknüpfung unter Einstellungen → Lizenz & Updates neu starten.
Hinweis Kulanzzeit – Plattform nicht erreichbar Die Lizenz konnte länger nicht erneuert werden. Ausgehende Verbindungen prüfen und Lizenz jetzt aktualisieren klicken.
„Nur der Inhaber kann die Lizenz verwalten.“ Lizenz, Updates und Systemeinstellungen verwaltet nur das Inhaber-Konto aus dem Web-Installer.

Weitere Informationen: Updates installieren · Konto verknüpfen und Lizenz · Backups und Umzug

War diese Seite hilfreich?Aktualisiert am 2. Oktober 2026