Skip to content

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.

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.

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.

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.