Privacy-first Google Timeline alternative
Own Your Location Timeline
GeoPulse turns raw GPS points into a private location timeline with stays, trips, maps, and insights, all under your control.
1.4K Stars.58 Forks
Explore GeoPulse
Real-time Source Integrations
Connect OwnTracks, Overland, Traccar, GPSLogger, Dawarich, Home Assistant, and Colota into one timeline.
- Supports HTTP and MQTT ingestion across supported trackers
- Per-source GPS filtering improves timeline quality
- Combine multiple devices/sources into a single history
Timeline workspace
Map replay, event cards, and analysis in one workspace.
Review a day as a route, inspect stays and transitions, replay movement, and jump from timeline events into places, reports, dashboard views, or data correction workflows.
Deploy your way
Start small, then scale into your preferred self-hosted setup.
Docker Compose is the fastest path for a single server. Unraid and Proxmox fit homelabs, while Kubernetes and Helm are available for charted releases and production-style operations.
mkdir geopulse && cd geopulse
curl -L -o .env \
https://raw.githubusercontent.com/tess1o/GeoPulse/main/.env.example
curl -L -o docker-compose.yml \
https://raw.githubusercontent.com/tess1o/GeoPulse/main/docker-compose.yml
docker compose up -dFAQ
Common questions before you self-host.
Short answers pulled from the documentation FAQ, with the full page available when you want more detail.
What is GeoPulse?
GeoPulse is a self-hosted location tracking and analysis platform that turns raw GPS data into timelines, trip classification, maps, and analytics while keeping your data on your own server.
What location sources are supported?
GeoPulse supports OwnTracks, Overland, Dawarich, GPSLogger, Home Assistant, Colota, and file imports such as GPX, GeoJSON, Google Timeline, CSV, and OwnTracks exports.
Can I self-host GeoPulse?
Yes. Self-hosting is the primary way to use GeoPulse, with Docker Compose for a quick start, Unraid and Proxmox for homelabs, and Kubernetes or Helm for larger deployments.
Who can see my location data?
Your location data is stored on your self-hosted server. External services are only used when you configure them, such as map tiles, reverse geocoding providers, or optional AI features.
How accurate is the timeline?
Timeline accuracy depends on GPS signal quality, tracking frequency, environment, and your timeline preferences. GeoPulse uses accuracy metrics and configurable thresholds to improve results.
What server resources does GeoPulse need?
GeoPulse is optimized to be very fast and lightweight. In typical self-hosted usage, the app usually uses about 50-100MB of memory and stays below 1% CPU outside heavier background jobs.
Documentation gateway