---
title: "Deploy FitTrackee"
description: "Self-hosted outdoor activity tracker: GPX/FIT workouts, maps and stats"
category: "Other"
url: https://railway.com/deploy/fittrackee-1
---

# Deploy FitTrackee

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

**[Deploy FitTrackee on Railway](https://railway.com/template/fittrackee-1)**

Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/fittrackee-1/manifest.json

- **Creator:** Agaz Self-Host
- **Category:** Other

## Template content

### Redis https://cdn.sanity.io/images/sy1jschh/production/0ce0bfdcfbdbf69662b1116671f97c2dd788b655-157x157.svg

- **Image:** redis:8.2
- **Start command:** `/bin/sh -c "rm -rf $RAILWAY_VOLUME_MOUNT_PATH/lost+found/ && exec docker-entrypoint.sh redis-server --requirepass $REDIS_PASSWORD --save 60 1 --dir $RAILWAY_VOLUME_MOUNT_PATH"`

### FitTrackee https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/png/fittrackee.png

- **Source:** https://github.com/aalfath/fittrackee-railway-template
- **Health check:** /api/ping
- **Public domain:** Yes

### PostGIS https://raw.githubusercontent.com/postgis/postgis/master/doc/html/images/static/PostGIS_logo.png

- **Source:** https://github.com/aalfath/fittrackee-railway-template

## Documentation

# 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

* FitTrackee source and releases: https://codeberg.org/FitTrackee/FitTrackee
* FitTrackee documentation: https://docs.fittrackee.org/en/
* Template repo (Dockerfiles, start script, changelog): https://github.com/aalfath/fittrackee-railway-template
* PostGIS Docker image: https://hub.docker.com/r/postgis/postgis

### 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 &gt; 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.



## Similar templates

- [Rocky Linux](https://railway.com/deploy/rocky-linux) — Hosted Rocky Linux 9 workspace with SSH and persistent storage. 🚀
- [Foundry Virtual Tabletop](https://railway.com/deploy/X5tR6G) — Self-hosted virtual tabletop for role-playing games (license required)
- [Double Commander in your browser](https://railway.com/deploy/double-commander-in-your-browser) — The Double Commander file manager in the cloud, from any device

Open this page in a browser: https://railway.com/deploy/fittrackee-1
