JTL-Shop hosten: Anforderungen, Hoster-Vergleich und die Fehler die beim Serverwechsel regelmäßig auftreten

Auf einen Blick

• ✓JTL-Shop 5 benötigt PHP 8.1 oder höher, MySQL 8.0 oder MariaDB 10.6+, Apache mit mod_rewrite und InnoDB. Shared Hosting ohne diese Voraussetzungen scheidet aus. Wir prüfen das vor jedem Hosting-Wechsel als ersten Schritt.
• ✓JTL-eigenes Hosting kostet 29 Euro pro Monat, ist sofort einsatzbereit und nimmt dir Updates und Backups ab. Externe VPS-Lösungen bieten mehr Kontrolle, erfordern aber technisches Know-how für Konfiguration und Wartung.
• ✓Die häufigsten Fehler beim Serverwechsel sind: veralteter Objekt-Cache, falsche config.JTL-Shop.ini.php nach Domainänderung, Dateirechte auf templates_c-Verzeichnissen und .htaccess-Konflikte bei www/non-www-Weiterleitungen. Vlarom E-Commerce Agentur begleitet solche Umzüge regelmäßig.

Vlarom E-Commerce Agentur aus Ahrensfelde bei Berlin begleitet als JTL Service Partner Gold Hosting-Setups und Serverwechsel für JTL-Shop-Betreiber. Ein Hosting-Wechsel ist bei JTL-Shop kein einfaches Datei-Kopieren. Wir sehen in der Praxis, dass selbst erfahrene Händler nach dem Umzug mit Cache-Problemen, falschen Datenbankverbindungen oder kaputten .htaccess-Regeln kämpfen. Die gute Nachricht: Mit einer sauberen Checkliste vor dem Umzug und gezielter Diagnose danach lassen sich diese Fehler in der Regel beheben.

JTL-Shop 5 ist technisch anspruchsvoller als viele andere PHP-Shopsysteme. Die offiziellen Serveranforderungen aus dem JTL-Guide legen fest, was mindestens vorhanden sein muss. Abweichungen davon führen entweder direkt zu Fehlern beim Betrieb oder zu Problemen beim Wawi-Abgleich, der unter Umständen 60 bis 300 Sekunden Laufzeit benötigt. Quelle: Systemvoraussetzungen aller JTL-Produkte.

Quelle JTL-Dokumentation: JTL-Shop 5.2+ benötigt mindestens PHP 8.1, ab Version 5.2.3 wird PHP 8.2 empfohlen. Die Datenbank muss MySQL 8.0+ oder MariaDB 10.6 bis 10.11 LTS sein. Als Webserver wird ein 64-Bit-Apache 2.2 oder 2.4 mit mod_rewrite und .htaccess-Unterstützung vorausgesetzt. Nginx ist technisch möglich, wird aber von JTL nicht unterstützt und erfordert manuelle Übersetzung aller .htaccess-Regeln.

Diese PHP-Module müssen auf dem Server aktiv sein damit JTL-Shop korrekt funktioniert:

• →SimpleXML, Curl, MBString, Intl: Pflichtmodule für den Grundbetrieb und die Wawi-Kommunikation. Fehlt eines dieser Module, schlägt die Installation fehl oder der Datenabgleich bricht ab.
• →Imagick: Pflicht für die Bildverarbeitung im Shop. Ohne Imagick lassen sich keine Produktbilder in den vorgesehenen Formaten erzeugen.
• →PDO mit MySQL-Treiber: Einzige unterstützte Datenbankschnittstelle. Der Datenbankbenutzer braucht SELECT, CREATE, ALTER, INSERT, UPDATE, DELETE, INDEX und DROP.
• →PHP-Konfiguration: memory_limit 128 MB, max_execution_time 120 Sekunden: Unterschreitet der Server diese Werte, brechen Importe und Wawi-Abgleiche vorzeitig ab. Bei größeren Shops mit vielen Varianten sind 256 MB die sicherere Grundlage.

Wer auf Shared Hosting ohne SSH-Zugriff, ohne Redis und mit 30-Sekunden-PHP-Timeout startet, wird beim ersten Wawi-Abgleich eben Probleme sehen. Ein VPS mit dedizierten Ressourcen ist für JTL-Shop-Setups ab etwa 500 Artikeln die stabilere Wahl.

