Why FreshRSS Is the Ideal Self‑Hosted RSS Reader and How to Install It in Minutes

FreshRSS

RSS (Really Simple Syndication) subscription is an efficient way to manage news and blogs, bypassing algorithmic recommendations and delivering content directly from the source. FreshRSS is a free, lightweight, and highly customizable self‑hosted RSS aggregator maintained by a French development team.

Why Choose FreshRSS?

Designed with the principle “simple is powerful,” FreshRSS runs on low‑configuration devices such as a Raspberry Pi 1 with response times under one second. Its open‑source nature lets you modify code, add extensions, and contribute translations (supporting over 20 languages). Self‑hosting ensures full control over subscription data, avoiding third‑party tracking. FreshRSS also supports the WebSub protocol for real‑time push updates from sources like WordPress and Blogger, eliminating inefficient polling.

Core Features Overview

Multi‑User and Anonymous Mode : Multiple user accounts with independent subscriptions; anonymous reading for guests without login.

Smart Tags and Classification : Custom tags for organizing articles; XPath web scraping to extract content from sites without RSS feeds.

API and Client Integration : Compatible with Google Reader API and Fever API; works with native Android/iOS/Windows clients such as Readrops, Fluent Reader, or Newsboat. A CLI enables batch operations.

Push and Sharing : WebSub provides instant notifications; supports JSON parsing and sharing articles in HTML, RSS, or OPML formats.

Secure Login : Various authentication methods including web forms (with optional anonymous access), HTTP authentication, and OpenID Connect integration.

Installation and Configuration

Installing FreshRSS is straightforward and can be completed in minutes. The standard steps for a Linux server (Windows is similar) are:

Get the Code : Clone the repository with git clone https://github.com/FreshRSS/FreshRSS.git or download the ZIP archive and extract it to a server directory such as /var/www/freshrss.

Set Permissions : Expose only the ./p/ folder to the web server (Apache or Nginx). Grant write permission to the ./data/ folder, e.g., chown -R www-data:www-data ./data/.

Browser Installation : Visit http://your-server/p/i.php, follow the wizard to create an admin account, and choose a database (PostgreSQL 10+ recommended for performance, or SQLite for zero‑config, MySQL 8.0+/MariaDB 10.0.5+).

Advanced Configuration : Copy config.default.php to data/config.php and edit parameters such as timezone or theme. Apache users should enable AllowEncodedSlashes for better mobile compatibility.

Start Subscribing : After logging in, add RSS feeds (e.g., https://example.com/feed) to begin reading.

The official Wiki provides complete documentation, including Nginx/Lighttpd configuration and Docker deployment. Beginners are encouraged to start with the Docker image to avoid manual troubleshooting.

Extensions and Customization

FreshRSS’s extension system is a major strength. Extensions are hosted in a dedicated repository ( github.com/FreshRSS/Extensions) and can add features such as automatic backups, theme enhancements, or external service integrations. To install, upload the extension ZIP to ./extensions/ and activate it—no restart required. Community‑contributed extensions cover calendar views, social sharing, and more, exemplifying open‑source collaboration.