FreshRSS /FreshRSS

A free, self-hostable news aggregator…

★ 16,596⑂ 1,348👁 114⑃ 4,531● 4,017▤ 72
PHPAGPL-3.0Created 2012-10-21freshrss.org
Download: FreshRSS 1.30.4FreshRSS-1.30.4 ↓1.30.42026-10-21
+9
Daily
16,596
stars
1,348
forks
114
watchers
4,531
prs
4,017
issues
72
releases

README

Read this document on github.com/FreshRSS/FreshRSS/ to get the correct links and pictures.
 Version française

 FreshRSS

FreshRSS is a self-hosted RSS feed aggregator.

It is lightweight, easy to work with, powerful, customizable, and has been translated into many languages.

It is a multi-user application with an anonymous reading mode. It supports custom tags.
There is an API for (mobile) clients, and a Command-Line Interface.

Thanks to the WebSub standard,
FreshRSS is able to receive instant push notifications from compatible sources, such as Friendica, WordPress, Blogger, Medium, etc.

FreshRSS natively supports basic Web scraping,
based on XPath, for Web sites not providing any RSS / Atom feed.
Also supports JSON documents.

FreshRSS offers the ability to reshare selections of articles by HTML, RSS, and OPML.

Different login methods are supported: Web form (including an anonymous option), HTTP Authentication (compatible with proxy delegation), OpenID Connect.

Finally, FreshRSS supports extensions for further tuning.

 Official website: 
 Demo: 
 License: GNU AGPL 3

!FreshRSS logo

 Feedback and contributions

Feature requests, bug reports, and other contributions are welcome. The best way is to open an issue on GitHub.
We are a friendly community.

To facilitate contributions, the following option is available:



 Screenshot

!FreshRSS screenshot

 Disclaimer

FreshRSS comes with absolutely no warranty.

 Documentation

 User documentation, where you can discover all the possibilities offered by FreshRSS
 Administrator documentation for detailed installation and maintenance related tasks
 Developer documentation to guide you in the source code of FreshRSS and to help you if you want to contribute
 Contributor guidelines for those who want to help improve FreshRSS
	 Check AGENTS.md for coding conventions (both for humans and AI agents).

 Requirements

 A recent browser like Firefox / IceCat, Edge, Chromium / Chrome, Opera, Safari.
	 Works on mobile (except a few features)
 Light server running Linux or Windows
	 It even works on Raspberry Pi 1 with response time under a second (tested with 150 feeds, 22k articles)
 A Web server: Apache2.4+ (recommended), nginx, lighttpd (not tested on others)
 PHP 8.2+
	 Required extensions: cURL, DOM, JSON, XML, session, ctype
	 Recommended extensions: PDO_SQLite (for export/import), GMP (for API access on 32-bit platforms), IDN (for Internationalized Domain Names), mbstring (for Unicode strings), iconv (for charset conversion), ZIP (for import/export), zlib (for compressed feeds)
	 Extension for database: PDO_PGSQL or PDO_SQLite or PDO_MySQL
 PostgreSQL 10+ or SQLite or MariaDB 10.6+ or MySQL 8.0+

 Installation

If you want a rolling release with the newest features and security fixes,
or want to help testing or developing the next release,
you can use the edge branch.

If you prefer fewer updates, you can use the latest branch.
It is more stable but at the price of less security and more known bugs

Top issues

Discussions

Latest release

FreshRSS 1.30.4 1.30.4 2026-10-21
Milestone

This is a fourth security release in the continuation of 1.30.x, mostly to address some severe PHP vulnerabilities and update our official alternative Docker images (Alpine) (our default Docker images based on Debian were already fixed).

Note that our rolling-release channel (edge) is recommended for faster security patches.

Bug fixes highlights 🐛:
 PHP CVE-2026-109618, CVE-2026-109619 php2026-10-21-5

This release has been made by @Alkarex, @Frenzie and newcomer @icco

Full changelog:

 Security
	 Docker alternative image (Alpine 3.24) updated with PHP 8.5.12 and Ap

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON