Installation: Docker
Paragrafy lässt sich am schnellsten und saubersten über Docker und Docker Compose betreiben.
Voraussetzungen
Abschnitt betitelt „Voraussetzungen“- Docker & Docker Compose auf dem Server installiert.
Schnellanleitung
Abschnitt betitelt „Schnellanleitung“-
Repository komplett klonen (nicht nur die Docker-Dateien!):
Terminal-Fenster git clone https://github.com/mineco-de/Paragrafy.git && cd ParagrafyDas Image wird aus diesem lokalen Checkout gebaut (
COPY . /var/www/html/in der Dockerfile) — es holt den Code nicht mehr selbst von GitHub, damitdocker compose up -d --buildzuverlässig deinen aktuellen Stand verwendet und nicht an einem alten Docker-Layer-Cache-Stand hängen bleibt. -
Container im Hintergrund starten:
Terminal-Fenster docker compose up -d --build
Persistenz
Abschnitt betitelt „Persistenz“docker-compose.yaml mountet ./data nach /var/www/html/data und setzt
PARAGRAFY_DATA_DIR=/var/www/html/data — dort liegen paragrafy_data.sqlite, config.php,
/backups und ein optionales .env.local. Ohne dieses Volume gehen Datenbank und
Admin-Zugangsdaten bei jedem --build verloren. Der Container setzt beim Start automatisch die
richtigen Dateirechte auf diesen Ordner (per docker-entrypoint.sh), auch wenn das
Host-Verzeichnis vorher nicht existierte.
Für einen Bare-Metal-/Apache-Betrieb (siehe Installation: Apache) ist
PARAGRAFY_DATA_DIR nicht nötig — dann liegen Datenbank und Config wie gewohnt direkt im
Projektordner.
Danach geht es weiter mit der Erstinstallation & Cron-Jobs.