# GeoMetrikks

> GeoMetrikks is a self-hosted, open-source service that tails reverse proxy logs, performs GeoLite2 lookups, and displays requests on a live MapLibre map with analytics.

- **Category:** Log Management
- **Licence:** MIT
- **Latest version:** v0.22.1
- **Open source:** oss
- **Languages:** Typescript, Python
- **Platforms:** Docker Compose
- **Tags:** Analytics, Dashboard, Caddy, Nginx, Security, Vite, Traefik, Docker, React, Python, Log analysis, Geoip, Postgis, Loki, Pangolin, Crowdsec, Multi host, Maplibre, Multi source, Maxmind, Openid connect, Timescaledb, Litestar, Geoip2, Geolocation Metrics, Log Metrics, Maxmind Geoip, Maplibre Gl, Agent Mode

## Description

GeoMetrikks ingests access logs from nginx, Nginx Proxy Manager, Traefik, Caddy, or Grafana Loki, enriches each request with MaxMind GeoLite2 City and ASN data, and presents the results on a real-time map and analytics dashboard. The UI includes a live map with heatmap, marker, and banned-IP views; overview and analytics dashboards with request volume, latency, bandwidth, top URLs, user agents, and ASNs; a searchable, paginated access log history with filters; geo logs grouped by location; an IP inspector with CrowdSec ban status; debug logs showing raw lines and parse failures; and a multi-source mode where lightweight agents tail logs on multiple hosts and write to a shared TimescaleDB. It integrates with CrowdSec for live ban/unban management and ban visualization. Authentication is via a single admin password or OpenID Connect (Authelia, Authentik, Keycloak, Pocket ID, Google). The app runs as a Docker image (ghcr.io/gilbn/geometrikks) for amd64 and arm64, with a docker-compose file that includes TimescaleDB. It requires a free MaxMind account for GeoLite2 downloads and optionally a free CARTO API key for map tiles. No telemetry; outbound traffic is only GeoLite2 downloads and an optional public-IP lookup for the server location.

## Links

- [Homepage](https://github.com/gilbn/geometrikks)
- [Website](https://geometrikks.dev)
- [Docker](ghcr.io/gilbn/geometrikks)
- [Documentation](https://geometrikks.dev/docs/get-started/quickstart/)
- [GitHub Repository](https://github.com/GilbN/geometrikks)
- [Releases](https://github.com/GilbN/geometrikks/releases)
- [Changelog](https://geometrikks.dev/docs/reference/changelog/)
- [FAQ](https://geometrikks.dev/docs/reference/faq/)
- [Configuration Reference](https://geometrikks.dev/docs/reference/configuration/)
- [CrowdSec Integration Docs](https://geometrikks.dev/docs/features/crowdsec/)
- [Multi-source Setup Docs](https://geometrikks.dev/docs/features/multi-source/)

---
Source: https://selfhost.directory/project/geometrikks