Deploy FitTrackee

Self-hosted outdoor activity tracker: GPX/FIT workouts, maps and stats

Deploy FitTrackee

Just deployed

/data

/data

/var/lib/postgresql

Deploy and Host FitTrackee on Railway

FitTrackee is a self-hosted, open-source outdoor activity tracker. Upload GPX, FIT, KML or TCX files from your watch or phone and get each workout on a map with distance, pace, elevation and speed charts, plus statistics, records, equipment tracking and optional sharing with other users of your instance.

About Hosting FitTrackee

FitTrackee is a Python (Flask) app that needs PostgreSQL with the PostGIS extension, somewhere to keep uploaded files, and Redis plus a Dramatiq worker for data exports, archive uploads, emails and API rate limits. This template deploys FitTrackee 1.3.8 with the web app and worker in one service sharing a volume, a PostGIS 3.7 database on PostgreSQL 18 with its own volume, and Railway's Redis. On first boot it applies database migrations and creates your owner account from the email you enter, with a generated password. Every service except Redis builds from a public GitHub repo, so version updates reach you as Railway update notices.

Common Use Cases

  • Keep a private log of runs, rides, hikes and other outdoor workouts without a commercial fitness cloud
  • Run a small tracker for a family, club or team, with followers, comments and workout visibility settings
  • Import and keep years of GPX or FIT files from different devices in one place, with statistics and personal records

Dependencies for FitTrackee Hosting

  • PostgreSQL with PostGIS (included: PostGIS 3.7 on PostgreSQL 18, built from the template repo)
  • Redis (included: Railway Redis) for the task worker and API rate limits

Deployment Dependencies

Implementation Details

You enter one value at deploy time: FITTRACKEE_ADMIN_EMAIL. Log in with that email and the generated FITTRACKEE_ADMIN_PASSWORD from the FitTrackee service's Variables tab, then change the password under your account settings.

Registration is open by default, as upstream ships it. Without email settings, new accounts stay inactive until an admin activates them (Admin > Users). To send account confirmation and password reset emails, add EMAIL_URL (for example smtp://USER:PASSWORD@smtp.example.com:587?tls=True) and SENDER_EMAIL to the FitTrackee service. Weather data needs WEATHER_API_PROVIDER=visualcrossing and WEATHER_API_KEY. If you add a custom domain, set UI_URL to https://YOUR-DOMAIN.

Uploads, exports and the static map cache live on the volume at /data. Static maps use the OpenStreetMap tile server by default; set TILE_SERVER_URL and MAP_ATTRIBUTION for another provider.

Why Deploy FitTrackee on Railway?

Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying FitTrackee on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.


Template Content

More templates in this category

View Template
Rocky Linux
Hosted Rocky Linux 9 workspace with SSH and persistent storage. 🚀

codestorm
51
View Template
Foundry Virtual Tabletop
Self-hosted virtual tabletop for role-playing games (license required)

Lucas
71
View Template
NEW
Double Commander in your browser
The Double Commander file manager in the cloud, from any device

Nermin Sabanovic
0