freika/dawarich

★ 9,010RubyAudience · generalComplexity · 3/5Setup · moderate

Mindmap

mindmap
  root((repo))
    What it does
      Location tracking
      Interactive map
      Travel stats
    Tech stack
      Ruby
      Docker
      PostgreSQL
    Use cases
      Private timeline
      Route replay
      Family sharing
    Audience
      Privacy users
      Self-hosters

mindmap root((repo)) What it does Location tracking Interactive map Travel stats Tech stack Ruby Docker PostgreSQL Use cases Private timeline Route replay Family sharing Audience Privacy users Self-hosters

Click or tap to explore — scroll the page freely

Things people build with this

USE CASE 1

Track and visualize your personal location history on a private map you control, instead of relying on Google Timeline.

USE CASE 2

Import your Google Maps Timeline, Strava files, or GPX tracks and view them as a heatmap or route on an interactive map.

USE CASE 3

Share location history with family members on the same map, with each person controlling their own visibility.

USE CASE 4

Connect your Immich or Photoprism photo library to see travel history alongside associated photos on the map.

Tech stack

RubyDockerPostgreSQL

Getting it running

Difficulty · moderate Time to first run · 1h+

Requires a Docker-capable server and a compatible tracking app on your phone such as OwnTracks or Overland.

In plain English

Dawarich is a self-hosted web app that does what Google Timeline does: it records where you have been, shows that history on an interactive map, and lets you analyze your travel patterns. The key difference is that you run it on your own server, so your location data stays in your control instead of on an outside service. To use it, you install the app with Docker (a tool for running software in a contained environment) on a server you control, whether that is a home device, a NAS (network-attached storage device), or a cloud server. Once it is running, you configure a tracking app on your phone to send location updates to your Dawarich instance. Supported phone apps include OwnTracks, Overland, GPSLogger, and official Dawarich apps for both iOS and Android. On the map, you can display your history in several ways: as a heatmap showing where you spend the most time, as individual points, as connected lines tracing a route, or as a fog-of-war overlay that reveals areas you have visited. The statistics section breaks down countries and cities visited, total distance traveled, and time spent in each place by year and month. A trips feature lets you mark a time window as a trip and see the route, distance, and associated photos if you have an Immich or Photoprism photo library connected. You can import existing location history from Google Maps Timeline, Strava, GPX files, and photos with embedded location tags, so past history is not lost when switching from another service. Data can be exported in GeoJSON or GPX formats. A family sharing feature lets household members opt in to see each other's locations on the same map, with each person controlling their own visibility. The README includes a clear warning: do not update automatically, because new releases sometimes include breaking changes. Always read the release notes and back up your data before upgrading.

Copy-paste prompts

Prompt 1

Help me set up Dawarich with Docker Compose on my home server and configure OwnTracks on my iPhone to send location updates to it.

Prompt 2

I exported my Google Maps Timeline as a JSON file. Show me how to import it into Dawarich and display it as a heatmap.

Prompt 3

How do I enable family sharing in Dawarich so my partner and I can see each other's locations on the same map?

Prompt 4

Walk me through connecting Dawarich to my Immich photo library so my travel map shows associated photos.

Open on GitHub → Explain another repo

← freika on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.