Freika /dawarich

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

★ 10,963⑂ 422👁 27⑃ 1,642● 1,622▤ 343
Download: 1.23.01.23.0 ↓1.23.02026-11-15
+12
Daily
+102
Weekly
10,963
stars
422
forks
27
watchers
1,642
prs
1,622
issues
343
releases

README

🌍 Dawarich: Your Self-Hostable Location History Tracker

English | 简体中文

 

 |  |  | 

---

 Screenshots

!Map
Map View

!Timeline
Timeline View

!Insights
Insights Page

!Family
Family Page

!Stats
Statistics Overview

!Trips
Trips page

---

 About Dawarich

If you're looking for Dawarich Cloud, where everything is managed for you, check out Dawarich Cloud.

Dawarich is a self-hostable web app designed to replace Google Timeline (aka Google Location History).
It enables you to:

- Track your location history.
- Visualize your data on an interactive map.
- Create trips and analyze your travel history.
- Share your location with family members.
- Integrate with photo management apps like Immich and Photoprism to visualize geotagged photos.
- Import your location history from Google Maps Timeline, OwnTracks, GPX, GeoJSON and some other sources
- Explore statistics like the number of countries and cities visited, total distance traveled, and more!
- Share your location with family members.

Changelog: Find the latest updates here.

Contribute: See CONTRIBUTING.md for how to contribute to Dawarich.
---

 ⚠️ Disclaimer

 Updating strategy

- DO NOT UPDATE AUTOMATICALLY: Read release notes before updating. Automatic updates may break your setup.
- Under active development: Expect frequent updates, bugs, and breaking changes.
- Do not delete your original data after importing into Dawarich.
- Backup before updates: Always backup your data before upgrading.
- Stay up-to-date: Make sure you're running the latest version for the best experience.

---

 🧭 Supported Location Tracking

You can track your location with the following apps:

- 💫 Dawarich for iOS
- 🤖 Dawarich for Android
- 🗺️ Dawarich Community (Android)
- 🌍 Overland
- 🛰️ OwnTracks
- 🧭 GPSLogger
- 📱 PhoneTrack
- 🏡 Home Assistant

Simply install one of the supported apps on your device and configure it to send location updates to your Dawarich instance.

---

 How to Start Dawarich Locally

1. Clone the repository.
2. Run the following command to start the app:
   bash
   docker compose -f docker/docker-compose.yml up
   
3. Access the app at http://localhost:3000.

To stop the app, press Ctrl+C.

You can use default values or create a .env file based on .env.example to customize your setup.

---

 How to Install Dawarich

- Docker Setup
- Synology

Default Credentials
- Username: [email protected]
- Password: safepassword
Feel free to change them in the account settings.

---

 Features

 Location Tracking
- Track your live location using one of the supported apps.

 Location History Visualization
- View your historical data on a map with customizable layers:
  - Heatmap
  - Points
  - Lines between points
  - Fog of War

 Family Sharing
- Share your location with family members.
- View locations of family members on the map (with their consent).
- Each family member can enable or disable location sharing individually.

 Places
- Save the places that matter to you, each with a visit radius, so D

Top issues

Discussions

Latest release

1.23.0 1.23.0 2026-11-15
⚠️ Upgrade notes

- Immich, Photoprism, AirTrail, TeslaMate and TREK no longer follow redirects. If an integration URL redirects, for example from http:// to https://, save the final URL in Settings → Integrations. The connection test and a notification from the background import say where the redirect points.
- The Docker image no longer contains curl, git or npm. A healthcheck or script of your own that calls curl inside the container fails after the upgrade: use wget -qO -, as the bundled compose files do.
- GET /api/v1/settings no longer returns integration API keys, and restoring an a

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON