About this project

PoeticMetric is a free‑as‑in‑freedom analytics solution designed with privacy, transparency, and performance in mind. Unlike traditional analytics services, it does not set cookies, does not track personal identifiers, and therefore avoids the need for consent banners. This makes it fully compliant with major data‑protection regulations such as GDPR, CCPA, PECR and Turkey’s KVKK. Key capabilities: - Real‑time visitor statistics, page views, referrers, devices, browsers, and geographic data. - Automatic aggregation of data without storing raw personal information. - Fast query engine built for high‑traffic sites; the UI updates instantly. - Exportable reports and dashboards for deeper analysis. - Role‑based access control for teams. Deployment options: 1. **Managed service** – Sign up at poeticmetric.com and start tracking immediately without any infrastructure work. 2. **Self‑hosted** – The entire stack is open source under the AGPL‑3.0 license. Official Docker images are provided, along with a sample Docker‑Compose file and configuration guide. You can run it on any server that supports Docker, integrate it behind a reverse proxy, and connect it to your own PostgreSQL database. Installation (self‑hosted) typically involves: - Pulling the Docker images (`docker pull poeticmetric/app` and `docker pull poeticmetric/db`). - Creating a `.env` file with database credentials and a secret key. - Running `docker compose up -d` to launch the web UI, API, and background workers. - Accessing the UI at `http://your‑domain` to create an admin account and start tracking. Privacy & compliance: - No IP addresses, cookies, or fingerprinting data are stored. - All collected metrics are anonymized at ingestion. - Users can delete all their data with a single click. Community & licensing: - The project is hosted on Forgejo and mirrored on GitHub. Contributions are welcome via pull requests. - Licensed under AGPL‑3.0, ensuring that any modifications that are deployed publicly must also be shared. PoeticMetric aims to give website owners a sustainable, privacy‑respecting alternative to commercial analytics platforms while providing the insights needed to improve site performance.