Hetzner-Webhosting Shopware 6.7 installieren

Shopware 6.7 – Installationsdokumentation

k&k consulting gmbh – Stand: 09.10.2026

1. Ziel der Installation

Neuinstallation von Shopware 6.7 auf einem bestehenden Hetzner-Webhosting-Paket.

Die Installation erfolgt parallel zu vorhandenen Anwendungen, insbesondere TYPO3 und älteren Shopware-Versionen.

Wichtig: Die bestehende PHP-Konfiguration des Webhostings darf nicht global verändert werden.

2. Systemumgebung

Verzeichnisstruktur

/usr/www/users/kkacon/
└── shopware67/
    ├── bin/
    ├── config/
    ├── custom/
    ├── public/
    │   └── .htaccess
    ├── var/
    │   └── composer/
    ├── vendor/
    ├── .env
    ├── .env.local
    ├── composer.json
    ├── composer.lock
    └── composer.phar

Der öffentliche DocumentRoot zeigt ausschließlich auf:

/usr/www/users/kkacon/shopware67/public

Dadurch bleiben Konfigurationsdateien und andere interne Shopware-Verzeichnisse außerhalb des Webzugriffs.

3. PHP 8.4 verwenden

Hetzner verwendet auf diesem Hosting standardmäßig PHP 5.6.

Für Shopware muss PHP 8.4 ausdrücklich aufgerufen werden.

Version prüfen:

php84 -v

Wichtig: Für sämtliche Shopware-Konsolenbefehle verwenden wir php84 statt php.

PHP 8.4 für Apache aktivieren

Datei:

shopware67/public/.htaccess

Am Anfang der Datei eintragen:

FcgidWrapper "/home/httpd/cgi-bin/php84-fcgi-starter.fcgi" .php

Die Anweisung steht außerhalb des automatisch verwalteten Shopware-Bereichs.

4. Composer installieren

Composer wird ausschließlich für diese Shopware-Installation bereitgestellt.

Die Datei liegt unter:

shopware67/composer.phar

Der Composer-Installer wird von der offiziellen Composer-Seite heruntergeladen und seine SHA-384-Signatur geprüft.

Nach erfolgreicher Installation:

php84 ~/public_html/shopware67/composer.phar --version

Ergebnis unserer Installation:

Composer version 2.10.3
PHP version 8.4.26

Achtung: Ein direkter Aufruf von composer.phar ohne php84 verwendet auf diesem Server PHP 5.6 und schlägt fehl.

5. Shopware installieren

In das übergeordnete Installationsverzeichnis wechseln:

cd ~/public_html/shopware67

Shopware-Projekt erstellen:

php84 composer.phar create-project shopware/production shopware-install "^6.7" --no-interaction

Anschließend wurde der Inhalt von shopware-install einschließlich der versteckten Dateien in das Verzeichnis shopware67 verschoben.

Für zukünftige Installationen empfiehlt es sich, Shopware direkt in einem zunächst leeren Zielverzeichnis zu installieren.

6. Datenbank einrichten

Im Hetzner-KonsoleH die Datenbank erstellen.

Unsere Einstellungen:

Server:    mi8t.your-database.de
Datenbank: kkacon_~~~~~~~~~~
Benutzer:  ~~~~~~~~

Das Passwort wird ausschließlich in der lokalen Konfiguration gespeichert.

Shopware-Konfiguration

Datei:

shopware67/.env.local

Inhalt:

APP_ENV=prod
APP_URL=https://swdemo67.kk-consulting.com

DATABASE_URL="mysql://~~~~~~~:PASSWORD@mi8t.your-database.de:3306/~~~~~~~~"

PASSWORD ist durch das tatsächliche, URL-kodierte Datenbankpasswort zu ersetzen. Insbesondere Sonderzeichen müssen korrekt kodiert werden.

Dateiberechtigung:

chmod 600 .env.local

7. Domain und SSL

Im Hetzner-KonsoleH eine Subdomain erstellen:

swdemo67.kk-consulting.com

Als DocumentRoot wird festgelegt:

