From 3a5849660af7a7dc009e6673fff380a851bbcb4c Mon Sep 17 00:00:00 2001 From: "Pirmin Hinderling (fedora)" Date: Tue, 7 Jul 2026 21:54:52 +0200 Subject: [PATCH] Document collectstatic requirements for hashed static files in production. Clarifies that collectstatic must run with production env vars and --clear after static updates. Co-authored-by: Cursor --- README.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/README.md b/README.md index 2bea465..f361c99 100644 --- a/README.md +++ b/README.md @@ -117,11 +117,24 @@ cd /pfad/zu/ArgumentAtlas source .venv/bin/activate pip install -r requirements.txt +set -a && source /etc/faktenkompass.env && set +a python manage.py migrate python manage.py collectstatic --noinput python manage.py createsuperuser # falls noch nicht vorhanden ``` +**Wichtig:** `collectstatic` immer mit denselben Umgebungsvariablen ausführen wie der Daphne-Dienst (`DJANGO_DEBUG=False`). Sonst fehlen gehashte Dateinamen bzw. `staticfiles.json` und die Seite antwortet mit 500. + +Nach jedem `git pull` mit geänderten Static-Dateien: + +```bash +set -a && source /etc/faktenkompass.env && set +a +python manage.py collectstatic --clear --noinput +sudo systemctl restart faktenkompass +``` + +Erfolg prüfen: `staticfiles/staticfiles.json` existiert, CSS heißt z. B. `custom..css`. + Stellen Sie sicher, dass der Prozessnutzer Schreibrechte für `media/` und die Datenbank hat. ### 3. Daphne manuell testen