Files
FreshRSS/docs/en/admins/logs_and_errors.md
maTh 4214954ea1 Improved: error page (#4465)
* error page: true HTML page

* error page: http500 erorr

* error page: add CSP header

* 'log.txt' replaced by LOG_FILENAME

* use ADMIN_LOG

* log.txt => LOG_FILENAME

* error message: add <title>

* Docs created

* delete: documentation on error message page

* line break added

* added: new line at the end

* typo fixed

* Update lib/lib_rss.php

Co-authored-by: Alexandre Alapetite <alexandre@alapetite.fr>

* Update lib/lib_rss.php

Co-authored-by: Alexandre Alapetite <alexandre@alapetite.fr>

* Minz HTTP 500

Co-authored-by: Alexandre Alapetite <alexandre@alapetite.fr>
2022-08-21 22:44:03 +02:00

1.5 KiB

Logging and Error Messages

Read the Log

Log in the Application

The log files are displayed in the config menu.

Log as Text Files

FreshRSS logs are located in:

  • user related: ./FreshRSS/data/users/*/log.txt
  • general/system related: ./FreshRSS/data/users/_/log.txt

More Logging Information

More logs can be generated by enabling 'environment' => 'development' (default: 'production'), in ./FreshRSS/data/config.php

Error Message

If there is an 'Application Problem' or 'Fatal Error', then a HTTP 500 error message is shown with more information.

Often the Cause of Problems

A typical problem is wrong file permissions in the ./FreshRSS/data/ folder so make sure the Web server can write there and in sub-directories.

Common locations for additional logs

Adapt names and paths according to your local setup.

  • If using Docker: docker logs -f freshrss
  • To check Web server logs on a Linux system using systemd: journalctl -xeu apache2 and if you are using php-fpm: journalctl -xeu php-fpm
  • Otherwise, Web server logs are typically located in /var/log/apache2/ or similar
  • System logs may also contain relevant information in /var/log/syslog, or if using systemd: sudo journalctl -xe

Running the feed update script (with the same user and PHP version as your Web server) might provide other hints, e.g.: sudo -u www-data /usr/bin/php ./FreshRSS/app/actualize_script.php

Help needed

see: Report a bug