selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

FreshRSS logo

Self-host FreshRSS

1.30.4

Self-run RSS and Atom feed aggregator with push updates

ReleaseOpen SourceAGPL-3.0
docker run -d --restart unless-stopped --log-opt max-size=10m -p 8080:80 -e TZ=Europe/Paris -e CRON_MIN=1,31 -v freshrss_data:/var/www/FreshRSS/data -v freshrss_extensions:/var/www/FreshRSS/extensions --name freshrss freshrss/freshrss:edge
Updated2 weeks ago
LanguagePHP
Setup difficultyEasy
MobileResponsive
ThemeDark mode
Stars
16 530
Rating
5.0 (1)
Port
80 (Internal Apache/HTTP port served by the Docker image (mapped to the host, e.g. 8080:80))
Docker
freshrss/freshrss
FreshRSS article list and reader interface in the light theme

What is FreshRSS?

FreshRSS is an aggregator for RSS and Atom feeds that you run on your own hardware and open from any recent browser. It is multi-user, includes an anonymous reading mode and custom tags, and lets you save searches as user queries whose selections can be re-exposed as HTML, RSS or OPML. Content arrives through periodic refreshes (the Docker image has a built-in cron job controlled by CRON_MIN) plus WebSub pushes from compatible publishers, and pages without a feed can be followed via built-in XPath or JSON scraping. Operators choose between a web form login, HTTP authentication delegated to a proxy, or OpenID Connect, while a Google Reader compatible API and a Fever API serve third-party readers on Android, iOS, Linux, Windows and macOS; there is also a command-line interface for user and feed management. Deployment options are the official freshrss/freshrss container (Debian or Alpine base), Docker Compose, or copying the code onto Apache, nginx or lighttpd with PHP 8.1+ and SQLite, PostgreSQL, MariaDB or MySQL, exposing only the ./p/ directory. The project is AGPL-3 licensed, community driven, translated into 20+ languages, and distributed with absolutely no warranty.

Should you self-host FreshRSS?

FreshRSS scores 79/100 on selfhost.directory (how scoring works) and ranks #2 of 86 in Feed Reader. It has 16 530 GitHub stars, +300 in the last 30 days.

It shipped 9 stable releases in the past year. The latest, 1.30.4, came out on 21 October 2026. New versions land roughly every 3 weeks.

Setup is easy: most people get it running in one sitting. An official Docker image is available. It is AGPL-3.0-licensed and written mostly in PHP.

Its closest alternative on selfhost.directory is RSSHub (85/100, 46 863 stars). It scores higher overall, so compare the two before you pick. See FreshRSS vs RSSHub side by side.

Features

  • Built-in article reader
  • Command Line Interface
  • ExtensionsExtensions cannot be added from the web UI, only managed/removed.
  • Google Reader and Fever client APIsMust be enabled with api_enabled and a per-user API password.
  • HTML5 notifications
  • Internationalisation (20+ languages)
  • Keyboard Shortcuts
  • Large-scale feed handling
  • Multi-user accountsAnonymous reading mode for the default user is optional.
  • OPML import and export
  • RSS/Atom Feed Aggregation
  • Saved searches / dynamic feeds
  • Scheduled feed refresh (cron)
  • Website scraping (XPath / JSON)
  • WebSub / PubSubHubbub push updates

FreshRSS README

How to install FreshRSS

Install FreshRSS with Docker

tags :latest, :edge, :x.y.z, :x and *-alpine variants
Environment variables
TZ, CRON_MIN, LISTEN, FRESHRSS_ENV, DATA_PATH, ENABLE_ACCESS_LOG, COPY_LOG_TO_SYSLOG, COPY_SYSLOG_TO_STDERR, INTERNAL_HOST_ALLOWLIST, TRUSTED_PROXY, OIDC_ENABLED, FRESHRSS_INSTALL, FRESHRSS_USER
docker run -d --restart unless-stopped --log-opt max-size=10m \
  -p 8080:80 \
  -e TZ=Europe/Paris \
  -e CRON_MIN=1,31 \
  -v freshrss_data:/var/www/FreshRSS/data \
  -v freshrss_extensions:/var/www/FreshRSS/extensions \
  --name freshrss \
  freshrss/freshrss:edge

Then browse to the instance to finish the installation through the web interface, or use the CLI.

How to configure FreshRSS

  • environmentproductiondevelopment adds error messages, production keeps only the important ones.

    values: production | development

  • base_urlAddress of the instance, used to build absolute URLs (e.g. for WebSub).
  • languageenLanguage of the web interface.
  • titleFreshRSSTitle shown for this instance in the web interface.
  • default_user_Name of the default user, also the public user used for anonymous reading.

FreshRSS releases & version history

@ Every self-hosted release, weekly

One Monday email with the week's stable releases across the directory.

FAQ

Problems with firewalls

Reach the feed locally and then from the host or container running FreshRSS (for example with curl -v on the feed URL), and adjust the firewall so outbound connections to the feed's IP and port are not blocked.

Why do I have a blank page while trying to configure the sharing options?

The word "sharing" in the URL triggers some ad-blocker rules; from version 1.16 the URL uses "integration" instead, otherwise whitelist your instance or add an allow rule in uBlock.

Permission denied under /usr/share/ with PHP-FPM

Install FreshRSS in a writable path such as /var/www/FreshRSS, or move ./data/ to a writable location and link it back, or add a ReadWritePaths= override for the data directory in the PHP-FPM systemd unit and restart it.

Permissions under SELinux

On SELinux distributions such as Fedora or RHEL, run semanage fcontext -a -t httpd_sys_rw_content_t '/usr/share/FreshRSS/data(/.*)?' followed by restorecon -Rv /usr/share/FreshRSS/data as root so the httpd process can write there.

How can you change a forgotten password?

Since 1.10.0 admins can reset a user password in Administration > Manage users; since 1.8.0 it is also possible from a terminal with ./cli/update_user.php --user <username> --password <password>.

Why do I have errors while registering a feed?

Check the feed syntax with the W3C feed validator, then test it with the SimplePie demo tool, and finally try adding it on the FreshRSS demo; if it works there the problem is likely with the hosting server, otherwise report an issue on GitHub.

Why is robots.txt located in a sub-folder?

FreshRSS is split into a public section (the ./p folder) and a private section (everything else), so robots.txt lives inside ./p; only the public section should be exposed at the domain level.

What is /i at the end of the application URL?

The /i endpoint serves icons, images, styles and scripts without cookies, keeps the public ./p root free of HTTP access restrictions, avoids problems with public files like favicon.ico and robots.txt, and can still show the logo when a restriction is hit.

More in Feed Reader

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…