Privacy
Turning on progress, the dashboard, or xAPI makes the site owner the data controller for the learner records those features create. StratoLMS does not host the data; the store you configure does.
What each feature stores
Section titled “What each feature stores”| Feature | Stored | Why |
|---|---|---|
| Progress | Pseudonymous learner id, course slug, lesson id, watch milestone, completion time | Cross-device resume and the owner dashboard |
| Emails | AES-GCM ciphertext of the email, only when progress.storeEmail is on |
So the owner can recognise a learner; decryptable only with EMAIL_ENCRYPTION_KEY |
| xAPI | Completion statements queued in the outbox, then delivered to the LRS | The owner’s learning record store, never the learner’s email |
| Dashboard | Audit rows for export, erase, owner sign-in and retention | Accountability for access to learner data |
| Audience | Nothing on this site: the address goes straight to your list provider | Email-list signup, only if you install audience() (guide) |
With the optional learner-data features off, StratoLMS creates no learner-store database records or xAPI outbox. Lesson completion stays in the learner’s browser, and payment providers retain their own purchase records. The default configuration is covered by the v1 parity snapshot.
Optional signup also makes you responsible for the addresses it collects, so
stratolms check requires a finished privacy page whenever audience() is
installed.
Pseudonymity
Section titled “Pseudonymity”LEARNER_ID_KEY hashes email:… or license:… with HMAC-SHA256 and emits a
43-character base64url id. The dashboard shows Learner plus the first eight
characters of that id unless an email was stored and can be decrypted.
Retention, export and erasure
Section titled “Retention, export and erasure”progress.retentionDays (30–3650, default 730) is enforced by
POST /api/maintenance/run. Learners can GET /account/data.json and
POST /api/progress/erase-me. Owners can export CSV and erase a learner from
the dashboard. Erase removes progress, identity and outbox rows for that id.
Statements use an account actor whose name is the pseudonym. The LRS endpoint must be public HTTPS; private and loopback hosts are rejected.
Replace TODO-PRIVACY on the starter privacy page before turning progress on.
stratolms check fails while that marker remains, for any site that needs the
page: progress, the dashboard, xAPI, a payment provider, audience signup, or a
published paid course. A page that still has the marker is never published: it
is not a route, has no Markdown twin, and is not in llms.txt or the sitemap.
A free site with none of those features needs no privacy page, so the unfinished
starter page stays out of its output.