FitTrackee/docsrc/source/troubleshooting/administrator.rst

36 lines
1.5 KiB
ReStructuredText
Raw Normal View History

2019-07-14 20:44:10 +02:00
Administrator
#############
2021-07-10 10:46:44 +02:00
`FitTrackee fails to start`
~~~~~~~~~~~~~~~~~~~~~~~~~~~
2019-07-14 20:44:10 +02:00
2022-04-09 10:16:46 +02:00
- Check the database URL in `environment variables <../installation.html#envvar-DATABASE_URL>`__ if the following error is displayed in **gunicorn** logs:
2019-07-14 20:44:10 +02:00
2022-04-09 10:16:46 +02:00
.. code::
2021-07-10 10:46:44 +02:00
2022-04-09 10:16:46 +02:00
sqlalchemy.exc.NoSuchModuleError: Can't load plugin: sqlalchemy.dialects:postgres
2021-07-10 10:46:44 +02:00
2023-06-21 19:45:47 +02:00
The variable ``DATABASE_URL`` must start with ``postgresql://` (engine URLs starting with ``postgres://`` are no longer supported).
2022-04-09 10:16:46 +02:00
- Check the email URL in `environment variables <../installation.html#envvar-EMAIL_URL>`__ if the following error is displayed in **gunicorn** logs:
.. code::
fittrackee.emails.exceptions.InvalidEmailUrlScheme
2022-07-03 17:27:43 +02:00
A valid ``EMAIL_URL`` must be provided (see `emails <../installation.html#emails>`__).
`Map images are not displayed but map is shown in Workout detail`
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
2023-03-08 15:58:02 +01:00
- Check the path in `environment variables <../installation.html#envvar-UPLOAD_FOLDER>`__. ``UPLOAD_FOLDER`` must be set with an absolute path.
`Failed to upload or download files`
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
- Check ``client_max_body_size`` in **nginx** config. Increase the value to handle larger files (see **nginx** `documentation <https://nginx.org/en/docs/http/ngx_http_core_module.html#client_max_body_size>`_).
- Increase **gunicorn** `timeout <https://docs.gunicorn.org/en/stable/settings.html#timeout>`__ value if the following error is displayed in gunicorn log: ``[CRITICAL] WORKER TIMEOUT``.