Skip to content
A free, self-hostable aggregator…
PHP CSS HTML JavaScript Shell Dockerfile
Branch: master
Clone or download
Pull request Compare This branch is 94 commits behind FreshRSS:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github
Docker
app
cli
data
docs
extensions
lib
p
tests
.dockerignore
.editorconfig
.gitignore
.hadolint.yaml
.jshintignore
.jshintrc
.stylelintignore
.stylelintrc
.travis.yml
CHANGELOG.md
CONTRIBUTING.md
CREDITS.md
LICENSE.txt
Makefile
README.fr.md
README.md
config-user.default.php
config.default.php
constants.php
force-https.default.txt
index.html
index.php
phpcs.xml

README.md

Build Status Liberapay donations

FreshRSS

FreshRSS is a self-hosted RSS feed aggregator like Leed or Kriss Feed.

It is lightweight, easy to work with, powerful, and customizable.

It is a multi-user application with an anonymous reading mode. It supports custom tags. There is an API for (mobile) clients, and a Command-Line Interface.

Thanks to the WebSub standard (formerly PubSubHubbub), FreshRSS is able to receive instant push notifications from compatible sources, such as Mastodon, Friendica, WordPress, Blogger, FeedBurner, etc.

Finally, it supports extensions for further tuning.

Feature requests, bug reports, and other contributions are welcome. The best way to contribute is to open an issue on GitHub. We are a friendly community.

FreshRSS logo

Disclaimer

FreshRSS comes with absolutely no warranty.

FreshRSS screenshot

Documentation

Requirements

  • A recent browser like Firefox / IceCat, Internet Explorer 11 / Edge (minus a few details), Chromium / Chrome, Opera, Safari.
    • Works on mobile (except a few features)
  • Light server running Linux or Windows
    • It even works on Raspberry Pi 1 with response time under a second (tested with 150 feeds, 22k articles)
  • A web server: Apache2 (recommended), nginx, lighttpd (not tested on others)
  • PHP 5.6+ (PHP 7+ recommended for higher performance)
  • MySQL 5.5.3+ or MariaDB equivalent, or SQLite 3.7.4+, or PostgreSQL 9.5+

Releases

See the list of releases.

About branches

  • Use the master branch if you need less frequent stable versions.
  • Use the dev branch if you want a rolling release with the newest features, or help testing or developing the next stable version.

Installation

Automated install

  • Docker
  • YunoHost
  • Cloudron

Manual install

  1. Get FreshRSS with git or by downloading the archive
  2. Put the application somewhere on your server (expose only the ./p/ folder to the Web)
  3. Add write access to the ./data/ folder for the webserver user
  4. Access FreshRSS with your browser and follow the installation process
  5. Everything should be working :) If you encounter any problems, feel free to contact us.
  6. Advanced configuration settings can be found in config.default.php and modified in data/config.php.
  7. When using Apache, enable AllowEncodedSlashes for better compatibility with mobile clients.

More detailed information about installation and server configuration can be found in our documentation.

Advice

  • For better security, expose only the ./p/ folder to the Web.
    • Be aware that the ./data/ folder contains all personal data, so it is a bad idea to expose it.
  • The ./constants.php file defines access to the application folder. If you want to customize your installation, look here first.
  • If you encounter any problem, logs are accessible from the interface or manually in ./data/users/*/log*.txt files.
    • The special folder ./data/users/_/ contains the part of the logs that are shared by all users.

F.A.Q.:

  • The date and time in the right-hand column is the date declared by the feed, not the time at which the article was received by FreshRSS, and it is not used for sorting.
    • In particular, when importing a new feed, all of its articles will appear at the top of the feed list regardless of their declared date.

Extensions

FreshRSS supports further customizations by adding extensions on top of its core functionality. See the repository dedicated to those extensions.

APIs & native apps

FreshRSS supports access from native apps for Linux, Android, iOS, and OS X, via two distinct APIs.

Google Reader-like API

There is more information available about our Google Reader compatible API on the page mobile access.

Supported clients are:

Fever API

See our Fever API documentation page.

Supported clients are:

Included libraries

Only for some options or configurations

You can’t perform that action at this time.