Files
FreshRSS/docs/en/admins/logs_and_errors.md
T
Luis Carlos SimitanaandAlexandre Alapetite 03e871e5be Add configurable log_level system setting (#9185)
* Add configurable log_level system setting

Minz_Log currently only distinguishes 'production' (errors and
warnings only) from any other environment (everything, including
debug messages), with no granularity in between.

Introduce an optional 'log_level' system setting (error, warning,
notice, info, or debug) that overrides the verbosity implied by
'environment'. It defaults to an empty string, which preserves the
exact current behaviour.

Fixes #7594

* Slight rewrite

---------

Co-authored-by: Alexandre Alapetite <alexandre@alapetite.fr>
2026-08-25 16:18:30 +02:00

1.8 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

For finer control, set 'log_level' in the same file to one of 'error', 'warning', 'notice', 'info', or 'debug' (from the least to the most verbose). It overrides the verbosity implied by environment, e.g. 'log_level' => 'notice' keeps errors, warnings and notices while still discarding the more chatty info/debug messages.

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