* Align Postgres version on 18.6 * Document production tablebase path and permissions * Add cookieless Matomo analytics with opt-out (#131)
2.8 KiB
Analytics
We use a self-hosted Matomo instance for privacy-conscious analytics on public pages and the guest trainer.
What is collected
- Page views on anonymous public pages and the guest trainer.
- Standard request data Matomo needs to count a visit, with IP anonymisation.
We do not:
- set Matomo cookies,
- use user IDs,
- track signed-in account, profile, or admin pages,
- enable cross-site or advertising features,
- share analytics data with third parties.
Configuration
The app reads these environment variables at boot:
MATOMO_URL=https://analytics.owenrees.eu/
MATOMO_SITE_ID=6
They are configured in config/runtime.exs for production only. If either is
missing, no analytics config is rendered and no tracker is loaded.
The root layout renders a hidden #matomo-config element only when the visitor
is anonymous. assets/js/analytics.js initialises Matomo cookieless from that
element. Signed-in users never receive the element.
Matomo settings
In the Matomo administration UI:
- Administration → Websites → Manage
- URL:
https://innersquare.app - Site ID:
6 - Timezone: match the site
- URL:
- Administration → Privacy → Anonymize data
- Enable IP anonymisation (at least the last byte; 2 bytes is safer)
- Disable tracking cookies
- Respect Do Not Track
- Do not use user IDs
- Set raw data retention to 180 days
- Administration → System check / trusted hosts
- Add
innersquare.appandwww.innersquare.appif host validation is on.
- Add
- Do not enable ecommerce, advertising, or cross-domain tracking.
The JavaScript also calls:
_paq.push(["disableCookies"]);
_paq.push(["setDoNotTrack", true]);
Opt-out
The privacy page has an Analytics section with an opt-out control. The
preference is stored in localStorage["matomo_optout"], not a cookie. When set,
the tracker is never loaded and LiveView page views are skipped.
The preference is local to the browser. Clearing site data resets it. Users can
also object by emailing support@innersquare.app.
Verification
On an anonymous public page:
curl -s https://innersquare.app/ | grep -c matomo-config
should return 1.
In the browser:
matomo.jsandmatomo.phpload once.- Matomo Real-time shows the page view.
- No
_pk_*cookies are created. - Opting out sets
matomo_optout=1in localStorage and stops further requests. - Signed-in pages produce no Matomo config or requests.
- A DNT browser setting suppresses tracking.
Legal basis
Analytics runs on the basis of legitimate interests in improving the service. The privacy policy discloses it, explains the data, and provides the opt-out. This document is an engineering configuration guide, not legal advice; keep a short legitimate-interest assessment on file.