selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

Prisme Analytics logo

Self-host Prisme Analytics

v0.20.0

Privacy-focused web analytics with Grafana dashboards

BetaOpen SourceAGPL-3.0
Docker ComposeCompose file & guide
docker compose up -d
Updatedlast year
LanguageTypescript
Setup difficultyAdvanced
ThemeDark mode
Stars
134
Ports
8000 (Prisme web server (HTTP API and tracking endpoints)), 9090 (Administration server (metrics))
Requires
ClickHouse, Grafana
Docker
docker.io/prismelabs/analytics
Web analytics dashboard in light modeWeb analytics dashboard in dark modeFunnel panel visualization in light modeFunnel panel visualization in dark modeExplore page with SQL query interface in light modeExplore page with SQL query interface in dark mode

What is Prisme Analytics?

Prisme Analytics is a self-hosted web analytics platform built for privacy compliance (GDPR, PECR, CCPA) without cookie banners. It collects anonymized data through a lightweight 2KB tracking script, filters bots automatically, and supports custom events and dashboards. The system runs in two modes: default (full-featured with Grafana integration for user management, teams, permissions, and multi-organization support) and ingestion-only (lightweight event collector). Data is stored in ClickHouse for high-performance queries, and the UI is provided through Grafana dashboards. Self-hosting is done via Docker Compose with ClickHouse and Grafana as dependencies. The project offers a paid cloud version (Prisme Cloud) but all features are available in the open-source edition.

Should you self-host Prisme Analytics?

Prisme Analytics scores 44/100 on selfhost.directory (how scoring works) and ranks #20 of 27 in Analytics. It has 134 GitHub stars.

There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.

Setup is advanced: plan for several services and some ongoing maintenance. An official Docker image is available. It is AGPL-3.0-licensed and written mostly in Typescript.

Its closest alternative on selfhost.directory is Plausible Analytics (81/100, 29 704 stars). It scores higher overall, so compare the two before you pick. See Prisme Analytics vs Plausible Analytics side by side.

Features

  • Bot and spam filtering
  • Custom events and dashboards
  • Forever data retention
  • High-performance ingestion
  • HTTP API for events
  • Lightweight tracking script
  • Multi-organization Support
  • No-JavaScript tracking
  • Privacy-Focused Analytics
  • Real-time data processing
  • SPA support
  • SQL API for data exploration
  • Two server modes
  • Unlimited websites and events
  • UTM campaign tracking

Prisme Analytics README

How to install Prisme Analytics

Install Prisme Analytics with Docker Compose

Docker and Docker Compose installed

Download the official docker-compose.yml file from the Prisme repository.

Configure services by editing lines preceded by EDIT_ME: comments.

Run:

docker compose up -d

Requires Docker and Docker Compose installed. Uses ClickHouse and Grafana containers.

How to configure Prisme Analytics

  • PRISME_ADMIN_HOSTPORT127.0.0.1:9090Host:port for administration server (metrics)

    Host:port for administration server (metrics)

  • PRISME_CLICKHOUSE_DATABASEprismeClickHouse database to use

    ClickHouse database to use

  • PRISME_CLICKHOUSE_HOSTPORTHost:port pointing to ClickHouse instance

    Host:port pointing to ClickHouse instance

  • PRISME_CLICKHOUSE_TLSfalseUse TLS connection for ClickHouse

    Use TLS connection for ClickHouse

    values: true, false

  • PRISME_EVENTSTORE_MAX_BATCH_SIZE4096Maximum size of events batch before sending to ClickHouse

    Maximum size of events batch before sending to ClickHouse

  • PRISME_EVENTSTORE_MAX_BATCH_TIMEOUT1mMaximum duration before current batch is sent to event store

    Maximum duration before current batch is sent to event store

  • PRISME_GRAFANA_ORG_ID1ID of Grafana organization for resources

    ID of Grafana organization for resources

  • PRISME_GRAFANA_PASSWORDPassword of Grafana user for setup

    Password of Grafana user for setup

  • PRISME_GRAFANA_URLURL pointing to a healthy Grafana instance

    URL pointing to a healthy Grafana instance

  • PRISME_GRAFANA_USERUsername of Grafana user for setup

    Username of Grafana user for setup

  • PRISME_MODEdefaultServer mode: default (full-featured) or ingestion (lightweight event collector)

    Server mode: default (full-featured) or ingestion (lightweight event collector)

    values: default, ingestion

  • PRISME_ORIGIN_REGISTRY_ORIGINSComma-separated list of valid origins for events

    Comma-separated list of valid origins for events

  • PRISME_PORT80Web server listening TCP port

    Web server listening TCP port

  • PRISME_PROXY_HEADERX-Forwarded-ForHTTP header used to determine client IP behind proxy

    HTTP header used to determine client IP behind proxy

  • PRISME_PROXY_REQUEST_ID_HEADERX-Request-IdHTTP header used to retrieve request ID from proxy

    HTTP header used to retrieve request ID from proxy

  • PRISME_SESSIONSTORAGE_DEVICE_EXPIRY_PERCENTILE50Percentage of device sessions expired before cleanup

    Percentage of device sessions expired before cleanup

  • PRISME_SESSIONSTORAGE_GC_INTERVAL10sInterval at which expired sessions are collected

    Interval at which expired sessions are collected

  • PRISME_SESSIONSTORAGE_SESSION_INACTIVE_TTL24hMaximum time a session can remain inactive before expiring

    Maximum time a session can remain inactive before expiring

  • PRISME_TRUST_PROXYfalseWhether to trust X-Forwarded-For and other proxy headers

    Whether to trust X-Forwarded-For and other proxy headers

    values: true, false

Prisme Analytics releases & version history

FAQ

Do I need a cookie banner with Prisme Analytics?

No, Prisme is GDPR, PECR and CCPA compliant, so no cookie banner is required.

Can I cancel anytime?

Yes, you can cancel your subscription at any moment and retain access to your account and data until the end of the paid period.

Is Prisme Analytics free?

No, Prisme charges a reasonable price for the software because they don't sell user data like free analytics services do.

How long does Prisme Analytics keep my data?

Forever. Prisme never deletes customer data on any plan. Data remains available as long as you are a paying customer.

What does Prisme Analytics do with my data?

Prisme makes your data easily accessible to you and does not mine, sell, or use it for retargeting. They sell software, not data.

More in Analytics

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…