Administrateur¶

FitTrackee ne démarre pas¶

Vérifiez l'URL de la base de données dans les variables d'environnement si l'erreur suivante est affichée dans les logs de gunicorn :
```
sqlalchemy.exc.NoSuchModuleError: Can't load plugin: sqlalchemy.dialects:postgres
```
La variable DATABASE_URL doit commencer par postgresql:// (les URL commençant par postgres:// ne sont plus supportées).
Vérifiez l'URL du serveur SMTP dans les environment variables si l'erreur suivante est affichée dans les logs de gunicorn :
```
fittrackee.emails.exceptions.InvalidEmailUrlScheme
```
Une valeur valide pour la variable EMAIL_URL doit être fourni (voir courriels).

Les images de la carte ne sont pas affichées mais la carte est affichée dans le détail de la séance¶

Vérifier le chemin dans les variables d'environnement. UPLOAD_FOLDER doit être défini avec un chemin absolu.

Échec du chargement ou du téléchargement de fichiers¶

Vérifiez client_max_body_size dans la configuration nginx. Augmentez la valeur pour gérer des fichiers plus volumineux (voir la documentation de nginx).
Augmenter le délai d'attente (timeout) gunicorn si l'erreur suivante est affichée dans le journal de gunicorn : [CRITICAL] WORKER TIMEOUT.

`RuntimeError: thread already started`¶

Cette erreur apparait dans les logs des workers de la file d'attente des tâches avec l'interface de ligne de commandes (CLI) de Flask-dramatiq et une version 3.13+ de Python.

La solution est d'utiliser directement l'interface de ligne de commandes de Dramatiq, par exemple :
```
$ dramatiq fittrackee.tasks:broker --processes=2 --log-file=dramatiq.log
```

`staticmap3.staticmap - ERROR - request failed [None]` ou "Erreur lors de la génération de l'image de la carte"¶

A partir de la version v0.10+, une variable d'environnement pour le répertoire de cache de Static Map 3 (STATICMAP_CACHE_DIR) a été ajoutée.

Pour une installation avec Docker, le répertoire doit être accessible en écriture à l'utilisateur fittrackee (voir le fichier exemple docker-compose.yml dans le dépôt):

volumes:
  - ${UPLOAD_DIR:-./data/uploads}:/usr/src/app/uploads
  - ${LOG_DIR:-./data/logs}:/usr/src/app/logs
  - ${STATICMAP_CACHE_DIR:-./data/staticmap_cache}:/usr/src/app/.staticmap_cache
post_start:
  - command: chown -R fittrackee:fittrackee /usr/src/app/uploads /usr/src/app/logs /usr/src/app/.staticmap_cache
    user: root

`psycopg2.errors.UndefinedObject: ERROR: type "geometry" does not exist`¶

Cette erreur survient lorsque l'extension PostGIS n'est pas installée, cette extension est requise à partir de la version 1.0.0 de FitTrackee.

Pour l'installer, voir les instructions d'installation ou de mise à jour version vers la version 1.x

Des séances créées à partir de fichiers ne sont pas affichées sur la carte¶

Si une séance a été créée avant la version 1.0.0 de FitTrackee, il est nécessaire de l'actualiser pour générer la géométrie utilisée pour afficher la carte

Voir Mettre à jour vers la version 1.x pour les instructions permettant de réactualiser toutes les séances avec l'interface de lignes de commande.