{"id":7153,"date":"2024-02-20T12:10:00","date_gmt":"2024-02-20T11:10:00","guid":{"rendered":"https:\/\/speefak.spdns.de\/oss_lifestyle\/?p=7153"},"modified":"2024-06-02T20:00:07","modified_gmt":"2024-06-02T18:00:07","slug":"fittrackee-installation-unter-debian-12","status":"publish","type":"post","link":"https:\/\/speefak.spdns.de\/oss_lifestyle\/fittrackee-installation-unter-debian-12\/","title":{"rendered":"FitTrackee Installation unter Debian 12"},"content":{"rendered":"<p>Die FitTrackee Web-Applikation befindet sich derzeit in einer intensiven Entwicklungsphase, aktuell bei Version 0.7.31. Dennoch ist die Anwendung bereits \u00e4u\u00dferst stabil und bietet eine Vielzahl Funktionen.<\/p>\n<ul>\n<li>11 verschiedene Sportarten werden unterst\u00fctzt, um den vielf\u00e4ltigen Interessen der Nutzer gerecht zu werden.<\/li>\n<li>Das Dashboard bietet einen klaren Monatskalender zur \u00dcberwachung von Trainings und Rekorden.<\/li>\n<li>Vielseitige Trainings-Erstellungsoptionen, darunter manuelle Eingabe und automatisches Hochladen von gpx-Dateien.<\/li>\n<li>Interaktive Kartenansicht mit OpenStreetMap-Integration zeigt Geschwindigkeits- und H\u00f6hendiagramme.<\/li>\n<li>Umfangreiche Statistiken zu Trainingsdauer, Anzahl der Einheiten, Aufstieg, Abstieg und Durchschnittsgeschwindigkeit.<\/li>\n<li>Filterm\u00f6glichkeiten erm\u00f6glichen gezielte Durchsuchung der Trainingsdatenbank f\u00fcr individuelle Auswertungen.<\/li>\n<\/ul>\n<p><a id=\"overview\"><\/a><br \/>\nDiese Funktionen machen die Web-Applikation bereits in der aktuellen Entwicklungsstufe zu einem leistungsstarken Werkzeug f\u00fcr die umfassende Verwaltung und Analyse von Trainingsdaten verschiedener Sportarten.<\/p>\n<hr \/>\n<ul>\n<li style=\"list-style-type: none;\">\n<ul>\n<li><a href=\"#Installation\">1.0 Installation<\/a><\/li>\n<li><a href=\"https:\/\/github.com\/speefak\/fittrackee_installer.sh\" target=\"_blank\" rel=\"noopener\">1.1 Installationsskript incl Basis Konfiguration<\/a><\/li>\n<li><a href=\"#Konfiguration Datenbank\">2.0 Konfiguration Datenbank<\/a><\/li>\n<li><a href=\"#Konfiguration FitTrackee\">2.1 Konfiguration FitTrackee<\/a><\/li>\n<li><a href=\"#Erweiterte Konfiguration\">2.2 Erweiterte Konfiguration<\/a><\/li>\n<li><a href=\"#Benutzerverwaltung\">3.0 Benutzerverwaltung<\/a><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<hr \/>\n<h2 id=\"Installation\">1.0 Installation<\/h2>\n<p>Die Basis bildet eine Debian 12 Minimalinstallation (netinstall). FitTrackee ben\u00f6tigt einige zus\u00e4tzliche Pakete aus den Repositories, die wie folgt installiert werden:<\/p>\n<pre class=\"lang:default decode:true\">sudo apt install -y python3-full python3-pip postgresql postgresql-client-common postgresql-client-15<\/pre>\n<p>Nach erfolgter Installation o.g. Pakete wird eine virtuelle Phython Umgebung f\u00fcr FitTrackee erstellt:<\/p>\n<pre class=\"lang:default decode:true\">mkdir -p fittrackee\/upload\r\ncd fittrackee\/\r\npython3.11 -m venv fittrackee_venv<\/pre>\n<p>Die virtuelle Umgebung wird nun geladen \/ aktiviert, um mit dem pip Installer FitTrackee in der virtuellen Umgebung zu installieren:<\/p>\n<pre class=\"lang:default decode:true\">source fittrackee_venv\/bin\/activate\r\npip install --upgrade pip\r\npip install fittrackee\r\ndeactivate<\/pre>\n<p>Damit ist FitTrackee installiert<\/p>\n<hr \/>\n<p style=\"text-align: center;\"><strong><em><a href=\"#overview\">Zur\u00fcc<\/a><\/em><\/strong><strong><em><a href=\"#overview\">k<\/a><\/em><\/strong><strong><em><a href=\"#overview\"> zur \u00dcbersicht<\/a><\/em><\/strong><\/p>\n<hr \/>\n<h2 id=\"Konfiguration Datenbank\">2.0 Konfiguration PostgreSQL Datenbank<span style=\"text-decoration: underline;\"><br \/>\n<\/span><\/h2>\n<p>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 \u00f6ffnen, kann nicht wie bei MySQL mit dem Befehl &#8220;sudo mysql&#8221; eine Shell ge\u00f6ffnet werden, da das Unix Socket Plugin f\u00fcr PostgreSQL unter dem PostgreSQL Benutzer l\u00e4uft. Direkte Eingaben aus der Bash in die PostgreSQL Shell erfolgen daher wie folgt:<\/p>\n<pre class=\"lang:default decode:true\">sudo -u postgres psql -c \"CREATE USER fittrackee WITH PASSWORD 'fittrackee';\"\r\nsudo -u postgres psql -c \"CREATE SCHEMA fittrackee AUTHORIZATION fittrackee;\"\r\nsudo -u postgres psql -c \"CREATE DATABASE fittrackee OWNER fittrackee;\"\r\n<\/pre>\n<p>Eine PostgreSQL Shell kann ebenfalls mittels &lt; sudo -u postgres psql &gt; gestartet.<\/p>\n<hr \/>\n<p style=\"text-align: center;\"><strong><em><a href=\"#overview\">Zur\u00fcck zur \u00dcbersicht<\/a><\/em><\/strong><\/p>\n<hr \/>\n<h2 id=\"Konfiguration FitTrackee\">2.1 Konfiguration FitTrackee<\/h2>\n<p>FitTrackee Konfigurationen werden durch Umgebungsvariablen festgelegt und nach dem Laden der virtuellen Umgebung mit dem source Befehl gesetzt.<\/p>\n<pre class=\"lang:default decode:true\">source fittrackee_venv\/bin\/activate\r\nsource env.cfg<\/pre>\n<p>Ein grundlegendes Beispiel f\u00fcr 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\u00e4nzt werden:<\/p>\n<pre class=\"lang:default decode:true \">  GNU nano 7.2                                                                                           env.cfg                                                                                                     \r\n# Custom variables initialisation\r\n# (can overwrite variables present in Makefile.config)\r\n\r\n# Application\r\n# export FLASK_APP=fittrackee\r\nexport FLASK_SKIP_DOTENV=1\r\nexport HOST=0.0.0.0\r\nexport PORT=5000\r\nexport CLIENT_PORT=3000\r\n# export APP_SETTINGS=fittrackee.config.ProductionConfig\r\nexport APP_SECRET_KEY='please change me'\r\n# export APP_WORKERS=\r\nexport APP_LOG=fittrackee.log\r\nexport UPLOAD_FOLDER=\/home\/user\/fittrackee\/upload\r\n\r\n# PostgreSQL\r\nexport DATABASE_URL=postgresql:\/\/fittrackee:fittrackee@localhost:5432\/fittrackee\r\n# export DATABASE_DISABLE_POOLING=\r\n\r\n# Redis (required for API rate limits and email sending)\r\n# export REDIS_URL=\r\n\r\n# API rate limits\r\n# export API_RATE_LIMITS=\"300 per 5 minutes\"\r\n\r\n# Emails, needed for acound verification and notifications. \r\n# To send emails, a valid EMAIL_URL must be provided:\r\n# with an unencrypted SMTP server: smtp:\/\/username:password@smtp.example.com:25\r\n# with SSL: smtp:\/\/username:password@smtp.example.com:465\/?ssl=True\r\n# with STARTTLS: smtp:\/\/username:password@smtp.example.com:587\/?tls=True\r\n# CLI accound verification, adding users e.g. from commandline you can use the ftcli command:\r\n# https:\/\/samr1.github.io\/FitTrackee\/en\/cli.html#ftcli-users-update\r\nexport UI_URL=\r\nexport EMAIL_URL=\r\nexport SENDER_EMAIL=\r\n# export WORKERS_PROCESSES=\r\n\r\n# Workouts\r\n# export TILE_SERVER_URL=\r\n# export STATICMAP_SUBDOMAINS=\r\n# export MAP_ATTRIBUTION=\r\n# export DEFAULT_STATICMAP=False\r\n\r\n# Weather\r\n# available weather API providers: visualcrossing\r\n# export WEATHER_API_PROVIDER=visualcrossing\r\n# export WEATHER_API_KEY=&lt;API_KEY shown when you klick on the accound button after login on visualcrossing webpage&gt;\r\n<\/pre>\n<p>Damit ist die grundlegende FitTrackee Konfiguration erstellt. E-Mail und Redis Unterst\u00fcrzung folgen bald.<\/p>\n<hr \/>\n<p style=\"text-align: center;\"><strong><em><a href=\"#overview\">Zur\u00fcck zur \u00dcbersicht<\/a><\/em><\/strong><\/p>\n<hr \/>\n<h2 id=\"Erweiterte Konfiguration\">2.2 Erweiterte Konfiguration<\/h2>\n<p>In der Fittrackee WebApp kann die Dateigr\u00f6\u00dfe f\u00fcr GPX und ZIP Datei Uploads sowie die maximal zul\u00e4ssigen Dateien innerhalb der Zip Datei festgelegt werden<\/p>\n<p><img decoding=\"async\" class=\"aligncenter\" src=\"https:\/\/speefak.spdns.de\/oss_lifestyle\/wp-content\/uploads\/2024\/02\/FitTrackee_Menu_Config_1.gif\" \/><\/p>\n<p>&nbsp;<\/p>\n<hr \/>\n<p style=\"text-align: center;\"><strong><em><a href=\"#overview\">Zur\u00fcck zur \u00dcbersicht<\/a><\/em><\/strong><\/p>\n<hr \/>\n<h2 id=\"Benutzerverwaltung\">3.0 Benutzerverwaltung<\/h2>\n<p>Ist FittTrackee ohne Redis \/E-Mail Funktion installiert besteht die M\u00f6glichkeit Accound Erstellungen und Verifizierungen mittels des CLI Tools\u00a0 &lt; ftcli &gt; zu realisieren.<br \/>\nEin Admin Acount wird wie folgt erstellt:<\/p>\n<pre class=\"lang:default decode:true\">ftcli users create admin --email admin@root.net --password adminPassword\r\nftcli users update admin --set-admin true<\/pre>\n<hr \/>\n<p style=\"text-align: center;\"><strong><em><a href=\"#overview\">Zur\u00fcck zur \u00dcbersicht<\/a><\/em><\/strong><\/p>\n<hr \/>\n<p><img loading=\"lazy\" decoding=\"async\" class=\" wp-image-2821 alignleft\" src=\"https:\/\/speefak.spdns.de\/oss_lifestyle\/wp-content\/uploads\/2014\/08\/CC_BY_NC_SA.png\" alt=\"CC_BY_NC_SA\" width=\"65\" height=\"23\" \/><span style=\"font-size: 10pt;\">by Speefak <span style=\"font-size: 8pt;\">| <a href=\"https:\/\/samr1.github.io\/FitTrackee\/en\/index.html\" target=\"_blank\" rel=\"noopener\">Github.io<\/a> |\u00a0 <a href=\"https:\/\/reintech.io\/blog\/installing-postgresql-on-debian-12-for-beginners\" target=\"_blank\" rel=\"noopener\">reintech.io<\/a> | <a href=\"https:\/\/astrid-guenther.de\/fittrackee-uberspace-installation\/#fittrackee-installieren-und-virtuelle-umgebung-f%C3%BCr-python-einrichten\" target=\"_blank\" rel=\"noopener\">astrid-guenther.de<\/a><br \/>\n<\/span><\/span><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Die FitTrackee Web-Applikation befindet sich derzeit in einer intensiven Entwicklungsphase, aktuell bei Version 0.7.31. Dennoch ist die Anwendung bereits \u00e4u\u00dferst stabil und bietet eine Vielzahl Funktionen. 11 verschiedene Sportarten werden unterst\u00fctzt, um den vielf\u00e4ltigen Interessen der Nutzer gerecht zu werden. Das Dashboard bietet einen klaren Monatskalender zur \u00dcberwachung von Trainings und Rekorden. Vielseitige Trainings-Erstellungsoptionen, darunter [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[8],"tags":[83,84],"class_list":["post-7153","post","type-post","status-publish","format-standard","hentry","category-anleitungen","tag-fittracke","tag-sporttracker"],"rttpg_featured_image_url":null,"rttpg_author":{"display_name":"speefak","author_link":"https:\/\/speefak.spdns.de\/oss_lifestyle\/author\/speefak_oss\/"},"rttpg_comment":2,"rttpg_category":"<a href=\"https:\/\/speefak.spdns.de\/oss_lifestyle\/category\/anleitungen\/\" rel=\"category tag\">Anleitungen<\/a>","rttpg_excerpt":"Die FitTrackee Web-Applikation befindet sich derzeit in einer intensiven Entwicklungsphase, aktuell bei Version 0.7.31. Dennoch ist die Anwendung bereits \u00e4u\u00dferst stabil und bietet eine Vielzahl Funktionen. 11 verschiedene Sportarten werden unterst\u00fctzt, um den vielf\u00e4ltigen Interessen der Nutzer gerecht zu werden. Das Dashboard bietet einen klaren Monatskalender zur \u00dcberwachung von Trainings und Rekorden. Vielseitige Trainings-Erstellungsoptionen, darunter&hellip;","_links":{"self":[{"href":"https:\/\/speefak.spdns.de\/oss_lifestyle\/wp-json\/wp\/v2\/posts\/7153","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/speefak.spdns.de\/oss_lifestyle\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/speefak.spdns.de\/oss_lifestyle\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/speefak.spdns.de\/oss_lifestyle\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/speefak.spdns.de\/oss_lifestyle\/wp-json\/wp\/v2\/comments?post=7153"}],"version-history":[{"count":0,"href":"https:\/\/speefak.spdns.de\/oss_lifestyle\/wp-json\/wp\/v2\/posts\/7153\/revisions"}],"wp:attachment":[{"href":"https:\/\/speefak.spdns.de\/oss_lifestyle\/wp-json\/wp\/v2\/media?parent=7153"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/speefak.spdns.de\/oss_lifestyle\/wp-json\/wp\/v2\/categories?post=7153"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/speefak.spdns.de\/oss_lifestyle\/wp-json\/wp\/v2\/tags?post=7153"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}