mirror of https://github.com/FreshRSS/FreshRSS.git synced 2026-05-14 10:13:52 -04:00

Files

polybjorn b08c4ef243 docs: standardise English heading style and surface hidden pages (#8766 )

Apply sentence case to all H1s in docs/en/ and remove redundant "FreshRSS"
from titles where the docs site context already implies it. Align the three
section index titles to "Administrator/Developer/User manual", matching
the existing root H1 "FreshRSS manual (English)".

Add missing H1s to two pages that were silently dropped from the sidebar:
the user FAQ and the Caddy reverse proxy page. The sidebar template uses
page.title (derived from H1 by jekyll-titles-from-headings), so pages
without an H1 had title=nil and were skipped.

Update sidebar parent labels in docs_nav.html and the chapter list in
en/index.md to use the new "* manual" naming. Update link text in section
indexes that referenced the old H1s. Bundle two grammar fixes encountered
along the way: "an User Interface" -> "a user interface", and drop the
awkward "the" in "Configuring the email address validation".

EN only. No filenames, URLs, or anchor targets changed (anchors come from
H2 and below, which are untouched). FR is generated from EN via po4a and
will be regenerated separately.

Co-authored-by: Bjørn A. Andersen <polybjorn@users.noreply.github.com>

2026-05-02 22:23:35 +02:00

1.5 KiB

Raw Blame History

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

1.5 KiB Raw Blame History