tess1o/geopulse

A self-hosted, privacy-first location timeline platform: an open-source alternative to Google Timeline with automatic trip detection, Immich integration, and rich analytics.

Java

1,438

956 commits

updated Oct 14, 2026

geopulse.cc

See the code

README

GeoPulse

The self-hosted, source-available Google Timeline alternative.

GeoPulse transforms raw GPS data from OwnTracks, Overland, Dawarich, GPSLogger, Home Assistant, Traccar, Colota and other sources into a searchable timeline of stays, trips, and movement patterns. It runs fully on your own infrastructure and integrates with Immich, Memos, and Weather so photos, notes, and conditions appear directly on your map history.

GeoPulse Timeline with route map and stay and trip cards

Comprehensive timeline visualization with automatic trip classification.

Quick installation

# Create directory and download config
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

# Start
docker compose up -d

Access: http://localhost:5555
Note: For production, review your .env for security-related settings first.

Need MQTT support for OwnTracks, Kubernetes, Unraid, Proxmox or bare-metal installation? See the deployment options.

Why GeoPulse

Self-hosted, no telemetry: Your location data remains on your own infrastructure.
Open ecosystem: Works with popular GPS apps (OwnTracks, Overland, GPSLogger, Home Assistant, Colota, Traccar) and tools like Immich, Memos, and Weather.
Full data ownership: Import historical data and export your data in standard formats anytime.
Lightweight runtime: Typically under 100MB RAM and under 1% CPU in regular usage.
Accessible & Localized: Currently available in English and Ukrainian, ensuring an inclusive experience across different regions.

Features

Timeline & Analysis

Smart Detection: Automatically converts GPS points into stays, trips, and data gaps.
Custom Logic: Fully configurable detection sensitivity and travel mode classification.
Deep Insights: Analytics for distance, visit frequency, and movement patterns over time.
Map Matching: Valhalla-backed route refinement makes noisy trip paths follow roads and paths while raw GPS remains authoritative.
Panoramax: Optional public street-level imagery coverage and photo viewing on Timeline maps.
Immich Integration: Photos from your library appear directly on your map timeline.
Memos Integration: Timestamped notes from Memos can appear alongside your timeline.
Weather Integration: Current weather enrichment is enabled by default for trips, stays, map layers, and journey insights; historical backfill is admin opt-in. See Weather processing architecture.

Sources & Syncing

Real-time Tracking: Supports OwnTracks (HTTP/MQTT), Overland, GPSLogger, Home Assistant, Traccar, Dawarich or Colota.
Universal Import: Bulk import from Google Timeline, GPX, GeoJSON, OwnTracks exports, and CSV.

AI Chat & MCP

AI Chat: Bring your own OpenAI-compatible key for AI-assisted insights.
MCP Server: Read-only, API-token-authenticated tools for AI clients to query their timeline and permitted friend data.

Sharing & Privacy

Friends System: Per-user visibility controls for live location and history.
Guest Access: Shareable links with optional password protection and instant revocation.
Multi-user Ready: Built-in invitations, roles, and admin audit logs.
Enterprise Auth: OIDC/SSO support alongside standard username/password login.

Platform & Performance

Lightweight: Typically under 100MB RAM and 1% CPU usage.
Self-Sovereign: No telemetry, no analytics beacons, and no third-party tracking.
Data Freedom: Full data export and per-account deletion support.
Backup & Restore: Encrypted, password-protected full backups with manual restore and scheduled automatic backups.

📸 Feature Tour

