Repolode
Submit
SamR1

SamR1/FitTrackee

A self-hosted web app for tracking outdoor workouts imported from GPX and other activity files, with data kept on your own server.

Open-source alternative to:Strava

View on GitHubWebsite
Stars
1,176
Forks
75
Open issues
1
Last commit
2 days ago

What is it?

FitTrackee is a web application for tracking outdoor activities such as running, cycling and hiking. Workouts are mainly added by importing files exported from devices or phone apps, and a workout can also be created manually without a file. Map data comes from OpenStreetMap.

The project is designed to run on your own server, so your workout data stays with you. It is built with a Flask and PostgreSQL/PostGIS backend and a Vue 3 and TypeScript frontend, and it ships with a command line interface. Packages are published on PyPI and Docker images are available.

The README notes that the project is under heavy development and some features may be unstable. Documentation covers installation, the CLI, third-party tools and troubleshooting.

Key features

  • 01Imports workouts from activity files such as GPX.
  • 02Lets you add workouts manually without a file.
  • 03Shows routes on maps using OpenStreetMap data.
  • 04Charts workout statistics with Chart.js.
  • 05Provides a command line interface for administration.
  • 06Runs on PostgreSQL with PostGIS.

Use cases

  • Keeping a private archive of cycling or running files without uploading them to a commercial service.
  • Collecting workouts exported from Android tracking apps or watch companion apps in one place.
  • Running a personal or small-group activity tracker on a home server or VPS.

Quick start

  1. 1

    Follow the installation instructions in the official documentation

Things to know

  • Under heavy development, so some features may be unstable.
  • Requires a PostgreSQL database with the PostGIS extension, which adds setup effort for self-hosting.
  • Licensed under AGPL-3.0, a copyleft license that requires derivative network services to share their source code.

In collections

Self-hosted apps

Topics

#fitness#self-hosted#gpx#outdoor-activities#workout-tracker#flask#vue3#openstreetmap#activity-tracker#chartjs

FAQ

What is FitTrackee?
A self-hosted web app for tracking outdoor workouts imported from GPX and other activity files, with data kept on your own server. FitTrackee is a web application for tracking outdoor activities such as running, cycling and hiking. Workouts are mainly added by importing files exported from devices or phone apps, and a workout can also be created manually without a file. Map data comes from OpenStreetMap.
Is FitTrackee free to use? What license does it have?
FitTrackee is open source under the AGPL-3.0 license. Check the license terms before using it in commercial products.
Is FitTrackee still maintained?
Actively maintained. The last commit to FitTrackee was on Nov 4, 2026.
What can I use FitTrackee for?
Keeping a private archive of cycling or running files without uploading them to a commercial service. Collecting workouts exported from Android tracking apps or watch companion apps in one place. Running a personal or small-group activity tracker on a home server or VPS.
How do I install FitTrackee?
Follow the installation instructions in the official documentation
Where can I get FitTrackee?
The source code and installation instructions are on GitHub: https://github.com/SamR1/FitTrackee

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects