JTL-Wawi Hosting richtig einrichten: SQL-Server, Anforderungen und die häufigsten Verbindungsfehler

Auf einen Blick

• ✓JTL-Wawi benötigt einen Microsoft SQL Server. Azure SQL und Shared-SQL-Instanzen werden laut JTL-Dokumentation nicht unterstützt. Wir richten den SQL-Server als Teil jedes Wawi-Setups mit ein.
• ✓Die drei Hosting-Modelle unterscheiden sich vor allem im Verwaltungsaufwand: lokale Installation, dedizierter Windows-Server beim Hoster und JTL-Wawi Cloud (via ecomDATA). Welches passt, hängt von Teamgröße, Budget und technischer Infrastruktur ab.
• ✓Die häufigsten Verbindungsfehler entstehen durch gesperrten Port 1433, fehlenden SQL-Server-Browser-Dienst oder falsch gesetzten Authentifizierungsmodus. Alle drei lassen sich beheben, wenn man weiß, wo man schauen muss.

Vlarom E-Commerce Agentur richtet JTL-Wawi seit über zehn Jahren ein. Von Ahrensfelde bei Berlin aus betreuen wir Händler deutschlandweit, von der ersten lokalen Installation bis zum Mehrmandanten-Setup auf dedizierten Servern. Als JTL Service Partner Gold kennen wir die Fehlerbilder, die entstehen, wenn der SQL-Server falsch konfiguriert ist. Die meisten Verbindungsprobleme die wir sehen, sind keine Bugs. Sie entstehen durch einen einzigen fehlenden Konfigurationsschritt.

JTL empfiehlt den Microsoft SQL Server 2022 als Datenbankserver für JTL-Wawi. Die offizielle Dokumentation nennt als Mindestvoraussetzung Windows Server 2016 oder höher für den Datenbankserver. Windows Server 2025 wird aktuell noch nicht unterstützt. Für die Client-Arbeitsplätze ist seit dem Ende des Windows-10-Supports im Oktober 2025 Windows 11 Pflicht.

Quelle JTL-Dokumentation (guide.jtl-software.com): Für einen produktiven SQL-Server-Betrieb (Standard- oder Enterprise-Edition) sind mindestens 8 GB RAM nötig, wobei der SQL-Server ca. 80 % des verfügbaren RAM belegen darf. Die Express-Edition ist auf 1 GB RAM, einen physischen Prozessor und 10 GB Datenbankgröße begrenzt.

Diese Eckwerte bestimmen, welche SQL-Server-Edition sinnvoll ist:

• →Express: für Einzel-Arbeitsplätze: Kostenlos, reicht für Einsteiger und Betriebe mit wenigen hundert Artikeln und einem Arbeitsplatz. Sobald die Datenbank wächst oder mehrere Clients gleichzeitig zugreifen, werden die Grenzen spürbar.
• →Standard: die typische Wahl ab 3+ Arbeitsplätzen: Keine Beschränkung bei Datenbankgröße oder RAM-Nutzung. JTL empfiehlt für Standard- und Enterprise-Editionen mindestens 8 GB RAM am Server und vier separate Festplatten für maximalen Datendurchsatz.
• →Datenbankgröße und Dateikonfiguration: Laut JTL-Dokumentation sollte die MDF-Datei mit 10.000 MB Anfangsgröße und 500 MB automatischer Vergrößerung konfiguriert werden. Die LOG-Datei startet bei 3.000 MB mit 100 MB Vergrößerungsschritten.
• →Sortierung: ein häufig vergessenes Detail: Bei der SQL-Server-Installation muss zwingend die Sortierung Latin1_General_CI_AS gesetzt werden. Wer das vergisst, bekommt später Probleme mit Sonderzeichen in Artikel- und Kundendaten.

