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]`¶

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