Skip to content

dietrichmax/colota

Repository files navigation

Colota Banner

Colota - GPS Location Tracker

Version License: AGPL v3 Lint & Test Android Build Android React Native TypeScript

Self-hosted GPS tracking app for Android.

Colota sends your location to your own server over HTTP(S). It works offline, supports geofencing, and doesn't share any data except with your backend.

Google Play | F-Droid | Documentation | Privacy Policy

Features

  • Self-Hosted - Send location data to your own server. Works with GeoPulse, Dawarich, OwnTracks, PhoneTrack, Reitti, Traccar, Home Assistant, or any custom backend.
  • Privacy First - No analytics, no telemetry, no third-party SDKs. Open source (AGPL-3.0).
  • Works Offline - Fully functional without a server. Export as CSV, GeoJSON, GPX, or KML.
  • Location History - View daily summaries, trip segmentation, calendar with activity dots, and per-trip export.
  • Reliable Tracking - Foreground service, auto-start on boot, exponential backoff retry.
  • Geofencing - Pause zones that automatically stop recording locations.
  • Tracking Profiles - Automatically adjust GPS interval, distance filter, and sync settings based on conditions like charging, car mode, or speed.
  • Flexible Sync - Instant, batch, Wi-Fi only, or offline modes.
  • Quick Setup - Configure devices via colota://setup deep links or QR codes.
  • Authentication - Basic Auth, Bearer Token, or custom headers with AES-256-GCM encryption.

Screenshots

Dashboard Location History (Map) Trip Details Trips
Dashboard Location History (Map) Trip Details Trips
Settings TrackingProfiles Authentication Dark Mode
Settings TrackingProfiles Authentication Dark Mode

Quick Start

# Install from Google Play, F-Droid, or download APK from Releases
# Then:
1. Grant location permissions (precise, all the time)
2. Disable battery optimization for Colota
3. Press Start Tracking

For full setup, server configuration, and integration guides, see the documentation.

Documentation

Full docs at colota.app covers configuration, server integration (GeoPulse, Dawarich, OwnTracks, PhoneTrack, Reitti, Traccar, Home Assistant, and custom backends), geofencing, data export, API reference, battery optimization, troubleshooting, and development setup.

Build from Source

Requirements: Node.js >= 20, Android SDK, JDK 17+

git clone https://github.com/dietrichmax/colota.git
cd colota
npm install
cd apps/mobile/android
./gradlew assembleGmsRelease    # Google Play variant
./gradlew assembleFossRelease   # F-Droid variant (no Google Play Services)

Contributing

See the Contributing Guide for details on reporting issues, submitting pull requests, and code style.

License

AGPL-3.0 - Copyright (C) 2026 Max Dietrich

Support

About

Colota - Android GPS Location tracker

Topics

Resources

License

Stars

Watchers

Forks

Sponsor this project

  •  

Packages

 
 
 

Contributors