Die Express-Edition ist ein guter Einstieg. Für einen produktiven Mehrbenutzerbetrieb führt kein Weg an Standard oder Enterprise vorbei. Die Datenbankgröße wächst mit jedem Bestelljahr, und die RAM-Grenze von 1 GB sorgt bei parallel arbeitenden Teams für Warteschlangen bei Datenbankabfragen. Wer unsicher ist, welche Edition sein Setup braucht: Vlarom E-Commerce Agentur klärt das im Erstgespräch.

In der Praxis entstehen fast alle Verbindungsfehler durch dieselben sechs Ursachen. Bevor du stundenlang in Log-Dateien suchst, lohnt es sich diese der Reihe nach durchzugehen.

primary

Port 1433 ist nicht freigegeben

JTL-Wawi kommuniziert mit dem SQL-Server über TCP-Port 1433. Wenn dieser Port in der Windows Defender Firewall oder einer externen Firewall gesperrt ist, scheitert die Verbindung sofort.

Lösung: In der Windows Defender Firewall eine eingehende Regel für sqlservr.exe anlegen (unter C:\\Programme\\Microsoft SQL Server\\MSSQLXX.MSSQLSERVER\\MSSQL\\Binn\\). Zusätzlich Port 1434 UDP für den SQL-Server-Browser-Dienst freigeben.

warning

SQL Server Browser ist deaktiviert

Bei Named Instances (der Standard-Installationsweg für JTL-Wawi) muss der SQL Server Browser-Dienst laufen. Ohne ihn kann der Client die Named Instance nicht auflösen, selbst wenn die Netzwerkverbindung technisch funktioniert.

Lösung: Im SQL Server Configuration Manager unter SQL Server Services den SQL Server Browser-Dienst auf Automatisch stellen und starten. Anschließend den Port 1434 UDP in der Firewall freigeben.

warning

TCP/IP ist im Configuration Manager deaktiviert

Bei einer Neuinstallation von SQL Server Express ist das TCP/IP-Protokoll standardmäßig deaktiviert. Ohne aktives TCP/IP funktioniert der Netzwerkzugriff auf den SQL-Server nicht.

Lösung: Im SQL Server Configuration Manager unter SQL Server Network Configuration das Protokoll TCP/IP aktivieren. Danach den SQL-Server-Dienst neu starten. Ohne Neustart bleibt die Änderung wirkungslos.

muted

Falscher Authentifizierungsmodus (Windows statt Gemischt)

JTL-Wawi arbeitet mit SQL-Authentifizierung. Wenn der SQL-Server nur auf Windows-Authentifizierung eingestellt ist, schlägt der Login mit dem sa-Benutzer fehl. Fehlermeldung: Login failed for user ’sa‘, Error 18456.

Lösung: In den SQL-Server-Eigenschaften (über SSMS oder SQL Server Management Studio) auf Gemischter Modus umstellen. Danach den sa-Benutzer aktivieren und ein sicheres Passwort setzen. Dieses Passwort sofort an einem sicheren Ort speichern, es gibt keinen Wiederherstellungsweg.

muted

Azure SQL oder Shared SQL Server

Azure SQL Datenbanken und Shared-SQL-Instanzen bei Webhostern werden von JTL explizit nicht unterstützt. JTL-Wawi braucht eine eigene dedizierte SQL-Server-Instanz.

Wer JTL-Wawi an einen Shared-Datenbankserver eines günstigen Webhosters anbindet, wird scheitern. Das gilt unabhängig davon, ob die Verbindung technisch hergestellt werden kann.

muted

Timeout bei großen Datenbanken

Bei wachsenden Datenbanken (ab etwa 5 GB) entstehen Timeouts wenn Autoshrink oder Autoclose aktiviert sind. JTL empfiehlt beide Optionen explizit zu deaktivieren.

Lösung: In den Datenbankeigenschaften Autoshrink und Autoclose auf false setzen. Für den SQL Server die Memory-Begrenzung auf 80 % des verfügbaren RAM setzen, sonst konkurriert SQL-Server mit dem Betriebssystem um Arbeitsspeicher.

