Freika / dawarich

# 🌍 Dawarich: Your Self-Hostable Location History Tracker
English | 简体中文
 | | | 
---
## Screenshots
*Map View*
*Timeline View*
*Insights Page*
*Family Page*
*Statistics Overview*
*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:
 [code] 
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**: `demo@dawarich.app`
- **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.
### Areas
- Draw areas on the map so Dawarich could suggest your visits there.
### Visits (Beta)
- Dawarich can sugge