FitTrackee Installation unter Debian 12

Die FitTrackee Web-Applikation befindet sich derzeit in einer intensiven Entwicklungsphase, aktuell bei Version 0.7.31. Dennoch ist die Anwendung bereits äußerst stabil und bietet eine Vielzahl Funktionen.

11 verschiedene Sportarten werden unterstützt, um den vielfältigen Interessen der Nutzer gerecht zu werden.
Das Dashboard bietet einen klaren Monatskalender zur Überwachung von Trainings und Rekorden.
Vielseitige Trainings-Erstellungsoptionen, darunter manuelle Eingabe und automatisches Hochladen von gpx-Dateien.
Interaktive Kartenansicht mit OpenStreetMap-Integration zeigt Geschwindigkeits- und Höhendiagramme.
Umfangreiche Statistiken zu Trainingsdauer, Anzahl der Einheiten, Aufstieg, Abstieg und Durchschnittsgeschwindigkeit.
Filtermöglichkeiten ermöglichen gezielte Durchsuchung der Trainingsdatenbank für individuelle Auswertungen.

Diese Funktionen machen die Web-Applikation bereits in der aktuellen Entwicklungsstufe zu einem leistungsstarken Werkzeug für die umfassende Verwaltung und Analyse von Trainingsdaten verschiedener Sportarten.

1.0 Installation

Die Basis bildet eine Debian 12 Minimalinstallation (netinstall). FitTrackee benötigt einige zusätzliche Pakete aus den Repositories, die wie folgt installiert werden:

sudo apt install -y python3-full python3-pip postgresql postgresql-client-common postgresql-client-15

1	sudo apt install -y python3-full python3-pip postgresql postgresql-client-common postgresql-client-15

Nach erfolgter Installation o.g. Pakete wird eine virtuelle Phython Umgebung für FitTrackee erstellt:

mkdir -p fittrackee/upload
cd fittrackee/
python3.11 -m venv fittrackee_venv

mkdir -p fittrackee/upload

cd fittrackee/

python3.11 -m venv fittrackee_venv

Die virtuelle Umgebung wird nun geladen / aktiviert, um mit dem pip Installer FitTrackee in der virtuellen Umgebung zu installieren:

source fittrackee_venv/bin/activate
pip install --upgrade pip
pip install fittrackee
deactivate

source fittrackee_venv/bin/activate

pip install --upgrade pip

pip install fittrackee

deactivate

Damit ist FitTrackee installiert

Zurück zur Übersicht

2.0 Konfiguration PostgreSQL Datenbank

Zuerst wird eine PostgreSQL Datenbank erstellt. Die Syntax unterscheidet sich dabei etwas von derjenigen, die man normalerweise bei SQL gewohnt ist. Um eine PostgreSQL Shell zu öffnen, kann nicht wie bei MySQL mit dem Befehl „sudo mysql“ eine Shell geöffnet werden, da das Unix Socket Plugin für PostgreSQL unter dem PostgreSQL Benutzer läuft. Direkte Eingaben aus der Bash in die PostgreSQL Shell erfolgen daher wie folgt:

sudo -u postgres psql -c "CREATE USER fittrackee WITH PASSWORD 'fittrackee';"
sudo -u postgres psql -c "CREATE SCHEMA fittrackee AUTHORIZATION fittrackee;"
sudo -u postgres psql -c "CREATE DATABASE fittrackee OWNER fittrackee;"

sudo -u postgres psql -c "CREATE USER fittrackee WITH PASSWORD 'fittrackee';"

sudo -u postgres psql -c "CREATE SCHEMA fittrackee AUTHORIZATION fittrackee;"

sudo -u postgres psql -c "CREATE DATABASE fittrackee OWNER fittrackee;"

Eine PostgreSQL Shell kann ebenfalls mittels < sudo -u postgres psql > gestartet.

Zurück zur Übersicht

2.1 Konfiguration FitTrackee

FitTrackee Konfigurationen werden durch Umgebungsvariablen festgelegt und nach dem Laden der virtuellen Umgebung mit dem source Befehl gesetzt.

source fittrackee_venv/bin/activate
source env.cfg

1 2	source fittrackee_venv/bin/activate source env.cfg

Ein grundlegendes Beispiel für die Konfiguration findet sich unter https://github.com/SamR1/FitTrackee/blob/master/.env.example. Die Konfigurationsdatei (env.cfg) muss jedoch mindestens um die oben erstellte PostgreSQL Konfiguration und, falls Verbindungen von anderen Rechnern erlaubt werden sollen, um HOST, PORT und CLIENT_PORT ergänzt werden:

  GNU nano 7.2                                                                                           env.cfg                                                                                                     
# Custom variables initialisation
# (can overwrite variables present in Makefile.config)

# Application
# export FLASK_APP=fittrackee
export FLASK_SKIP_DOTENV=1
export HOST=0.0.0.0
export PORT=5000
export CLIENT_PORT=3000
# export APP_SETTINGS=fittrackee.config.ProductionConfig
export APP_SECRET_KEY='please change me'
# export APP_WORKERS=
export APP_LOG=fittrackee.log
export UPLOAD_FOLDER=/home/user/fittrackee/upload

