# FreshRSS

FreshRSS is a lightweight, customizable, self-hosted Really Simple Syndication (RSS) and Atom feed aggregator for organizing and reading feeds with multi-user support. It is open source and self-hosted, installable on Proxmox, Kubernetes (Helm), TrueNAS, Umbrel, Unraid, ZimaOS and Docker Hub.

Canonical page: https://ourlocalhost.com/app/3830/freshrss

## Description

FreshRSS is a lightweight, customizable, self-hosted Really Simple Syndication (RSS) and Atom feed aggregator for organizing and reading feeds with multi-user support.

## Platform availability

Available on 6 of 6 install platforms: Unraid, TrueNAS, Umbrel, ZimaOS, Proxmox, Helm.

## Health score

93/100 (Excellent), based on 4 of 4 factors.
- Maintained: 100 (last commit 2 days ago)
- Popular: 84 (16,255 GitHub stars)
- Easy to install: 85 (6 install platforms, install notes, Docker image)
- Light to run: 100 (256 MB minimum RAM, runs on ARM)

## Links

- GitHub: https://github.com/FreshRSS/FreshRSS
- Proxmox: https://community-scripts.github.io/ProxmoxVE/scripts?id=freshrss
- Kubernetes (Helm): https://artifacthub.io/packages/helm/halkeye/freshrss
- TrueNAS: https://apps.truenas.com/catalog/freshrss/
- Umbrel: https://apps.umbrel.com/app/freshrss
- Unraid: https://ca.unraid.net/apps/freshrss-0o3gra6033s0kq?q=freshrss
- Official website: https://freshrss.org/
- Documentation: https://freshrss.github.io/FreshRSS/
- ZimaOS: https://github.com/IceWhaleTech/CasaOS-AppStore/tree/main/Apps/FreshRSS
- Docker Hub: https://hub.docker.com/r/freshrss/freshrss

## Common questions

### In a command-line FreshRSS install, what must be done after running do-install.php?

Run create-user.php to create the login user, because do-install.php does not create the default user. Use a reachable base URL, since a wrong base URL or missing user can break mobile APIs, favicons, push, and first login.

### Which Apache modules should be enabled when serving FreshRSS with Apache?

Enable the headers, expires, rewrite, and ssl modules. Missing them can make pages, login, or links fail.

### Why can FreshRSS updates break in a containerized Postgres setup?

FreshRSS updates can break because of Postgres collation version mismatches in the container. Users report this issue occurring on nearly every update.

### How can I troubleshoot a feed that FreshRSS cannot fetch?

Use cURL to try the feed URL with different user agents. Start from the same server as FreshRSS, then test other IPs if the responses differ, since IP-based filtering can be the cause.

## Alternatives

- CommaFeed: Google Reader inspired self-hosted RSS reader, based on Quarkus and React/TypeScript.
- FeedFlow: FeedFlow is a minimal RSS reader for people who want a clean, chronological timeline — no algorithms, no clutter, no noise.
- Feeder: Feeder is a fully free/libre feed reader.
- Feedly: Organize and read content from RSS feeds into a magazine-like experience, simple sharing options, and seamless access across all devices.
- Fluent Reader: It is free for Mac, Windows and Linux if you download it from GitHub, and it's paid ($2) for Android and iOS.
- Inoreader: Aggregate RSS, newsletters, and social feeds with advanced filtering, real-time cross-device syncing, customizable reading views, and ad-fr…
- Liferea: Liferea is a web feed reader/news aggregator that brings together all of the content from your favorite subscriptions into a simple interfa…
- Miniflux: Miniflux is a minimalist, self-hosted RSS (Really Simple Syndication) and Atom feed reader.
- NetNewsWire: RSS reader shows you articles from your favorite blogs and news sites, and it keeps track of what you’ve read.
- NewsBlur: NewsBlur is a personal news reader that brings people together to talk about the world.
- QuiteRSS: QuiteRSS is a open-source cross-platform RSS/Atom news feeds reader written on Qt/C++
- Read You: This is a copy of Reeder, in order to give Android an RSS reader similar to Reeder, combines the interaction logic of Reeder with the desig…

---
Source: Our Local Host (https://ourlocalhost.com/app/3830/freshrss), the self-hosted and open-source app directory.