Home

GeoTracker documentation

GeoTracker is a self-hosted, privacy-first location timeline: one small program, one data folder, no cloud. These pages cover installing it, using it and running it.

Start here

• Getting started: pick an install method and be running in ten minutes
• Install with Docker: Docker, Docker Compose and automatic HTTPS
• Install the program: bare metal on Linux, Raspberry Pi, macOS and Windows
• HTTPS: Caddy, nginx, Traefik, Cloudflare Tunnel, Tailscale

Using GeoTracker

• Connecting phones: OwnTracks, Overland, Colota, GPSLogger, Traccar, Home Assistant
• User guide: timeline, importing Google Timeline, family, share links, photos, the installable app
• Automations: geofencing: tell family, call webhooks, Home Assistant, ntfy, Telegram, Discord, Slack

Running a server

• Configuration: environment variables, maps, offline maps, place names, email
• Administration: users, backups and restore, upgrading, moving servers, command line
• Single sign-on: OpenID Connect (Authelia, Authentik, Keycloak, …)
• Troubleshooting: symptoms and fixes
• API: REST API and ingest endpoints for scripts and apps

Contributing

• Development: build from source, layout, tests, releases

These pages live in the docs/ folder of the repository and are synced to the wiki automatically. Fix a typo with a pull request.