FreshRSS

Reading & Bookmarks

Read and organize feeds on your own server, with multiple users and mobile-client APIs.

Use with conditions

Official website Repository

Last updatedRelease 2026-09-09

Open source licenseAGPL-3.0

PlatformsLinux · Windows server · Web / mobile browser

DeploymentContainers / self-hosted

About this project

FreshRSS is a self-hosted feed aggregator for collecting and reading website updates. It supports multiple users, anonymous reading, and custom article tags. Browser access provides the reading interface, while APIs and command-line functionality offer additional ways to interact with an installation. Subscriptions and reading activity are maintained within the instance operated by the user or administrator.

WebSub can deliver pushed updates, while XPath and JSON extraction rules can collect content from sites without conventional feeds. Selected articles can be shared through web pages or feed formats. Extensions add further behavior. Standard feed subscriptions and rule-based extraction are separate collection methods, with the latter depending on configuration appropriate to the source site's structure.

Deployment requires a web server, PHP, and a supported database such as SQLite, PostgreSQL, MariaDB, or MySQL. The repository instructs operators to expose only the public directory, keeping personal data directories outside that entry point. It also distinguishes stable releases from the rolling edge branch, so installation and update instructions should match the selected channel.

FreshRSS — Official README

Decision guide

Why it is worth a look

RSS aggregation, tags, and user filters in one application
First-party usage or installation documentation is available
A verifiable formal release record is available

Before you use it

Requires maintaining PHP, a database, or a Docker instance
Official guidance exposes only the p directory; data contains personal information
Version 1.30.0 is a security update
Stable and edge channels differ in update frequency and fix scope

Manual setupHigh

With an AI agentModerate

DeploymentContainers / self-hosted

Additional requirements3 confirmed; others not verified

Choose an officially listed hosting provider or container; Confirmed requirements: Command line, Docker, An always-on device or service; Some requirements have not been verified. Check the official setup instructions.

What it can do

RSS aggregation
Tags and user filters
OPML sharing
Mobile-client API
Extension plugins
Optional web content extraction

Who it fits

Good for

People who want their own feed service; People needing multiple readers and extensions

Not a fit

Unwilling to maintain a self-hosted service and not considering hosting providers; Only accepting a workflow without checking permissions and data backups

Getting started

Choose an officially listed hosting provider or container
For self-hosting, prepare data directories and the database
Complete installation through the web interface
Import subscriptions and verify background updates

Alternatives to consider

What it takes

Getting startedModerate

Ongoing maintenanceModerate

Failure impactModerate

Knowledge neededModerate

Not selected for comparison.

Get help from an AI agent

DeploymentContainers / self-hosted

Additional requirements3 confirmed; others not verified

With an AI agentModerate

{
  "project": "FreshRSS",
  "decision": "Use with conditions",
  "purpose": "Read and organize feeds on your own server, with multiple users and mobile-client APIs.",
  "repository": "https://github.com/FreshRSS/FreshRSS",
  "official_site": "https://freshrss.org/",
  "deploy_shape": "Containers / self-hosted",
  "additional_dependencies": "Choose an officially listed hosting provider or container; Confirmed requirements: Command line, Docker, An always-on device or service; Some requirements have not been verified. Check the official setup instructions.",
  "direct_setup": "High",
  "ai_assisted_setup": "Moderate",
  "operational_burden": "Moderate",
  "operational_risk": "Moderate",
  "knowledge_requirement": "Moderate",
  "license": "AGPL-3.0",
  "install_steps": [
    "Choose an officially listed hosting provider or container",
    "For self-hosting, prepare data directories and the database",
    "Complete installation through the web interface",
    "Import subscriptions and verify background updates"
  ],
  "good_for": "People who want their own feed service; People needing multiple readers and extensions",
  "avoid_if": "Unwilling to maintain a self-hosted service and not considering hosting providers; Only accepting a workflow without checking permissions and data backups"
}