To take full advantage of FreshRSS, it needs to retrieve new items from the feeds you have subscribed to. There are several ways to do this:
- Manual update
- Automatic update with cron
- Online cron
- Feed configuration of “Do not automatically refresh more often than”
If you can’t or don’t want to use the automatic method, you can update manually. There are two methods for updating all or some of the feeds.
This update occurs on all feeds. To trigger it, simply click on the update link in the navigation menu.
When the update starts, a progress bar appears and changes while feeds are processed.
This update occurs on the selected feed only. To trigger it, simply click on the update link in the feed menu.
Automatic update with cron
This is the recommended method.
This method is only available if you have access to the scheduled tasks of the machine on which your FreshRSS instance is installed.
The script is named actualize_script.php and is located in the app folder. The scheduled task syntax will not be explained here. However, here is a quick introduction to crontab that might help you.
Here is an example to trigger article update every hour.
0 * * * * php /path/to/FreshRSS/app/actualize_script.php > /tmp/FreshRSS.log 2>&1
If you do not have access to the installation server scheduled task, you can still automate the update process.
To do so, you need to create a scheduled task, which need to call a specific URL: https://freshrss.example.net/i/?c=feed&a=actualize (it could be different depending on your installation). Depending on your application authentication method, you need to adapt the scheduled task.
Special parameters to configure the script - all parameters can be combined:
- Parameter “force”
https://freshrss.example.net/i/?c=feed&a=actualize&force=1 If force is set to 1 all feeds will be refreshed at once.
- Parameter “ajax”
https://freshrss.example.net/i/?c=feed&a=actualize&ajax=1 Only a status site is returned and not a complete website. Example: “OK”
- Parameter “maxFeeds”
https://freshrss.example.net/i/?c=feed&a=actualize&maxFeeds=30 If maxFeeds is set the configured amount of feeds is refreshed at once. The default setting is “10”.
- Parameter “token”
https://freshrss.example.net/i/?c=feed&a=actualize&token=542345872345734 Security parameter to prevent unauthorized refreshes. For detailed Documentation see “Form authentication”.
For Form Authentication
If your FreshRSS instance is using Form Authentication, you can configure an authentication token to grant access to the online cron.
You can target a specific user by adding their username to the query string, with
The scheduled task syntax should look as follows:
Alternatively, but not recommended, if you configure the application to allow anonymous reading, you can also allow anonymous users to update feeds (“Allow anonymous refresh of the articles”), and that does not require a token.
For HTTP authentication
If your FreshRSS instance is using HTTP authentication, you’ll need to provide your credentials to the scheduled task.
Note: This method is discouraged as your credentials are stored in plain text.
0 * * * * curl -u alice:password123 'https://freshrss.example.net/i/?c=feed&a=actualize&maxFeeds=10&ajax=1&user=alice'
On some systems, that syntax might also work:
For No authentication (None)
If your FreshRSS instance uses no authentication (public instance, default user):
Feed configuration of “Do not automatically refresh more often than”
FreshRSS does not, by design, supports pull refreshes at frequencies higher than once every 15 minutes. But FreshRSS supports instant push (WebSub).
FreshRSS is part of an RSS ecosystem. A typical reaction that we have seen from several servers is to simply ban by, IP, user-agent, or to remove their RSS feed altogether. Bad user behaviours affect the larger community.
The default value of “Do not automatically refresh more often than” is set in Configuration -> Archiving.
The lowest global/default purposely cannot be set faster than every 20 minutes, to avoid wasting resources and make sure the RSS ecosystem remains sane.
Individual feed configuration
Under the settings for individual feeds, you can go down to 15min.