Lokale Installation — für Einzel-Arbeitsplätze

Die lokale Installation auf einem leistungsstarken PC eignet sich für Einzelhändler und kleine Teams mit einem bis zwei Arbeitsplätzen. SQL-Server Express läuft auf demselben Rechner wie JTL-Wawi, keine Netzwerkkonfiguration nötig. Der Nachteil: kein Remote-Zugriff, kein gemeinsames Backup, der PC muss immer laufen wenn andere zugreifen sollen.

Dedizierter Windows-Server beim Hoster — ab 3+ Arbeitsplätzen

Ein Windows Server beim Hoster (root-Zugang via RDP) ist die typische Lösung für wachsende Teams. SQL-Server Standard läuft auf dem Server, alle Arbeitsplätze verbinden sich über das Netzwerk. Vorteile: stabiler Betrieb, gemeinsame Datensicherung, Remote-Zugriff möglich. Erfordert initiale Konfiguration von TCP/IP, Firewall und SQL-Server-Browser.

Diese Schritte gelten für ein serverbasiertes Setup mit dedizierten Arbeitsplätzen. Wer nur einen Einzelarbeitsplatz einrichtet, kann die Netzwerkkonfiguration in Schritt 3 und 4 überspringen. Die offizielle Installationsanleitung findest du auf guide.jtl-software.com.

Entscheide dich zwischen lokaler Installation, dediziertem Windows-Server und JTL-Wawi Cloud, bevor du mit dem Setup anfängst. Die häufigste Fehlentscheidung ist mit SQL-Server Express zu starten, obwohl von Anfang an mehrere Arbeitsplätze geplant sind. Kläre vorher: Wie viele Arbeitsplätze jetzt und perspektivisch? Brauche ich Remote-Zugriff? Wer macht Backups?

Installiere Microsoft SQL Server 2022 (laut JTL-Dokumentation empfohlen) im gemischten Authentifizierungsmodus. Wähle bei der Installation eine Named Instance und setze die Sortierung auf Latin1_General_CI_AS. Das ist keine optionale Einstellung. Vergib dem sa-Benutzer ein sicheres Passwort und schreibe es sofort an einem sicheren Ort auf. Aktiviere nach der Installation TCP/IP im SQL Server Configuration Manager und starte den SQL-Server-Dienst neu.

Für den Mehrbenutzerbetrieb müssen Port 1433 TCP und Port 1434 UDP in der Windows Defender Firewall freigegeben werden. Am zuverlässigsten ist eine Regel für die Datei sqlservr.exe direkt. Starte außerdem den SQL Server Browser-Dienst und stelle ihn auf Automatisch. Teste die Verbindung von einem zweiten Rechner aus, bevor du JTL-Wawi installierst. So erkennst du Firewall-Probleme bevor die eigentliche Installation beginnt.

Installiere JTL-Wawi auf dem Server mit der Rolle Server und auf den Arbeitsplätzen mit der Rolle Client. Beim ersten Start verbindet sich JTL-Wawi mit dem SQL-Server und legt die Datenbank automatisch an. Der Servername im Verbindungsdialog folgt dem Format COMPUTERNAME\\INSTANZNAME oder bei festem Port COMPUTERNAME,1433. Läuft der SQL-Server-Browser, reicht meist der Name ohne Port.

Deaktiviere nach der ersten erfolgreichen Verbindung in den Datenbankeigenschaften die Optionen Autoshrink und Autoclose. Setze die maximale Arbeitsspeicherbegrenzung des SQL-Servers auf 80 % des verfügbaren RAM, bei 16 GB RAM also auf 12 bis 13 GB. Richte regelmäßige Datenbankbackups ein. Detaillierte Optimierungshinweise liefert die JTL-Dokumentation unter guide.jtl-software.com/jtl-wawi/datenbank/.

Autor

Alexander Luft

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