Files
fewo-stommer/docs/BETRIEB.md
T

10 KiB
Raw Blame History

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 in shared/.env auf 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
E-Mail 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, nicht ssh.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 .htaccess im Deploy-Ordner setzt per AddType application/x-httpd-php84 .php 8.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 von DEPLOY_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: Ordner test.fewo-stommer.de, SSL aktiv, www.stommer.info ebenso). Die Subdomain test.fewo-stommer.de wird nicht mehr gebraucht.
  • Domain-Ziel = Deploy-Ordner selbst (Strato kann kein Symlink-Ziel wählen). Die dort vom Skript geschriebene .htaccess leitet auf releases/<aktive Version>/public und sperrt alles Interne mit 403.

3. Datenbank (staging)

  • Host database-5021719836.webspace-host.com, Port 3306, Datenbank dbs16257975, Benutzer dbu2231025, DB_CONNECTION=mariadb.
  • Passwort: nur in test.fewo-stommer.de/shared/.env (und Vaultwarden).

4. SSH-Zugang einrichten (neuer Rechner, z. B. privater PC)

  1. Schlüssel erzeugen: ssh-keygen -t ed25519 -f ~/.ssh/strato_fewo -C "fewo-deploy <rechner>".
  2. Ö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 ohne ssh-copy-id: Inhalt von strato_fewo.pub per SSH an ~/.ssh/authorized_keys anhängen.)
  3. Test: ssh -i ~/.ssh/strato_fewo stu100093250@51539426.ssh.w1.strato.hosting "ls".
  4. Den privaten Schlüssel nur im Vaultwarden sichern, nie committen oder weitergeben.
  5. Aufräumen: Der Schlüssel des Firmen-Laptops (Kommentar in ~/.ssh/authorized_keys auf 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)

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.

Offen:

  • Admin-Benutzer anlegen (§7) und 2FA einrichten.
  • Cronjob (Kundenlogin › Cronjobs), jede Minute: /opt/RZphp84/bin/php-cli /mnt/web508/e3/26/51539426/htdocs/test.fewo-stommer.de/current/artisan schedule:run Falls Strato nicht minütlich erlaubt: n8n ruft jede Minute https://stommer.info/automation/scheduler?token=<FEWO_SCHEDULER_TOKEN> auf.
  • Fotos importieren, Bankdaten, Vertrags- und AGB-Texte, Rechtstexte 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). Rollen: admin (alles inkl. Benutzer), rentals (Vermietung), content (Inhalte); ohne Rolle kein Zugang.

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 Administratoren: Nach der ersten Anmeldung wird man auf die Einrichtungsseite geleitet (QR-Code scannen, Code bestätigen, Wiederherstellungscodes sichern). Umgesetzt mit App\Http\Middleware\RequireTwoFactorForAdmins.
  • Freiwillig für andere Rollen: im Profil (Avatar oben rechts › Profil).
  • Schlüssel und Codes liegen verschlüsselt (mit APP_KEY) in users.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:
    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]);'
    
    Danach bei der nächsten Anmeldung neu einrichten.

Lokal (nur Entwicklung, php artisan migrate:fresh --seed): admin@example.com / password, 2FA wird bei der ersten Anmeldung eingerichtet.

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
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).
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