Skip to main content

Introduction

Colota is a self-hosted GPS tracking app for Android. It sends your location to your own server over HTTP(S), works offline, supports geofencing, and has no analytics or telemetry.

Key Features

  • Self-Hosted - Send location data to your own server. Works with Dawarich, GeoPulse, 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.
  • Offline Maps - Download map areas to your device for use without an internet connection.
  • Scheduled Export - Automatic daily, weekly or monthly exports to a local directory with file retention management.
  • 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 and automatic GPS pause when stationary.
  • 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.
  • Display Settings - Choose between metric and imperial units, 12h or 24h time format. Auto-detected from device locale on first use.
  • 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.
  • Dark Mode - Full light and dark theme support.

App Screens

Colota has sixteen screens, each focused on a specific task:

ScreenPurpose
DashboardLive map with current coordinates, tracking controls, database stats, and geofence status
SettingsGPS polling interval, distance filter, sync strategy, offline mode, accuracy threshold, unit system, time format
API ConfigEndpoint field mapping with templates for Dawarich, OwnTracks, PhoneTrack, Reitti, Traccar, or custom backends
Auth SettingsEndpoint authentication (None, Basic Auth, Bearer Token) and custom HTTP headers
GeofencesCreate, edit, and delete pause zones on an interactive map
Offline MapsDownload map areas to the device for use without an internet connection
Tracking ProfilesCreate and manage condition-based profiles that automatically adjust tracking settings
Profile EditorConfigure profile name, condition trigger, GPS interval, distance filter, sync interval, priority, and deactivation delay
Location HistoryBrowse recorded locations on a track map with calendar day picker and trip-colored segments, view segmented trips with per-trip stats
Trip DetailFull trip view with dedicated map, stats grid (distance, duration, avg speed, elevation), speed and elevation profile charts, and export
Location SummaryAggregated stats (total distance, trips, active days, avg distance) for selectable periods with daily breakdown and tap-to-inspect navigation
Export DataExport tracked locations as CSV, GeoJSON, GPX, or KML
Auto-ExportConfigure scheduled exports: format, directory, frequency, export range, and file retention
Data ManagementClear sent history, delete old data, vacuum the database
Setup ImportConfirmation screen for deep link configuration imports (colota://setup)
AboutApp version, device info, links to repository and privacy policy

Screenshots

Architecture

Colota is a monorepo with a React Native UI layer and native Kotlin modules for background tracking:

  • apps/mobile - React Native + Kotlin Android app
  • apps/docs - This documentation site (Docusaurus)
  • packages/shared - Shared theme colors, typography, and types

The native layer handles the foreground service, database, HTTP sync, geofencing, and credential storage. See the Architecture page for details.

License

Colota is licensed under the GNU Affero General Public License v3.0. All modifications must remain open source.