# PostgreSQL
export DATABASE_URL=postgresql://fittrackee:fittrackee@localhost:5432/fittrackee
# export DATABASE_DISABLE_POOLING=

# Redis (required for API rate limits and email sending)
# export REDIS_URL=

# API rate limits
# export API_RATE_LIMITS="300 per 5 minutes"

# Emails, needed for acound verification and notifications. 
# To send emails, a valid EMAIL_URL must be provided:
# with an unencrypted SMTP server: smtp://username:password@smtp.example.com:25
# with SSL: smtp://username:password@smtp.example.com:465/?ssl=True
# with STARTTLS: smtp://username:password@smtp.example.com:587/?tls=True
# CLI accound verification, adding users e.g. from commandline you can use the ftcli command:
# https://samr1.github.io/FitTrackee/en/cli.html#ftcli-users-update
export UI_URL=
export EMAIL_URL=
export SENDER_EMAIL=
# export WORKERS_PROCESSES=

# Workouts
# export TILE_SERVER_URL=
# export STATICMAP_SUBDOMAINS=
# export MAP_ATTRIBUTION=
# export DEFAULT_STATICMAP=False

# Weather
# available weather API providers: visualcrossing
# export WEATHER_API_PROVIDER=visualcrossing
# export WEATHER_API_KEY=<API_KEY shown when you klick on the accound button after login on visualcrossing webpage>

GNU nano 7.2 env.cfg

# Custom variables initialisation

# (can overwrite variables present in Makefile.config)

# Application

# export FLASK_APP=fittrackee

export FLASK_SKIP_DOTENV=1

export HOST=0.0.0.0

export PORT=5000

export CLIENT_PORT=3000

# export APP_SETTINGS=fittrackee.config.ProductionConfig

export APP_SECRET_KEY='please change me'

# export APP_WORKERS=

export APP_LOG=fittrackee.log

export UPLOAD_FOLDER=/home/user/fittrackee/upload

# PostgreSQL

export DATABASE_URL=postgresql://fittrackee:fittrackee@localhost:5432/fittrackee

# export DATABASE_DISABLE_POOLING=

# Redis (required for API rate limits and email sending)

# export REDIS_URL=

# API rate limits

# export API_RATE_LIMITS="300 per 5 minutes"

# Emails, needed for acound verification and notifications.

# To send emails, a valid EMAIL_URL must be provided:

# with an unencrypted SMTP server: smtp://username:password@smtp.example.com:25

# with SSL: smtp://username:password@smtp.example.com:465/?ssl=True

# with STARTTLS: smtp://username:password@smtp.example.com:587/?tls=True

# CLI accound verification, adding users e.g. from commandline you can use the ftcli command:

# https://samr1.github.io/FitTrackee/en/cli.html#ftcli-users-update

export UI_URL=

export EMAIL_URL=

export SENDER_EMAIL=

# export WORKERS_PROCESSES=

# Workouts

# export TILE_SERVER_URL=

# export STATICMAP_SUBDOMAINS=

# export MAP_ATTRIBUTION=

# export DEFAULT_STATICMAP=False

# Weather

# available weather API providers: visualcrossing

# export WEATHER_API_PROVIDER=visualcrossing

# export WEATHER_API_KEY=<API_KEY shown when you klick on the accound button after login on visualcrossing webpage>

Damit ist die grundlegende FitTrackee Konfiguration erstellt. E-Mail und Redis Unterstürzung folgen bald.

Zurück zur Übersicht

2.2 Erweiterte Konfiguration

In der Fittrackee WebApp kann die Dateigröße für GPX und ZIP Datei Uploads sowie die maximal zulässigen Dateien innerhalb der Zip Datei festgelegt werden

Zurück zur Übersicht

3.0 Benutzerverwaltung

Ist FittTrackee ohne Redis /E-Mail Funktion installiert besteht die Möglichkeit Accound Erstellungen und Verifizierungen mittels des CLI Tools < ftcli > zu realisieren.
Ein Admin Acount wird wie folgt erstellt:

ftcli users create admin --email admin@root.net --password adminPassword
ftcli users update admin --set-admin true

1 2	ftcli users create admin --email admin@root.net --password adminPassword ftcli users update admin --set-admin true

Zurück zur Übersicht

by Speefak | Github.io | reintech.io | astrid-guenther.de

2 thoughts on “FitTrackee Installation unter Debian 12”

José Alberto sagt:
10. April 2024 um 5:43 Uhr
Hallo, vielen Dank für Ihr Wissen, fittrackee von einer virtuellen Maschine aus zu installieren. Ich bin Ihren Schritten gefolgt, kann jedoch den Benutzernamen und das Passwort des D12-FitTrackee-Benutzers nicht finden und es ist mir nicht möglich, zu bestätigen, dass der Dienst gestartet wurde. Könnten Sie mir den Benutzernamen und das Passwort geben? Nun, der Benutzer ist Benutzer, wie ich im Video sehen kann, aber ich kenne das Passwort nicht. Ich habe es mit Benutzer und Fittrackee versucht, aber es hat nicht funktioniert, danke und Entschuldigung für mein Deutsch, Grüße aus Mexiko
Antworten
1. speefak sagt:
  16. April 2024 um 16:23 Uhr
  REAR image updated.Logins => https://github.com/speefak/fittrackee_installer.sh/tree/main
  Antworten