Analytics

Built-in, privacy-friendly analytics with no cookies, no external services, and full GDPR compliance. All data stays on your server.

How It Works

Sovrium analytics follows a simple three-step pipeline. No external services required.

Collect

A lightweight script records page views, sessions, referrers, and device info via /api/analytics/collect.

Store

All data is stored locally in your database. No cookies, no fingerprinting, no external calls.

Query

Access your analytics via the admin dashboard or API. Data stays on your server.

Quick Enable

Set analytics to true for sensible defaults. No configuration needed.

YAML
# Boolean shorthand - enables all defaults
analytics: true

Boolean vs Object

analytics: true enables defaults (90-day retention, DNT respected, 30-min sessions). Use an object to override specific settings while keeping defaults for the rest.

Advanced Configuration

Fine-tune analytics behavior with retention, privacy, and session options.

YAML
analytics:
  retentionDays: 90
  respectDoNotTrack: true
  excludedPaths:
    - /admin
    - /api
  sessionTimeout: 30
PropertyDescription
retentionDaysNumber of days to retain analytics data. Default: 90.
respectDoNotTrackWhen true, respects the browser Do Not Track setting. Default: true.
excludedPathsArray of URL paths to exclude from tracking (e.g., /admin, /api).
sessionTimeoutSession timeout in minutes. A new session starts after this idle period. Default: 30.

Privacy-first analytics

Sovrium analytics are cookie-free, GDPR-compliant by default. All data stays on your server. No third-party services involved.

When enabled, Sovrium injects a lightweight tracking script that records page views, sessions, referrers, and device information. Analytics data is collected at /api/analytics/collect and stored locally.

LanguagesJSON Schema