Fast jeder Serverwechsel bringt mindestens einen dieser Fehler mit sich. Diese Probleme entstehen nicht durch Nachlässigkeit, sondern weil JTL-Shop halt mehr Konfigurationsdateien und Abhängigkeiten hat als ein einfaches CMS. Die folgende Übersicht zeigt die fünf häufigsten Probleme und wie du sie erkennst.

warning

Objekt-Cache aus dem alten Server mitgekopiert

Symptom: Der Shop lädt, aber Artikeldetail-Seiten zeigen HTTP 500. Navigation und Kategorien funktionieren normal.

Ursache: Der Cache enthält Pfade und Verbindungsdaten vom alten Server. Lösung: Im JTL-Shop-Backend den Objekt-Cache deaktivieren, löschen und neu aufbauen. Ein Händler im JTL-Forum: ‚Ich habe einfach mal den Objekt-Cache ausgeschaltet, gelöscht, wieder eingeschaltet — und es lief.‘ Die /templates_c und /admin/templates_c Verzeichnisse nie mit umziehen.

warning

config.JTL-Shop.ini.php enthält noch die alte Domain

Symptom: Der Shop ist gar nicht erreichbar oder zeigt SQLSTATE-Fehler wie ‚Access denied for user‘.

Ursache: PFAD_ROOT und URL_SHOP in der Konfigurationsdatei zeigen noch auf den alten Server oder die alte Domain. Nach jedem Hosting-Wechsel müssen beide Werte in /includes/config.JTL-Shop.ini.php angepasst werden. Zusätzlich muss der Verkaufskanal in JTL-Wawi unter Plattformen aktualisiert werden und die Lizenz im JTL-Kundencenter auf die neue Domain gebunden werden.

muted

.htaccess-Konflikte bei www/non-www-Umleitung

Symptom: Endlosweiterleitung oder gemischte HTTP/HTTPS-Inhalte nach dem Umzug.

Ursache: Der neue Server hat andere RewriteBase- oder RewriteCond-Einstellungen als der alte. Bei JTL-Shop 5 erzeugt die Aktivierung von SSL unter Darstellung -> Einstellungen -> Global eine .htaccess-Zeile mit RewriteCond % off. Stimmt die www/non-www-Regel danach nicht mehr, entsteht eine Redirect-Schleife. Alle Umleitungsregeln nach dem Umzug sequenziell durchgehen und testen.

muted

Dateirechte auf Schreibverzeichnissen fehlen

Symptom: Kein Bild-Upload möglich, Template-Änderungen greifen nicht, Fehler beim Shopsetup.

Ursache: JTL-Shop benötigt Schreibzugriff auf mehrere Verzeichnisse: bilder und alle Unterverzeichnisse, dbeS/tmp, dbeS/logs, export, mediafiles, uploads. Standardwerte sind 755 für Verzeichnisse und 644 für Dateien. Bei manchen Hostern sind 777 erforderlich. Wer die templates_c-Verzeichnisse komplett neu anlegt statt umzukopieren, vermeidet Rechte-Probleme von Beginn an.

primary

Datenbankgröße unterschätzt — phpMyAdmin reicht nicht

Symptom: Datenbankimport bricht beim Restore ab, phpMyAdmin meldet Timeout.

Ursache: JTL-Shop-Datenbanken mit einigen zehntausend Artikeln und Bestellhistorie sind schnell mehrere Gigabyte groß. phpMyAdmin hat Upload-Limits und HTTP-Timeouts. Der Import muss über SSH via mysql-Kommandozeile laufen. Wer keinen SSH-Zugriff hat, muss den Hoster einbeziehen oder einen Managed-Transfer beauftragen.

muted

SSL nicht korrekt in allen Konfigurationsdateien aktiviert

Symptom: Browser meldet ‚Nicht sicher‘, gemischte Inhalte trotz aktiviertem Zertifikat, Stripe oder PayPal-Zahlungen schlagen fehl.

Ursache: SSL muss an drei Stellen konsistent aktiviert sein: in der .htaccess über RewriteRule, im JTL-Shop-Backend unter SSL-Einstellungen und in der Wawi-Anbindung. Ressourcen die noch mit http:// statisch eingebunden sind erzeugen mixed-content-Warnungen selbst wenn HTTPS aktiv ist. Protokoll-relative URLs (//beispiel.de/bild.jpg) vermeiden das Problem.

JTL-eigenes Hosting — für unkomplizierte Starts

