Self-host FreshRSS
1.30.4Self-run RSS and Atom feed aggregator with push updates
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- 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))
freshrss/freshrssWhat 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.
FreshRSS alternatives
garssSelf-hosted RSS aggregator using Docker Compose to build an ad-free news feed page. Uses GitHub Actions for daily updates and integrates RSSHub for enhanced feeds.Comparegarss with FreshRSS
miniflux-phpMiniflux is a minimalist, self-hosted, open-source RSS reader with a clean web interface, multiple user support, themes, and API access for mobile apps.Compareminiflux-php with FreshRSS
orpington-newsA self-hosted feed reader for RSS and Atom with PWA, themes, fonts, nested collections, and multiple layouts.Compareorpington-news with FreshRSS
RSSHub PythonSelf-hosted Python RSS generator creating feeds from web pages, documents, datasets, and APIs via Flask and Playwright. Supports JS rendering, PDF/EPUB, Hugging Face.CompareRSSHub Python with FreshRSS
rsstodolistSelf-hosted, open-source URL-to-RSS bridge converting bookmarks into private or shareable RSS feeds with auto metadata scraping and PostgreSQL/MariaDB backend.Comparersstodolist with FreshRSS
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
- Read this document on github.com/FreshRSS/FreshRSS/ to get the correct links and pictures.
- Version française
FreshRSS is a self-hosted RSS feed aggregator.
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
FusionA self-hosted, open-source RSS reader that runs as one Go binary or a Docker container, with a responsive PWA web UI, Fever API support, and OIDC login.
garssSelf-hosted RSS aggregator using Docker Compose to build an ad-free news feed page. Uses GitHub Actions for daily updates and integrates RSSHub for enhanced feeds.
GlanceSelf-hosted, open-source startpage dashboard that gathers RSS, YouTube, Reddit and server info into widgetized pages via one small Go binary or Docker container.
goelandGoeland is a self-hosted, open-source tool that turns RSS, Atom, and JSON feeds into beautiful HTML email digests with full-text extraction and composable filters.
gpodder2gogpodder2go is a self-hosted, open-source Go implementation of the gpodder.net API for syncing podcast subscriptions across devices, replacing gpodder/mygpo server.
html2rssSelf-hosted web app turning webpages into RSS/JSON feeds. Paste a URL, get a feed instantly with a JS scraper. Includes Feed Directory and custom YAML support.
huntlyYour Personal AI-Powered Information Hub
InfomateSelf-hosted RSS feed aggregator that consolidates multiple news sources into thematic collections. Uses TextRank algorithm for NLP-based article summarization.
JARRJARR is a self-hosted, open-source feed reader that clusters articles via TF-IDF. Supports RSS/Atom, JSON Feed, Reddit, OAuth, OPML, dark mode, and REST API with Swagger.
Kbin/kbin is a self-hosted, open-source content aggregator and microblogging platform federating via ActivityPub. Offers Reddit-like magazines, moderation, REST/GraphQL APIs.
Kill-the-NewsletterA self-hosted Node.js app that converts email newsletters into Atom feeds for users who prefer feed readers over email clients.
KindleEarSelf-hosted, open-source app that turns RSS feeds and Calibre recipes into ebooks or mp3 pushed to Kindle devices, with an e-ink reader, AI summaries and translation.

0 comments