Geoip2influx
Geoip2influx is a Python script that parses Nginx access logs and sends geolocation and request metrics to InfluxDB.
Platform availability
Available on 1 of 10 platforms
- Unraid
- TrueNAS (not listed)
- Umbrel (not listed)
- ZimaOS (not listed)
- Proxmox (not listed)
- Helm (not listed)
- Mac (not listed)
- Windows (not listed)
- Linux (not listed)
- Any server (not listed)
Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.
58/100 Fair
- Maintained
- 63last commit 122 days ago
- Popular
- 3989 GitHub stars
- Easy to install
- 351 install platform, install notes, Docker image
- Light to run
- No data
- Security check
- 95no serious findings, CI, tests
Based on 4 of 5 factors.
Availability: platform listings confirmed today, links checked 33 days ago
- GitHub stars
- 89
- Open issues
- 0
- Last commit
- 2026-07-22
- License
- MIT
- Activity
- stale
Checked 10 days ago - source: GitHub (gilbN/geoip2influx)
Resources & Compatibility
ARM (e.g. Raspberry Pi) is not supported.
Checked 54 days ago - source: Docker Hub image tags and published docs
First-install notes
- LinuxServer SWAG integration The author provides a dedicated docker mod for the LinuxServer/letsencrypt (SWAG) container; the repository README covers setup and the full environment variable list with defaults. source
Fetched 45 days ago - each note links to its source
Variants
Alternatives (12)
- Beszel - A lightweight server monitoring hub with historical data, docker stats, and alerts.
- Datadog - Datadog Agent is an on-host monitoring agent that collects metrics, logs, and traces from hosts, containers, and Kubernetes clusters and se…
- DeepFlow - Unify your cloud-native monitoring with zero-code eBPF, advanced profiling, and 10x storage efficiency.
- Kibana - Kibana is the data visualization layer for querying, analyzing, and managing data stored in Elasticsearch.
- Metabase - Metabase is a simple and powerful analytics tool which lets anyone learn and make decisions from their company’s data.
- Netdata - Netdata is a real-time performance and health monitoring solution that collects per-second metrics from your servers, containers, networks,…
- OpenSearch - OpenSearch is an open-source search and observability suite for self-hosters who need scalable indexing, analysis, and visualization of log…
- SigNoz - SigNoz is a self-hostable open-source observability platform that unifies logs, metrics, traces, alerts, and dashboards using OpenTelemetry…
- Splunk - Splunk is a self-hosted platform for collecting, indexing, searching, and analyzing log and security data, helping homelabbers and operatio…
- Tableau - Tableau helps the world’s largest organizations unleash the power of their most valuable assets: their data and their people.
- VictoriaLogs - VictoriaLogs is a high-performance, lightweight, schema-free database for logs.
- apache-superset - Apache Superset is a modern data exploration and visualization platform.
Checked 41 days ago - source: AlternativeTo
Common questions
What MaxMind settings should I configure for geoip2influx?
Set GEOIP_DB_PATH to the GeoLite2-City.mmdb file you want to use. Add MAXMINDDB_USER_ID and MAXMINDDB_LICENSE_KEY for your MaxMind account credentials.
How do I point geoip2influx at InfluxDB 2?
Set USE_INFLUXDB_V2 to true and INFLUXDB_V2_TOKEN to your InfluxDB 2 token. You can also set INFLUXDB_V2_URL, INFLUXDB_V2_ORG, INFLUXDB_V2_BUCKET, and INFLUXDB_V2_RETENTION.
Which Nginx log file does geoip2influx read?
It reads the container path in NGINX_LOG_PATH, which defaults to /config/log/nginx/access.log. Change that variable if your Nginx access log is mounted elsewhere.
Is there a setup for linuxserver/letsencrypt?
The README references a linuxserver/letsencrypt docker mod for swag-geoip2influx. That is the intended path for that Nginx container setup.
How do I enable verbose logging for geoip2influx?
Set GEOIP2INFLUX_LOG_LEVEL to debug for verbose logging. The script log path is controlled by GEOIP2INFLUX_LOG_PATH and defaults to /config/log/geoip2influx/geoip2influx.log.
Answers sourced from github.com
Community
- Nginx Logs and GEO map dashboard using Unraid (forum)
- r/selfhosted on Reddit: Dawarich — Google Location History/Google Maps ... (reddit)
Collected 48 days ago - public community threads