18 KiB
Betrieb: Umgebungen, Zugänge, Einrichtung
Stand: 22.10.2026. Dieses Dokument beschreibt den tatsächlichen Stand der Installationen, damit jede neue Arbeitssitzung (Mensch oder KI) ohne Vorwissen weitermachen kann. Allgemeine Abläufe des Deployments stehen in DEPLOYMENT.md, das fachliche Konzept in KONZEPT.md.
Geheimnisse stehen nie im Repository und nie im Chat. Passwörter (Datenbank, E-Mail),
APP_KEY, Tokens und private SSH-Schlüssel liegen nur inshared/.envauf dem Server bzw. im Vaultwarden von Lars. Hier ist nur dokumentiert, wo sie liegen.
1. Überblick
| Testbetrieb (staging) | Produktion | |
|---|---|---|
| Adresse | https://stommer.info | später https://www.fewo-stommer.de (heute noch WordPress) |
| Ordner auf dem Webspace | test.fewo-stommer.de/ |
noch nicht angelegt (Vorschlag: fewo-production/) |
| Deploy-Konfiguration (lokal, nicht committet) | scripts/deploy.staging.env |
scripts/deploy.production.env (anlegen aus deploy.example.env) |
| Datenbank | MariaDB 11.8, siehe §3 | eigene Datenbank anlegen |
MAIL_MAILER=log – verschickt nichts |
Strato-SMTP | |
| Postfach-Abruf (Portal-Mails) | aus (FEWO_MAILBOX_HOST leer) |
imap.strato.de |
| Suchmaschinen | noindex (alles außer APP_ENV=production) |
indexiert |
| Cronjob | noch offen (§6) | einrichten |
Git: https://gitea.stommer.de/Lars/fewo-stommer.git, Branch main. Gebaut und ausgeliefert wird immer der letzte Commit.
2. Strato-Paket (Hosting Pro)
- SSH/SFTP-Server:
51539426.ssh.w1.strato.hosting(paketspezifisch, nichtssh.strato.de– der lehnt ab). Port 22. - SSH-Benutzer:
stu100093250(Kundenlogin › Datenbanken und Webspace › SFTP & SSH › Details). Startverzeichnis/= Webspace-Wurzel. - Absoluter Pfad des Webspace:
/mnt/web508/e3/26/51539426/htdocs/(für Cronjobs). - PHP-CLI:
/opt/RZphp84/bin/php-cli(8.4). Die Web-PHP-Version des Pakets ist eine andere (8.3); die.htaccessim Deploy-Ordner setzt perAddType application/x-httpd-php84 .php8.4 nur für diesen Ordner. - Andere Inhalte im Webspace nicht anfassen: u. a.
www.fewo-stommer.de/(bestehendes WordPress),fewo, Karate-Wiki, Moodle. Das Deploy-Skript arbeitet ausschließlich unterhalb vonDEPLOY_PATH. - Domains: SSL-Zertifikate gibt es im Paket nur für Hauptdomains, nicht für Subdomains. Deshalb läuft der Test unter
stommer.info(Ziel: Ordnertest.fewo-stommer.de, SSL aktiv,www.stommer.infoebenso). Die Subdomaintest.fewo-stommer.dewird nicht mehr gebraucht. - Domain-Ziel = Deploy-Ordner selbst (Strato kann kein Symlink-Ziel wählen). Die dort vom Skript geschriebene
.htaccessleitet aufreleases/<aktive Version>/publicund sperrt alles Interne mit 403.
3. Datenbank (staging)
- Host
database-5021719836.webspace-host.com, Port 3306, Datenbankdbs16257975, Benutzerdbu2231025,DB_CONNECTION=mariadb. - Passwort: nur in
test.fewo-stommer.de/shared/.env(und Vaultwarden).
4. SSH-Zugang einrichten (neuer Rechner, z. B. privater PC)
- Schlüssel erzeugen:
ssh-keygen -t ed25519 -f ~/.ssh/strato_fewo -C "fewo-deploy <rechner>". - Öffentlichen Schlüssel beim Server eintragen (fragt einmal das SSH-Passwort des Strato-Benutzers ab):
ssh-copy-id -i ~/.ssh/strato_fewo.pub stu100093250@51539426.ssh.w1.strato.hosting(Windows ohnessh-copy-id: Inhalt vonstrato_fewo.pubper SSH an~/.ssh/authorized_keysanhängen.) - Test:
ssh -i ~/.ssh/strato_fewo stu100093250@51539426.ssh.w1.strato.hosting "ls". - Den privaten Schlüssel nur im Vaultwarden sichern, nie committen oder weitergeben.
- Aufräumen: Der Schlüssel des Firmen-Laptops (Kommentar in
~/.ssh/authorized_keysauf dem Server) wird entfernt, sobald der private PC eingerichtet ist.
Lokale Werkzeuge: PHP 8.4 CLI, Composer, Node/npm, Git, Bash (Windows: Git Bash). Danach scripts/deploy.example.env nach scripts/deploy.staging.env kopieren und mit den Werten aus §2 füllen (DEPLOY_PATH=test.fewo-stommer.de, DEPLOY_URL=https://stommer.info, DEPLOY_SSH_KEY=~/.ssh/strato_fewo; unter Windows ggf. COMPOSER_BIN="php /c/…/composer.phar").
5. Konfiguration auf dem Server (shared/.env)
Vorlage: .env.production.example. Bearbeiten nur direkt auf dem Server, damit Passwörter nicht durch Chat oder Repository laufen:
ssh -t -i ~/.ssh/strato_fewo stu100093250@51539426.ssh.w1.strato.hosting "nano test.fewo-stommer.de/shared/.env"
bash scripts/deploy.sh staging artisan optimize # danach Konfiguration neu einlesen
Gesetzte Werte im Testbetrieb (Geheimnisse ausgelassen):
| Schlüssel | Wert | Bemerkung |
|---|---|---|
APP_ENV |
staging |
nicht production → noindex |
APP_DEBUG |
false |
|
APP_URL |
https://stommer.info |
alle erzeugten Links bauen darauf auf (URL::forceRootUrl) |
APP_KEY |
gesetzt | nie ändern – sonst sind 2FA-Schlüssel und Sitzungen unlesbar |
DB_* |
siehe §3 | |
SESSION_DRIVER / CACHE_STORE |
database |
|
SESSION_SECURE_COOKIE |
true |
Anmeldung nur über HTTPS |
QUEUE_CONNECTION |
sync |
keine Worker auf Shared Hosting |
MAIL_MAILER |
log |
Testbetrieb verschickt keine E-Mails (landen in shared/storage/logs) |
FEWO_MAILBOX_HOST |
leer | Testbetrieb liest kein echtes Postfach |
FEWO_BANK_* |
leer | für Verträge/Angebote noch einzutragen |
FEWO_HEALTH_TOKEN, FEWO_SCHEDULER_TOKEN, FEWO_AUTOMATION_SECRET |
gesetzt | für n8n (Überwachung, Scheduler-Ersatz, Webhooks) |
5a. E-Mail: Testbetrieb und scharf schalten
- Betriebsart in der Verwaltung: System › Betrieb (nur Administratoren). Jede Installation beginnt im Testbetrieb: alle E-Mails (an Gäste, Vermieterin, Benachrichtigungen) gehen ausschließlich an die dort eingetragene Testadresse (ohne Eintrag:
FEWO_NOTIFICATION_EMAIL), egal was auf der Webseite eingetragen wurde. Ein gelber Hinweis oben in der Verwaltung zeigt das an. Erst „Scharf geschaltet“ liefert an die echten Empfänger. - Adressen der internen Kommunikation ebenfalls unter System › Betrieb: Benachrichtigungen an (mehrere Adressen: neue Anfragen, Angebotsantworten, Fristabläufe, Bewertungen, Portal-Mails/-Aufgaben, Kopie der Zahlungserinnerungen), Kontakt- und Antwortadresse (Webseite, Mietvertrag, Antwortadresse der Gäste-Mails), Absendername/-adresse (muss zum SMTP-Postfach
MAIL_USERNAMEpassen – das Formular warnt). Ohne Eintrag geltenFEWO_NOTIFICATION_EMAIL,FEWO_OWNER_EMAIL,MAIL_FROM_*ausshared/.env. FEWO_MAIL_REDIRECT_TOinshared/.envist eine harte Überschreibung für Testserver (gilt auch bei „scharf“); normalerweise leer lassen.- Versandweg: Standard
MAIL_MAILER=log– dann wird gar nichts zugestellt (auch nicht im Protokoll gespeichert). Für echten Versand inshared/.envMAIL_MAILER=smtpundMAIL_PASSWORD=<Passwort des Postfachs info@fewo-stommer.de>(nur selbst eintragen; Absender und SMTP-Anmeldung:info@fewo-stommer.de, Antwortadresse und Benachrichtigungen weiterFEWO_OWNER_EMAIL/FEWO_NOTIFICATION_EMAIL= fewo@stommer.de), dannbash scripts/deploy.sh staging artisan optimize. - Versand prüfen:
bash scripts/deploy.sh staging artisan mail:test– zeigt Versandweg, Umleitung und Fehler (z. B. SMTP-Anmeldung) und schickt eine Testmail. - Dass jede Mail-Vorlage fehlerfrei aufgebaut wird (17 Mail-Typen, in ihrem echten Zustand), prüft
tests/Feature/MailRenderingTest.php.
6. Erledigt / offen im Testbetrieb
Erledigt (22.10.2026): Ordnerstruktur, shared/.env, Migrationen, Grunddaten (ProductionSeeder: Wohnung, Saisons 2026, Inhalte, Seiten, Erscheinungsbilder), HTTPS unter stommer.info, Gesundheitscheck mit automatischem Rollback, Admin-Konto lars@stommer.com mit 2FA, 39 Fotos importiert und von Metadaten bereinigt, Ende-zu-Ende-Durchlauf Anfrage → Angebot → Annahme (Testbuchung 2026-0002, darf gelöscht werden).
Offen:
- Konto für Brigitte anlegen: System › Benutzer, Rolle Administrator, Ansicht Einfach (§7).
- E-Mail im Testbetrieb einschalten (§5a): Versandweg SMTP + Passwort; Betriebsart steht auf Testbetrieb mit Testadresse lars@stommer.com.
- Cronjob (Kundenlogin › Cronjobs), jede Minute:
/opt/RZphp84/bin/php-cli /mnt/web508/e3/26/51539426/htdocs/test.fewo-stommer.de/current/artisan schedule:runFalls Strato nicht minütlich erlaubt: n8n ruft jede Minutehttps://stommer.info/automation/schedulermit HeaderAuthorization: Bearer <FEWO_SCHEDULER_TOKEN>auf. - Bankdaten, Vertrags- und AGB-Texte, Rechtstexte prüfen.
Fotos aus dem alten WordPress übernehmen
Die Auswahl (39 aktuelle Fotos: Wohnung, Garten/Terrasse/Luftbilder, Umgebung – ohne Theme-Platzhalter, Logos, Vorschaugrößen und veraltete Einrichtung) mit Kategorie und Bildbeschreibung steht in database/data/wordpress-photos.csv. Der Import liest die Dateien nur aus dem WordPress-Ordner (dort wird nichts verändert), legt Original + WebP-Größen in shared/storage/app/public ab und überspringt bereits importierte Fotos (wiederholbar):
bash scripts/deploy.sh staging artisan photos:import /mnt/web508/e3/26/51539426/htdocs/www.fewo-stommer.de/wp-content/uploads --manifest=database/data/wordpress-photos.csv
Danach in der Verwaltung (Webseite › Fotos) Reihenfolge, Sichtbarkeit und Texte prüfen.
- Gitea-Runner für automatisches Deployment (DEPLOYMENT.md §5).
7. Zugang zur Verwaltung (/admin)
Benutzer anlegen – der erste Administrator per Befehl (das Passwort wird verdeckt im eigenen Terminal eingegeben, nie als Argument):
ssh -t -i ~/.ssh/strato_fewo stu100093250@51539426.ssh.w1.strato.hosting \
"cd test.fewo-stommer.de/current && /opt/RZphp84/bin/php-cli artisan users:create lars@stommer.com --name='Lars Stommer' --role=admin"
Weitere Benutzer legt ein Administrator in der Verwaltung an (System › Benutzer): Name, E-Mail, Rolle (was die Person darf) und Ansicht (was das Menü zeigt), Passwort. Rollen: admin (alles inkl. Benutzer), rentals (Vermietung), content (Inhalte); ohne Rolle kein Zugang. Festlegung 22.10.2026: Lars und Brigitte beide admin (dürfen alles); Brigitte mit einfacher Ansicht (beim Anlegen „Ansicht: Einfach“ wählen, sonst erhalten Administratoren die Expertenansicht).
Ansichten: Einfache Ansicht – Anfragen & Buchungen (Angebot senden, Mietvertrag, Zahlungen), Sperrzeiten, Preise & Angebote (Saisons, Sonderangebote/Rabattcodes, Extras), Gäste, Portal-Aufgaben, Bewertungen, Bilder. Expertenansicht – alle Einstellungen, die die Rolle erlaubt (Preise, Angebote, Portale, Webseite, System). Ohne Auswahl: Administratoren Experten-, alle anderen einfache Ansicht. Umschalten jederzeit über das Benutzermenü oben rechts („Zur … Ansicht wechseln“). Die Ansicht blendet nur Menüpunkte aus; Rechte regelt allein die Rolle.
Passwort vergessen: Ein Administrator vergibt unter System › Benutzer › Bearbeiten ein neues Passwort (eine Selbst-Zurücksetzung per E-Mail gibt es bewusst nicht). Handy verloren: dort Aktion „2FA zurücksetzen“ – die Person richtet die 2FA bei der nächsten Anmeldung neu ein.
Zwei-Faktor-Anmeldung (2FA): Filament-eigene Lösung mit Authenticator-App (TOTP, z. B. Bitwarden/Vaultwarden, Google oder Microsoft Authenticator) und Wiederherstellungscodes.
- Pflicht für alle Konten (Entscheidung 22.10.2026): Nach der ersten Anmeldung wird man auf die Einrichtungsseite geleitet (QR-Code scannen, Code bestätigen, Wiederherstellungscodes sichern). Filament-Standard (
multiFactorAuthentication(isRequired: true)). - Schlüssel und Codes liegen verschlüsselt (mit
APP_KEY) inusers.app_authentication_secret/app_authentication_recovery_codes. - Handy verloren: Anmeldung mit einem Wiederherstellungscode. Sind auch die weg, setzt ein Administrator mit Serverzugang die 2FA zurück:
Danach bei der nächsten Anmeldung neu einrichten.
bash scripts/deploy.sh staging artisan tinker --execute='App\Models\User::where("email", "lars@stommer.com")->update(["app_authentication_secret" => null, "app_authentication_recovery_codes" => null]);'
Lokal (nur Entwicklung, php artisan migrate:fresh --seed): admin@example.com / password, 2FA wird bei der ersten Anmeldung eingerichtet.
7a. Datensicherung, Löschfristen, Automationen
- Datenbank-Backup: täglich 02:30 per Scheduler (
php artisan backup:database) alsshared/storage/app/private/backups/fewo-<datum>.sql.gz; es bleiben die neuesten 14 (FEWO_BACKUP_KEEP). Wiederherstellen: Datei entpacken und mitmysqlbzw. phpMyAdmin (Strato) einspielen. - Sicherung aufs NAS / einen Rechner (holt eine frische Datenbank-Sicherung plus Fotos und Verträge; auf dem Server wird nichts verändert):
Regelmäßig z. B. per Aufgabenplanung des NAS/PC ausführen (braucht den SSH-Schlüssel aus §4).
bash scripts/backup-pull.sh staging /pfad/zum/nas/fewo-backup - Löschfristen (Vorschläge, rechtlich zu bestätigen –
config/fewo.phpbzw..env): Gästedaten 10 Jahre nach letztem Aufenthalt (FEWO_GUEST_RETENTION_YEARS), nie verbindlich gewordene Anfragen/Angebote 6 Monate (FEWO_RETENTION_INQUIRY_MONTHS), Textauszüge von Portal-Mails 90 Tage (FEWO_RETENTION_PORTAL_EMAIL_EXCERPT_DAYS), Herkunftsangaben/UTM 24 Monate (FEWO_RETENTION_ATTRIBUTION_MONTHS). Läuft täglich 03:00. Anonymisierung ersetzt Name, Kontaktdaten, Nachrichten, Notizen, Herkunft und Bewertungs-Anzeigenamen; Buchung, Preise und Zahlungen bleiben als Beleg. - Bot-Schutz der Buchungsanfrage (ohne externen Captcha-Dienst,
config/fewo.php › spam): verstecktes Köderfeld, Zeitsperre (Absenden schneller als 4 s nach dem Öffnen = Bot, wird still ignoriert), höchstens 5 Anfragen/Stunde je IP, 3/Tag je E-Mail-Adresse, 30/Stunde insgesamt, höchstens 2 gleichzeitig vorgemerkte Anfragen je E-Mail-Adresse (sonst könnten Bots den Kalender blockieren), keine Links in Namen und höchstens 1 Link in der Nachricht. - Automationen (n8n): Token bitte als Header
Authorization: Bearer <token>senden (landet nicht in Server-Logs);?token=funktioniert übergangsweise weiter. - Fotos: Beim Hochladen werden Metadaten (GPS, Kamera) aus dem Original entfernt; bestehende Fotos einmalig:
php artisan photos:strip-metadata(--forcebearbeitet auch bereits markierte erneut). Hinweis: bewusst mit GD – Imagick (auf Strato installiert) behält EXIF beim Speichern.
8. Bekannte Eigenheiten und Lösungen
| Problem | Ursache | Lösung (umgesetzt) |
|---|---|---|
| Nach dem Umschalten lief die alte Version weiter | Strato-OPcache speichert Skripte unter dem Symlink-Pfad current/… |
.htaccess zeigt auf den konkreten Ordner releases/<version>/public und wird bei jedem Umschalten neu geschrieben |
Links mit /current/public (z. B. Sitemap) |
Laravel leitet den Basis-Pfad aus dem Skript-Pfad ab | URL::forceRootUrl(APP_URL) außerhalb von local/testing (AppServiceProvider) |
| HTTP 500 „Composer platform“ | Web-PHP des Pakets ist 8.3 | AddType application/x-httpd-php84 .php in der Ordner-.htaccess |
| Im Admin hochgeladenes Foto erscheint in der Fotoliste, auf der Website/im Grundriss-Editor aber als leeres Bild (HTTP 403) | Upload-Feld nahm Filaments Standard-Speicher FILESYSTEM_DISK=local (privat, storage/app/private/<media-id>); Import und Website nutzen public |
Seit 23.10.2026 (1871c04): Fotos immer auf public (Photo-Sammlung useDisk('public'), Upload-Feld ->disk('public')); Migration 2026_10_23_171001_move_photo_media_to_the_public_disk hat vorhandene private Fotos verschoben (stommer.info: Foto 41). Direkt nach dem Verschieben kann Strato die Adresse kurz noch mit 403 beantworten |
| SSH „connection closed“ | falscher Server ssh.strato.de |
paketspezifischer Server (§2) |
Domain-Ziel current/public nicht wählbar |
Strato erlaubt kein Symlink-Ziel | Domain auf den Deploy-Ordner, .htaccess leitet weiter |
| Ersteinrichtung mit Factories schlägt fehl | Produktion ohne Dev-Pakete | ProductionSeeder |
| Kein SSL für Subdomain | Paket erlaubt SSL nur für Hauptdomains | Testbetrieb auf stommer.info |
Disk quota exceeded beim Hochladen / Hinweis „zu viele Dateien“ |
Webspace-Kontingent voll (geteilt mit allen anderen Seiten/Backups im Paket); jede Version belegt ~136 MB | Es ist die Anzahl der Dateien (Inode-Limit), nicht der Platz. Der Server behält nur die aktive Version (Geschichte als Git-Tags in Gitea), vendor wird beim Build ausgedünnt (~15.000 statt ~19.500 Dateien je Version); Reste abgebrochener Läufe räumt das nächste Deployment selbst weg. Ordner außerhalb des Deploy-Ordners entscheidet nur Lars (teils produktiv). |
| Signierte Links (Angebot, Bewertung, Newsletter, Vorschau) mit 403 | Strato meldet nach der .htaccess-Weiterleitung den internen Pfad /releases/<version>/public/… in REQUEST_URI |
public/index.php entfernt dieses Präfix vor dem Start von Laravel |
| Keine E-Mails im Testbetrieb, auch nicht im Protokoll | MAIL_MAILER=log schreibt auf Stufe debug, LOG_LEVEL=info verwirft das |
Zum Testen SMTP einschalten; FEWO_MAIL_REDIRECT_TO leitet dann alle Mails an eine Adresse (gesetzt: lars@stommer.com) |
| Foto-Metadaten (GPS) blieben erhalten | Spatie Image nutzt Imagick, wenn installiert (Strato), und Imagick behält EXIF | StripImageMetadata erzwingt GD |
Windows: Symlinks, php nicht im PATH |
Git Bash | Deploy nur gegen Strato testen; export PATH="<php-ordner>:$PATH" |
9. Nützliche Befehle
bash scripts/deploy.sh staging deploy # ausliefern (letzter Commit)
bash scripts/deploy.sh staging releases # aktive Version + Deploy-Tags in Git
bash scripts/deploy.sh staging deploy deploy/staging/<zeitstempel> # frühere Version erneut ausliefern
bash scripts/deploy.sh staging artisan about # Zustand der Installation
bash scripts/deploy.sh staging artisan migrate:status
ssh -i ~/.ssh/strato_fewo stu100093250@51539426.ssh.w1.strato.hosting \
"tail -n 50 test.fewo-stommer.de/shared/storage/logs/laravel-$(date +%F).log" # Fehlerprotokoll