Timeline & route replay _{Stays, trips, and data gaps with travel modes, weather, and step-by-step trip replay.}
Location Analytics _{Explore every visit by map, city, and country.}
Dashboard _{Selected period, 7-day, and 30-day overviews with charts, top places, and route stats.}	Rewind _{Monthly and yearly summaries of distance, trips, highlights, and heatmaps.}
Journey Insights _{Countries, cities, time patterns, weather, milestones, and badges.}	City details _{Visit overview, top places, and every visit in a city.}
Trip Plans _{Plan stops with travel modes and routed legs, then compare the plan with what you actually visited.}
Location Sources _{Connect OwnTracks, Overland, GPSLogger, Home Assistant, Traccar, Dawarich, or Colota.}	GPS Data _{Inspect, filter, and export raw location points.}
Export & Import _{Full backups and GPX, GeoJSON, OwnTracks, or CSV exports with a date range.}	Personal Settings _{Language, time zone, units, map appearance, and connected apps.}
Administration _{Instance health, usage, users, backups, and audit logs.}	System Settings _{Authentication, geocoding, weather, map matching, and more without restarts.}
Mobile _{The web app works on phones and installs as a PWA.}

Deployment Options

Choose the installation path that matches your environment:

Installation type	Best for	Guide
Docker Compose	Fastest path for local and single-server use	Docker Compose Guide
Unraid	Unraid NAS and homelab servers using Docker Compose	Unraid Guide
Proxmox VE LXC	Proxmox homelabs and VM hosts that prefer LXC containers	Proxmox VE LXC Guide
Kubernetes / Helm	Managed clusters and production Kubernetes environments	Kubernetes Quick Install
Helm values reference	Advanced Helm customization	Helm Values Reference
Manual installation	Bare metal servers or VMs without Docker/Kubernetes	Manual Installation Guide
Environment configuration	Reviewing all runtime settings	Environment Variables Reference

Kubernetes / Helm Quick Install

helm repo add geopulse https://tess1o.github.io/geopulse/charts
helm repo update
helm install my-geopulse geopulse/geopulse

Or install the signed OCI chart from GHCR: helm install my-geopulse oci://ghcr.io/tess1o/charts/geopulse

Post-deployment steps:

Create the first account to become admin automatically, or set GEOPULSE_ADMIN_EMAIL for an explicit admin email.
Finish setup in the Admin Panel.
See Initial Setup Guide for more.

📖 Docs & Next Steps

New users: Quick Start Guide
GPS setup: GPS Sources Overview
Deployment: Docker | Unraid | Proxmox | Kubernetes | Manual | Env Variables
Administration: Admin Panel | OIDC/SSO
Maintenance: Backup & Restore | Updating
Full documentation: Documentation Portal

📜 License & Commercial Use

GeoPulse is licensed under the Business Source License 1.1 (BSL 1.1).

Free for personal, educational, and non-commercial use.
Commercial use requires a separate commercial license.

See LICENSE for full terms.
For commercial licensing: kerriden1@gmail.com

gps-tracker

gps-tracking

java

owntracks

postgis

postgis-database

postgres

privacy

quarkus

quarkus-native

self-hosted

timeline

Significant stargazers

Leonard

409 followers · starred Jul 2026

Gabriel Ostrolucký

122 followers · starred Oct 2025

Kasper Kondzielski

93 followers · starred Nov 2025

Filippo Giunchedi

133 followers · starred Jul 2026

Similar repos

Freika/dawarich

Your favorite self-hostable alternative to Google Timeline (Google Location History)

10,671

dedicatedcode/reitti

Reitti is a comprehensive personal location tracking and analysis application that helps you…

2,664

seanmorley15/AdventureLog

Self-hostable travel tracker and trip planner.

3,803

mindalyze-com/mtl-explorer

MTL Explorer: a self-hosted GPS track explorer for maps, stats, filtering, route planning, and…

open-wanderer/wanderer

wanderer is a self-hosted trail database. Save your adventures!

3,998

liketrek/TREK

A self-hosted travel/trip planner with real-time collaboration, interactive maps, PWA support, SSO,…

14,787

itskovacs/trip

🗺️ Minimalist POI Map Tracker and Trip Planner. Self-hosted.

1,953

lordmaa/headwind