Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
services:obsolete:fittrackee [2025/05/20 12:23] – willy | services:obsolete:fittrackee [2025/05/21 08:21] (current) – external edit 127.0.0.1 | ||
---|---|---|---|
Line 2: | Line 2: | ||
[[https:// | [[https:// | ||
+ | |||
+ | The main factor that made me abandon FitTrackee in favor of [[services: | ||
===== Installation ===== | ===== Installation ===== | ||
Line 7: | Line 9: | ||
Detailed instructions can be found [[https:// | Detailed instructions can be found [[https:// | ||
- | For historical reasons, i will keep the original non containerized installation instructions | + | For historical reasons, i will keep the original non containerized installation instructions |
As usual, create the dedicated user: | As usual, create the dedicated user: | ||
Line 18: | Line 20: | ||
uploads will be stored under **/ | uploads will be stored under **/ | ||
- | === using containers === | + | === Using containers === |
Download the example docker-compose.yml from [[https:// | Download the example docker-compose.yml from [[https:// | ||
Line 79: | Line 81: | ||
</ | </ | ||
- | To start FitTrackee see the autostart script below. | + | Now start the stuff: |
+ | <code bash> | ||
+ | podman compose up | ||
+ | </ | ||
+ | |||
+ | you might have to stop and start again, since the first start of the database takes some time and the main app might crash. Just wait for the database to be up and running, then restart. | ||
=== Without using containers === | === Without using containers === | ||
Line 140: | Line 147: | ||
<file - fittrackee.conf> | <file - fittrackee.conf> | ||
server { | server { | ||
- | server_name train.gardiol.org; | + | server_name train.mydomain.com; |
listen 443 ssl; | listen 443 ssl; | ||
listen 8443 ssl; | listen 8443 ssl; | ||
- | access_log / | + | access_log / |
- | error_log / | + | error_log / |
location / { | location / { | ||
Line 158: | Line 165: | ||
client_max_body_size 100M; | client_max_body_size 100M; | ||
- | include | + | include |
} | } | ||
</ | </ | ||
- | ===== Autostart ===== | + | ===== Autostart |
+ | |||
+ | To start it, and set it up on boot, as usual follow my indications [[gentoo: | ||
+ | < | ||
+ | ln -s / | ||
+ | </ | ||
+ | |||
+ | and create the following config file: | ||
+ | <file - / | ||
+ | USER=fittrackee | ||
+ | DESCRIPTION=" | ||
+ | </ | ||
+ | |||
+ | Add the service to the default runlevel and start it now: | ||
+ | <code bash> | ||
+ | rc-update add user-containers.fittrackee default | ||
+ | rc-service user-containers.fittrackee start | ||
+ | </ | ||
+ | |||
+ | ===== Autostart without containers | ||
Since i use OpenRC, simply drop the following script to / | Since i use OpenRC, simply drop the following script to / | ||
Line 203: | Line 229: | ||
===== User management ===== | ===== User management ===== | ||
- | If you do not require generating | + | You can create users from the web UI, but users will be disabled. I suggest |
+ | |||
+ | To run the CLI (container installation): | ||
+ | <code bash> | ||
+ | podman compose exec fittrackee ftcli users update < | ||
+ | </ | ||
+ | |||
+ | To run the CLI (without container installation): | ||
+ | <code bash> | ||
+ | ftcli users update < | ||
+ | </ | ||
+ | |||
+ | To create | ||
<code bash> | <code bash> | ||
ftcli users create --password < | ftcli users create --password < | ||
+ | </ | ||
+ | |||
+ | To set an user as admin: | ||
+ | <code bash> | ||
ftcli users update myuser --set-admin true | ftcli users update myuser --set-admin true | ||
</ | </ | ||
- | and then disable user registration from the admin panel in theweb | + | You can also disable user registration from the admin panel in the web GUI, set the number of active users to a fixed quantity instead of zero. |
===== Log rotation ===== | ===== Log rotation ===== | ||
Line 215: | Line 257: | ||
If you use **logrotate** (you should), create a new file under **/ | If you use **logrotate** (you should), create a new file under **/ | ||
<file - fittrackee> | <file - fittrackee> | ||
- | /data/daemons/ | + | /var/log/ |
missingok | missingok | ||
notifempty | notifempty | ||
Line 225: | Line 267: | ||
Work in progress. | Work in progress. | ||
- | ===== Updates ===== | + | ===== Updates |
Stop the service, then run, as **fitrackee** user: | Stop the service, then run, as **fitrackee** user: | ||
Line 236: | Line 278: | ||
Also note, if you installed the Garmin bridge, that you might want to run again that installation command as well. | Also note, if you installed the Garmin bridge, that you might want to run again that installation command as well. | ||
+ | |||
===== Garmin Integration ===== | ===== Garmin Integration ===== | ||
A Garmin bridge for FitTrackee exist [[https:// | A Garmin bridge for FitTrackee exist [[https:// | ||
+ | |||
+ | There is no containerized version, so you need to install on bare metal. | ||
+ | |||
+ | ===== setup for container-based Fittrackee installation | ||
+ | |||
+ | Garmin integration uses Python, so check out [[gentoo: | ||
+ | |||
+ | Only if you have done a Fittrackee containerized installation, | ||
+ | <code bash> | ||
+ | python -m venv venv_ft | ||
+ | source venv_ft/ | ||
+ | </ | ||
+ | |||
+ | and enable it in fittrackee' | ||
+ | <file - .bashrc> | ||
+ | (only last lines shown) | ||
+ | export PATH=$PATH: | ||
+ | source venv_ft/ | ||
+ | source .env | ||
+ | </ | ||
+ | |||
+ | ===== bridge installation | ||
First of all, as the same **fittrackee** user, install the bridge: | First of all, as the same **fittrackee** user, install the bridge: | ||
Line 246: | Line 311: | ||
</ | </ | ||
- | Now, citing the documentation in the above link, y ou need to create an application in your Fittrackee instance so go to you're fittrackee account, then go to " | + | Now, citing the documentation in the above link, you need to create an application in your Fittrackee instance so go to you're fittrackee account, then go to " |
In the "Add a new OAuth2 application" | In the "Add a new OAuth2 application" | ||
As " | As " | ||
Line 255: | Line 320: | ||
At this point, setup the link to Garmin, from your fittrackee user terminal: | At this point, setup the link to Garmin, from your fittrackee user terminal: | ||
<code bash> | <code bash> | ||
- | .garmin2fittrackee setup config-tool | + | garmin2fittrackee setup config-tool |
</ | </ | ||
+ | Link to Garmin: | ||
+ | <code bash> | ||
+ | | ||
+ | </ | ||
You will need to provide your garmin credentials for login. | You will need to provide your garmin credentials for login. | ||