flixcooks-website/docs/COOLIFY.md

FlixCooks auf Coolify deployen

Zwei getrennte Ressourcen: PostgreSQL und PHP-Web-App (dieses Repo als Dockerfile).

Architektur

┌──────────────────── Coolify Server ────────────────────┐
│                                                         │
│  ┌──────────────┐         ┌─────────────────────────┐ │
│  │  PostgreSQL  │◄────────│  FlixCooks (dieses Image) │ │
│  │  (Service B) │  :5432  │  Apache + PHP 8.3         │ │
│  └──────────────┘         │  Port 80 → Traefik/HTTPS  │ │
│         ▲                 └─────────────────────────┘ │
│         │                                              │
│    Volume (Daten)                                      │
└─────────────────────────────────────────────────────────┘

Die App startet nicht, wenn DATABASE_URL fehlt oder Postgres nicht erreichbar ist. Rezepte, Impressum und Datenschutz liegen komplett in Postgres.

---

1. PostgreSQL in Coolify anlegen

1. Neues Database → PostgreSQL (16).
2. Notieren:

• Benutzer, Passwort, Datenbankname
• Internal URL (Host ist oft der Service-Name, z. B. postgresql-xxxxx oder was Coolify anzeigt)

3. Format für die App:

postgresql://USER:PASSWORD@HOST:5432/DATABASE

Beispiel (Platzhalter durch Coolify-Werte ersetzen):

postgresql://flixcooks:geheim@postgresql-flixcooks:5432/flixcooks

Wichtig: In der App den internen Hostnamen verwenden (gleiches Coolify-Netzwerk), nicht 127.0.0.1.

---

2. Web-App in Coolify anlegen

1. Neues Application → Build Pack: Dockerfile (Repository dieses Projekts).
2. Dockerfile-Pfad: Dockerfile (Root).
3. Port: 80 (Container exponiert Apache auf 80).
4. Health Check (optional, empfohlen):

• Path: /health.php
• Erwartet HTTP 200 mit {"status":"ok"}

Environment Variables (Pflicht)

Variable	Beschreibung
DATABASE_URL	Interne Postgres-URL von Coolify
FLIXCOOKS_ADMIN_KEY	Starkes Passwort für /admin.php

Environment Variables (optional)

Variable	Default	Beschreibung
DB_WAIT_MAX_TRIES	30	Warteversuche bis Postgres da ist (à 2 s)

Persistent Storage

Nur PostgreSQL benötigt persistenten Speicher. Für die Web-App selbst ist kein /var/www/html/data-Volume mehr nötig, weil Rezepte und Site-Settings in Postgres liegen.

---

3. Erstes Deployment (Checkliste)

1. Postgres-Service läuft (healthy).
2. App mit DATABASE_URL + FLIXCOOKS_ADMIN_KEY deployen.
3. https://deine-domain/health.php → {"status":"ok"}.
4. https://deine-domain/admin.php → Rezepte anlegen, Impressum/Datenschutz unter „Site settings" befüllen.

Schema ohne Seed

Tabellen legt der Container beim Start automatisch an (scripts/schema.sql via require_database()). Eine leere DB ist kein Fehler — die Site startet mit Platzhalter-Impressum/Datenschutz und zeigt eine leere Rezeptliste. Inhalte werden ausschließlich über /admin.php gepflegt.

---

4. Lokaler Test vor Coolify

export FLIXCOOKS_ADMIN_KEY="dein-geheimes-passwort"
docker compose build
docker compose up -d
curl http://127.0.0.1:8080/health.php

---

5. Updates / Redeploy

• Neues Image bauen lassen (Git push → Coolify rebuild).
• Postgres-Volume bleibt → Daten bleiben.
• Kein manuelles db-seed bei Updates, außer du leerst die DB bewusst.

---

6. Sicherheit

• .env wird nicht ins Image kopiert (.dockerignore).
• Admin-Key nur über FLIXCOOKS_ADMIN_KEY in Coolify setzen. Ohne diese Variable ist /admin.php deaktiviert.
• Postgres nicht öffentlich exponieren, wenn nicht nötig (nur interne URL).

---

7. Troubleshooting

Problem	Lösung
Container startet nicht	Logs: DB nicht erreichbar → DATABASE_URL Host/Passwort prüfen
503 „Datenbank nicht verfügbar“	Gleiches Netzwerk in Coolify? Internal URL?
Leere Seite, Health OK	Rezepte über /admin.php anlegen, Site-Settings befüllen
Admin geht nicht	FLIXCOOKS_ADMIN_KEY gesetzt?