Digitale Downloads: Persistenz-Fix & automatische Lieferung fĂĽr frĂĽhere Bestellungen

13. September 2026

Heute haben wir einen Fehler behoben, der dazu führte, dass einige digitale Download-Dateien nach Server-Updates verschwanden — und, genauso wichtig, dafür gesorgt, dass Käufer automatisch Zugriff erhalten, sobald ein Verkäufer eine Datei (erneut) hochlädt.

Was war passiert

Einige Käufer sahen „file not found on disk” (Datei nicht auf der Festplatte gefunden), wenn sie in Meine Downloads auf den Download-Button klickten — obwohl ihre Bestellung bezahlt war und der Download-Eintrag existierte.

Die technische Ursache

Unser Game-Service läuft in einem Docker-Container auf jedem regionalen VPS. Hochgeladene Download-Dateien werden nach /var/lib/erleuchtung/shop-downloads geschrieben — das sollte ein persistenter Ordner auf dem Host-Server sein, der in den Container eingebunden wird.

Der Mount existierte in unserer Entwicklungskonfiguration, fehlte aber in der Deployment-Compose-Datei, die unser Update-Agent auf den VPS-Knoten installiert. Dadurch wurden hochgeladene Dateien im Dateisystem-Layer des Containers gespeichert. Wann immer ein Update den Container neu erstellte, wurde dieser Layer verworfen — die Dateien verschwanden, während die Datenbankeinträge (die in PostgreSQL liegen) überlebten.

Das Ergebnis: ein gĂĽltiger Download-Eintrag, der auf eine nicht mehr existierende Datei zeigte.

Was wir gefixt haben

  • Persistenter Speicher auf allen Nodes. Das Download-Verzeichnis ist jetzt auf allen regionalen Servern (US, IN, EU2, SG und unserem MAAS-Staging-Node) korrekt auf den Host-Speicher gemountet. Uploads ĂĽberleben Updates und Container-Neuerstellungen.
  • Automatisches Backfill beim Upload. Bisher wurde der Download-Zugriff nur zum Zeitpunkt der Bezahlung gewährt — und nur fĂĽr Dateien, die zu diesem Zeitpunkt existierten. Jetzt wird eine hochgeladene Datei automatisch allen Käufern mit einer bezahlten Bestellung fĂĽr dieses Produkt freigeschaltet, inklusive Sofort-Benachrichtigung.
  • Selbstheilende Download-Liste. Das Ă–ffnen von „Meine Downloads” repariert jetzt fehlende Freischaltungen fĂĽr alle bezahlten Bestellungen — ältere Käufe heilen sich selbst.
  • Freischaltung bei Versand. Wenn ein Verkäufer eine Bestellung als versendet/geliefert markiert, werden angehängte Dateien sofort freigeschaltet — digitale Ware ist bei Lieferung fällig.

Was Verkäufer tun müssen

Dateien, die vor diesem Fix hochgeladen wurden und bei einem Update verloren gingen, können nicht wiederhergestellt werden — sie existierten nur innerhalb eines verworfenen Container-Layers.

Wenn du früher Dateien hochgeladen hast: Öffne dein Produkt, lösche den veralteten Download-Eintrag und lade die Datei erneut hoch. In dem Moment, in dem du hochlädst, erhalten alle bisherigen Käufer automatisch wieder Zugriff — kein manueller Aufwand nötig.

Ein Wort zur Transparenz

Die „versendet”-Benachrichtigungs-E-Mails, die einige von euch erhalten haben, erwähnten herunterladbare Dateien, die nie tatsächlich angehängt waren — dieser Text war die Versandnotiz des Verkäufers, keine Dateilieferung. Mit diesem Release ist der Download-Button in „Meine Downloads” die einzige verlässliche Quelle: Wenn eine Datei dort gelistet ist, existiert sie auf dem Server und lässt sich herunterladen.

Danke für eure Geduld — und ein besonderer Dank an die Community-Mitglieder, die das Problem so schnell gemeldet haben.

— Das Erleuchtung-Team