Installationsanleitung (einfach erklärt)

Ziel: Du lädst alle Dateien auf den Webserver. Beim ersten Aufruf startet ein Setup. Das Setup legt die Datenbanktabellen an und erstellt Nutzer.

1. Was du vorher brauchst

1. Webhosting mit PHP
   PHP 8.x ist sinnvoll. Wichtig: PDO MySQL muss aktiv sein.
2. MySQL oder MariaDB Datenbank
   Du brauchst:
   • DB Host (z.B. localhost oder ein Hostname vom Hoster)
   • DB Name
   • DB Benutzer
   • DB Passwort
   • Optional: DB Port (Standard: 3306)
3. Empfohlen: SSL
   Nutze nach Möglichkeit https://.

2. Dateien hochladen

1. ZIP auf deinem PC entpacken.
2. Alles auf den Webserver hochladen, in den Webroot (je nach Hoster z.B. htdocs, public_html, www).
3. Wichtig: Häufig vergessene Ordner:
   • css/
   • img/ oder images/
   • install/

3. Rechte prüfen (wenn das Setup meckert)

Das Setup muss Dateien schreiben können:

• .env (Konfiguration)
• install/install.lock (Installations-Sperre)

Wenn dein Hoster streng ist: gib dem Projektordner kurz Schreibrechte, oder erstelle eine leere .env und mache sie schreibbar.

4. Setup starten

Öffne im Browser:

https://deine-domain.tld/install/

Du siehst ein Setup-Formular und eine Statusliste mit Erfolgen und Fehlern.

5. Setup ausfüllen

A) Datenbank

• DB Host (steht im Hosting-Panel, oft localhost)
• DB Name
• DB User
• DB Passwort
• DB Port: leer lassen, wenn du unsicher bist

Wenn es eine Option „DB automatisch anlegen“ gibt: Nur aktivieren, wenn dein DB-User das darf. Bei vielen Hostern ist das nicht erlaubt.

B) Domain / Base URL

Trage die URL ein, unter der das Projekt läuft, z.B.:

• https://deine-domain.tld

Nicht so:

• nicht mit /install
• nicht mit /index.php

C) Nutzer anlegen

Du kannst bis zu 5 Nutzer anlegen (je nach Setup-Version).

• Benutzername
• E-Mail
• Name
• Optional: Farbe

Passwörter werden automatisch erzeugt, als Argon2id in der DB gespeichert, und wenn möglich per E-Mail verschickt.

6. Installation starten

Klicke auf „Installieren“.

• Grüner Haken: Schritt erfolgreich
• Rot: Fehler mit Grund

7. Nach erfolgreicher Installation

1. Du wirst weitergeleitet oder bekommst einen Link zur Login-Seite.
2. Prüfe die E-Mails für die angelegten Nutzer (auch Spam).
3. Installer absichern (wichtig):
   Best Practice: Ordner install/ löschen oder serverseitig sperren.
   Mindestens muss install/install.lock liegen bleiben.

8. Häufige Probleme und schnelle Fixes

Seite ohne Design (kein CSS)

Meist ist der Ordner css/ nicht mit hochgeladen.
Fix: css/ nachladen, dann Seite neu laden (F5).

„Datenbankverbindung fehlgeschlagen“

• Host stimmt nicht (oft localhost)
• Passwort falsch
• Datenbankname falsch
• Port falsch

„CREATE TABLE nicht erlaubt“

Dein DB-User hat zu wenig Rechte.
Fix: im Hosting-Panel einen DB-User mit passenden Rechten wählen oder Rechte vergeben.

Keine E-Mails kommen an

Viele Hostings blocken mail() oder verlangen eine gültige From-Adresse.
Fix: From-Adresse korrekt setzen, Spam prüfen. Für zuverlässig: SMTP nutzen.

9. 30-Sekunden Checkliste

• Alle Dateien hochgeladen
• Setup geöffnet: /install/
• DB Daten korrekt
• Base URL korrekt
• Installation grün durch
• Nutzer-Mails geprüft
• install/ gelöscht oder gesperrt