self-hosted 4 min read

Litlyx – Self-Hostable, Open-Source Web Analytics

A lightweight, open-source web analytics platform. Self-host with Docker, GDPR compliant, cookie-free, and live in 30 seconds.

By
Share: X in
Litlyx analytics dashboard

TL;DR

TL;DR: Litlyx is an open-source, self-hostable web analytics platform that runs entirely in the browser with no cookies, full GDPR compliance, and a 30-second setup.

Source and Accuracy Notes

⚠️ This section is MANDATORY. All links must be verified from actual source, not guessed.

What Is Litlyx?

Litlyx is an open-source web analytics platform positioned as a privacy-first alternative to Google Analytics 4, Mixpanel, Plausible, Umami, and Matomo. It requires no cookies, collects no personal data, and is fully GDPR compliant.

You can use the hosted cloud version at dashboard.litlyx.com or self-host it on your own infrastructure.

Key Features

From the official README:

  • Cookie-free tracking — no cookie banners required
  • GDPR compliant — no personal data collected
  • 30-second setup — cloud version or self-hosted Docker
  • Self-hostable — full ownership of your data
  • Real-time dashboard — live visitor counts
  • Custom events — track any interaction with metadata
  • Framework integrations — React, Vue, Svelte, Next.js, Nuxt, and more
  • WordPress support — via script injection plugin

Setup: Cloud Version

The fastest path to analytics:

  1. Sign up at dashboard.litlyx.com
  2. Create a new project and copy your workspace_id
  3. Add the snippet to your site:
<script defer data-workspace="your_workspace_id"
  src="https://cdn.jsdelivr.net/npm/litlyx-js@latest/browser/litlyx.js">
</script>

Or install via npm:

npm i litlyx-js

Then initialize in JavaScript:

import { Lit } from 'litlyx-js';

Lit.init('your_workspace_id');

Setup: Self-Hosted with Docker

For full data ownership, self-host Litlyx:

docker run -d \
  --name litlyx \
  -p 3000:3000 \
  -e DATABASE_URL=your_database_url \
  litlyx/litlyx

Refer to the Litlyx docs for full Docker configuration, environment variables, and reverse proxy setup.

What Gets Tracked

Once initialized, Litlyx automatically tracks:

  • Page views
  • Unique visitors
  • Real-time active users
  • Referrer sources
  • Device and browser info (aggregated only)

Custom events are fired manually:

Lit.event('purchase_complete', {
  metadata: {
    'product-name': 'Premium Plan',
    'amount': 29.99
  }
});

Practical Evaluation Checklist

  • [x] Open-source (Apache 2.0, verified)
  • [x] Self-hostable via Docker
  • [x] No cookies required
  • [x] GDPR compliant
  • [x] 30-second cloud setup
  • [x] Free self-hosted version
  • [x] Real-time dashboard
  • [x] Custom event tracking with metadata
  • [x] Multi-framework support (React, Vue, Svelte, Next.js, Nuxt)
  • [x] WordPress plugin available

FAQ

Q: Does Litlyx require a cookie consent banner? A: No. Litlyx tracks without cookies and collects no personal data, so cookie consent banners are not required under GDPR.

Q: Is the cloud version free? A: Litlyx offers a free tier on the hosted cloud. Self-hosting is also free and open-source.

Q: What databases does self-hosted Litlyx support? A: Refer to the Litlyx docs for supported databases and configuration options.

Q: How does Litlyx compare to Umami or Plausible? A: Litlyx positions itself as a privacy-first alternative with a modern UI and faster setup. All three are cookie-free, GDPR compliant, and self-hostable. The key differentiator is Litlyx’s 30-second setup claim and TypeScript-based architecture.

Q: Is there a WordPress plugin? A: Yes, Litlyx can be integrated into WordPress sites using a third-party injection plugin or by manually adding the script tag.

Conclusion

Litlyx fills the gap between overly complex analytics suites and bare-bones page counters. Its cookie-free, GDPR-compliant approach means you can deploy it without legal overhead, and the 30-second cloud setup makes it accessible to non-technical users. For developers who want full data ownership, the self-hosted Docker option is straightforward and well-documented.

If you need privacy-respecting analytics without the overhead of a full data warehouse, Litlyx is worth evaluating. The Apache 2.0 license and active open-source community (1,741 GitHub stars) provide confidence the project will remain viable independently.

Explore the project at litlyx.com or check the source on GitHub.