Das JTL-Shop Hosting kostet 29 Euro pro Monat und umfasst die aktuelle Shop-Version, SSL, tägliche Backups, Redis-Caching und technischen Support direkt von JTL. Updates werden automatisch eingespielt. Der Artikel-Limit liegt bei Community Free auf 500 Artikel. Wer schnell starten will und keinen eigenen Admin für Serverkonfiguration hat, ist hier gut aufgehoben. Die Einschränkung: vollständige SSH-Kontrolle und individuelle Server-Konfiguration bleiben eingeschränkt.

Externer VPS oder dedizierter Server — für wachsende Shops

Ab etwa 500 Artikeln, hohem Bestellvolumen oder intensivem Wawi-Abgleich zahlt sich ein VPS aus. PHP 8.2 mit OPcache und JIT, MariaDB 10.11 LTS und Redis als Objekt-Cache reduzieren Datenbankabfragen um 60 bis 80 Prozent. Voller SSH-Zugriff heißt: individuelle Konfiguration, eigene Cron-Jobs, schnelle Fehlerdiagnose. Der Preis für einen JTL-optimierten VPS beginnt bei etwa 15 bis 30 Euro pro Monat bei spezialisierten Hostern.

Dieser Ablauf basiert auf unseren Erfahrungen bei Hosting-Setups und Serverwechseln für JTL-Shop-Betreiber. Er gilt sowohl für den Erstzugang auf einem neuen Server als auch für den Umzug von einem alten Hosting. Wer Schritt 2 überspringt, schafft sich Probleme in Schritt 4. Vor jedem Schritt gilt: vollständige Datensicherung von Datenbank und Shopdateien. Bei Fragen oder Unsicherheiten lohnt sich die Begleitung durch einen JTL Service Partner. Bei Fragen zur Einrichtung danach: JTL-Shop Einrichtung durch Vlarom.

Bevor du irgendetwas umzieht: PHP-Version, MySQL-Version, verfügbare Module und PHP-Limits beim Zielhoster prüfen. Ein phpinfo()-Output reicht als Prüfgrundlage. Pflicht: PHP 8.1+, MySQL 8.0+ oder MariaDB 10.6+, mod_rewrite aktiv, memory_limit mindestens 128 MB, max_execution_time mindestens 120 Sekunden. Die vollständige Anforderungsliste findest du in der JTL-Dokumentation zur Neuinstallation.

Vollständigen MySQL-Dump vor dem Wartungsmodus erstellen. Der Shop geht danach in den Wartungsmodus. Ab diesem Punkt keine Wawi-Abgleiche mehr starten. Für Datenbanken über 500 MB: Transfer ausschließlich via SSH mit mysql-Kommandozeile planen, nicht phpMyAdmin. Die Konfigurationsdatei /includes/config.JTL-Shop.ini.php separat sichern. Ohne sie ist der Shop nach dem Umzug nicht ansprechbar.

Alle Dateien binär via FTP oder SSH übertragen. Die Verzeichnisse /templates_c und /admin/templates_c auslassen: sie enthalten gecachte Daten die auf dem neuen Server ungültig sind und zu HTTP-500-Fehlern führen. Die Zielverzeichnisse auf dem neuen Server leer anlegen mit korrekten Schreibrechten (755). Gleiches gilt für /dbeS/tmp und /dbeS/logs.

In /includes/config.JTL-Shop.ini.php die Felder PFAD_ROOT, URL_SHOP und Datenbankverbindung (DB_HOST, DB_USER, DB_PASS, DB_NAME) auf die neuen Werte setzen. SSL-Einstellung im Shop-Backend aktivieren und .htaccess auf korrekte www/non-www-Weiterleitung prüfen. Im JTL-Kundencenter die Lizenz auf die neue Domain binden: das geht nur einmal pro 24 Stunden. In JTL-Wawi unter Plattformen die URL im Verkaufskanal aktualisieren.

Startseite, Kategorieseite und Artikeldetail im Browser aufrufen und auf HTTP-Statuscode 200 prüfen. Danach den Objekt-Cache im Shop-Backend einmal löschen und neu aufbauen. Einen Test-Wawi-Abgleich starten und auf Fehler im Abgleich-Log prüfen. SSL-Zertifikat auf mixed-content-Warnungen testen. Erst wenn alle vier Checks grün sind, geht der Wartungsmodus weg.

Autor

Alexander Luft

JTL Service Partner Gold · Vlarom E-Commerce Agentur · Ahrensfelde bei Berlin