# Der Web-Installer

Nach dem ersten Start richten Sie Plazello vollständig im Browser ein. Der Web-Installer führt in drei Schritten durch die Einrichtung: **Datenbank**, **Shop & Konto** und **Fertig**. Sie erreichen ihn, indem Sie die Adresse Ihres Shops öffnen; solange die Einrichtung nicht abgeschlossen ist, leitet der Shop automatisch dorthin weiter.

## Der Installations-Code

Damit niemand anderes eine frisch hochgeladene Installation übernehmen kann, fragt der Installer nach einem **Installations-Code**. Der Shop erzeugt ihn beim ersten Start und legt ihn an zwei Stellen ab:

- in der Datei `data/setup-token.txt` im Anwendungsordner (bei Docker im Datenvolume),
- im Protokoll der Anwendung (Hosting-Panel bzw. `docker compose logs app`).

Groß- und Kleinschreibung spielen keine Rolle. Nach Abschluss der Einrichtung wird die Datei gelöscht; der Code wird dann nicht mehr gebraucht.

## Schritt 1: Datenbank verbinden

Diesen Schritt sehen Sie nur, wenn die Datenbank nicht schon über `DATABASE_URL` vorgegeben ist (etwa bei der Installation mit Docker).

| Feld | Inhalt |
|---|---|
| Datenbank-Typ | **MariaDB**, **MySQL** oder **PostgreSQL** |
| Host | meist `localhost` oder die im Hosting-Panel angezeigte Adresse |
| Port | leer lassen für den Standard (3306 bzw. 5432) |
| Name der Datenbank | der Name der leeren Datenbank |
| Benutzer / Passwort | die Zugangsdaten des Datenbank-Benutzers |
| Installations-Code | siehe oben |

Mit **Verbindung testen und speichern** prüft der Installer sofort:

- ob die Anmeldung mit Benutzer und Passwort klappt,
- ob die Datenbank existiert und der Benutzer darin Tabellen anlegen darf,
- ob die Datenbank UTF-8 verwendet – bei MariaDB und MySQL stellt er die Kodierung nach Möglichkeit selbst auf `utf8mb4` um.

Schlägt etwas fehl, erklärt der Installer die Ursache in einfachen Worten, zum Beispiel „Benutzername oder Passwort ist falsch.“ oder „Unter diesem Host und Port antwortet keine Datenbank.“ Ob es sich um MariaDB oder MySQL handelt, erkennt er selbst.

Die Verbindung wird in der Datei `data/database.env` gespeichert. Anschließend legt der Shop die Tabellen an und startet – beim ersten Mal dauert das etwa eine halbe Minute. Die Seite wechselt danach von selbst zum nächsten Schritt.

## Schritt 2: Shop und Inhaber-Konto

Oben sehen Sie den Status der Einrichtung: welche Datenbank verbunden ist und ob der E-Mail-Versand schon eingerichtet ist (in der Regel richten Sie ihn später im Admin ein).

**Shop**

- **Name des Shops** – lässt sich später im Admin jederzeit ändern.
- **Adresse des Shops** – die öffentliche Adresse, z. B. `https://www.mein-shop.de`. Sie wird für Links in E-Mails, Rechnungen und die Sitemap verwendet und ist mit der aktuell aufgerufenen Adresse vorbelegt. Das Feld entfällt, wenn die Adresse bereits über `PUBLIC_URL` vorgegeben ist.
- **Sitzland** – das Land, in dem Ihr Unternehmen sitzt.
- **Sprache** – Sprache Ihres Admins; sofern der Onlineshop sie anbietet, auch seine Standardsprache.

**Ihr Konto**

- **Name**, **E-Mail** und **Passwort** (mindestens 10 Zeichen) für das Inhaber-Konto.
- **Installations-Code** – nur, falls er aus Schritt 1 nicht schon bekannt ist.

Mit **Installation abschließen** wird der Shop angelegt, Sie sind direkt im Admin angemeldet und der Installations-Code verfällt.

## Das Inhaber-Konto

Das Konto aus dem Installer ist der **Inhaber** der Installation. Nur der Inhaber verwaltet die Systemeinstellungen (**Einstellungen → System**), die Lizenz und die Updates (**Einstellungen → Lizenz & Updates**). Weitere Personen laden Sie später als Mitarbeiter mit passenden Rechten ein.

Richten Sie für das Inhaber-Konto am besten gleich die Zwei-Faktor-Anmeldung ein, siehe [Mein Konto und Zwei-Faktor-Anmeldung](doc:mein-konto).

## Nach der Installation

Der Admin ist ab jetzt unter `https://<Ihre Adresse>/admin` erreichbar. Als Nächstes richten Sie ein:

- **Einstellungen → System:** E-Mail-Versand (SMTP), Standard-Absender, öffentliche Adresse und Dateispeicher – jeweils mit Verbindungstest. Siehe [Absender und Mailserver](doc:absender-und-mailserver).
- **Einstellungen → Zahlungen:** Ihre eigenen Zugangsdaten für PayPal und Stripe. Siehe [Zahlungsarten](doc:zahlungsarten).
- Alles Weitere – Versand, Steuern, Rechtstexte, Theme – nach der Checkliste unter [Shop einrichten: die Checkliste](doc:shop-einrichten).

Optional verknüpfen Sie die Installation mit Ihrem Plazello-Konto, um einen Tarif zu buchen: [Konto verknüpfen und Lizenz](doc:konto-verknuepfen).