# GeoMetrikks

GeoMetrikks is a real-time geolocation analytics tool that tails your reverse proxy's access logs, performs GeoIP lookups, and visualizes traffic on a live interactive map with no external services required. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/2845/geometrikks

## Description

GeoMetrikks is a real-time geolocation analytics tool that tails your reverse proxy's access logs, performs GeoIP lookups, and visualizes traffic on a live interactive map with no external services required. It reads nginx, Nginx Proxy Manager, Traefik JSON, and Caddy JSON access logs (source detected per file) or ingests them from Grafana Loki. It provides a live GeoIP map with real-time request visualization, a traffic analytics dashboard with configurable date ranges including a Top ASNs view of the networks your traffic comes from, CrowdSec integration, OpenID Connect sign-in against Authelia, Authentik, Keycloak, Pocket ID, or Google, searchable access log history with filtering and sorting, a WebSocket-backed live log tail, structured application logging with a live in-UI log viewer, a fail2ban/CrowdSec-friendly login log, and downloadable rotated archives, batch import of archived logs, and multi-source ingestion so one instance can tail several files.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

68/100 (Good), based on 3 of 4 factors.
- Maintained: 100 (last commit 11 days ago)
- Popular: 44 (154 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- GitHub: https://github.com/GilbN/geometrikks
- Unraid: https://ca.unraid.net/apps/geometrikks-0679dp108y1kqx?q=geometrikks
- Official website: https://geometrikks.dev/
- Documentation: https://geometrikks.dev/docs/sources/nginx/

## Common questions

### What nginx log format does GeoMetrikks expect for reliable ingestion?

It expects a keyed JSON access log defined with the geometrikks_json format and escape=json enabled, with client_ip and timestamp as the only required keys. Without escape=json or if an empty variable is left unquoted, lines can become invalid or unparseable.

### Can GeoMetrikks tail logs from multiple reverse proxies?

Yes. Run one full instance plus lightweight agents next to each log file, or tail shipped files from one place, and every page can filter by the recording hostname.

### Does GeoMetrikks support SSO?

Yes. It supports OpenID Connect sign-in against Authelia, Authentik, Keycloak, Pocket ID, or Google.

### What outbound connections does GeoMetrikks make?

It downloads the MaxMind GeoLite2 database and, unless disabled, makes a public-IP lookup for the map's home location.

### Can GeoMetrikks import rotated or archived access logs?

It follows rotated files, and plain or gzipped archives can be backfilled through the same pipeline with one command.

### How does GeoMetrikks integrate with CrowdSec?

Connect CrowdSec's Local API so GeoMetrikks can manage IP bans next to the traffic that caused them, with a Banned IPs view when connected.

---
Source: Our Local Host (https://ourlocalhost.com/app/2845/geometrikks), the self-hosted and open-source app directory.