shopware67/public

Anschließend ein Let's-Encrypt-Zertifikat aktivieren.

Wichtig: Die Domain muss korrekt auf den Hetzner-Webserver aufgelöst werden. Bei unserer Installation war zusätzlich eine Anpassung am lokalen DNS erforderlich.

8. Shopware-Datenbank initialisieren

Im Shopware-Verzeichnis:

cd ~/public_html/shopware67

Installation starten:

php84 bin/console system:install --basic-setup

Bei unserer Installation wurden 885 Datenbankmigrationen erfolgreich ausgeführt.

Anschließend waren Administration und Storefront grundsätzlich verfügbar.

Administration

https://swdemo67.kk-consulting.com/admin

Das bei der Basisinstallation angelegte Standard-Administratorkonto muss unmittelbar mit einem individuellen, sicheren Passwort versehen werden.

9. Composer-Fehler im Einrichtungsassistenten

Bei der Installation der Demodaten erschien folgende Fehlermeldung:

Internal Server Error

The HOME or COMPOSER_HOME environment variable
must be set for composer to run correctly

Ursache

Der PHP-FastCGI-Prozess erhielt von Hetzner weder HOME noch COMPOSER_HOME.

Lösung

Ein eigenes Composer-Verzeichnis erstellen:

mkdir -p ~/public_html/shopware67/var/composer
chmod 700 ~/public_html/shopware67/var/composer

In der Datei:

shopware67/public/.htaccess

folgende Anweisungen ergänzen:

SetEnv HOME /usr/www/users/kkacon/shopware67
SetEnv COMPOSER_HOME /usr/www/users/kkacon/shopware67/var/composer

Der Anfang der .htaccess sieht damit folgendermaßen aus:

FcgidWrapper "/home/httpd/cgi-bin/php84-fcgi-starter.fcgi" .php

SetEnv HOME /usr/www/users/kkacon/shopware67
SetEnv COMPOSER_HOME /usr/www/users/kkacon/shopware67/var/composer

# BEGIN Shopware

Ergebnis: Beide Umgebungsvariablen wurden erfolgreich an PHP 8.4 übergeben. Anschließend konnten die Demodaten installiert werden.

10. Einrichtungsassistent

Folgende Einstellungen wurden verwendet:

Nach Abschluss waren sechs Demoartikel vorhanden.

11. Sprache auf Deutsch umstellen

Die Administration und die Storefront besitzen getrennte Spracheinstellungen.

Administration

Im Benutzerprofil die Sprache Deutsch auswählen.

Storefront

Unter:

Verkaufskanäle → Storefront → Allgemein

Deutsch als Standardsprache auswählen.

Anschließend zum Abschnitt Domains wechseln.

Den vorhandenen Domaineintrag bearbeiten:

Wichtig: Die vorhandene Domain bearbeiten, nicht ein zweites Mal anlegen.

Cache leeren

Nach der Sprachumstellung:

cd ~/public_html/shopware67
php84 bin/console cache:clear

Anschließend die Storefront im Browser mit Strg + F5 neu laden.

Danach wurden die deutschen Shopware-Oberflächentexte angezeigt.

Die englischen Produkt- und Kategorienamen der Demodaten werden dadurch nicht automatisch übersetzt.

12. Installation prüfen

Folgende Funktionen wurden erfolgreich getestet:

Testdateien entfernen

Temporäre Diagnose-Dateien dürfen nicht öffentlich erreichbar bleiben.

rm -f ~/public_html/shopware67/public/env-test.php
rm -f ~/public_html/shopware67/public/php-test.php

13. Weitere Arbeiten

Für den dauerhaften Einsatz als Entwicklungs- und Testumgebung sollten wir noch das Administratorkonto absichern, die Shopware-Systemkonfiguration kontrollieren und einen API-Integrationsbenutzer für die myfactory-Anbindung einrichten.

Anschließend können wir unsere vorhandenen API-Funktionen gegen Shopware 6.7 testen, insbesondere Artikelübertragung, Medienzuordnung und Coverbilder.