Repolode
Submit
fossar

fossar/selfoss

Self-hosted PHP web app that aggregates RSS feeds and other sources into one reader with a live stream view.

Open-source alternative to:Feedly

View on GitHubWebsite
Stars
2,475
Forks
340
Open issues
181
Last commit
6 days ago

What is it?

selfoss is a multipurpose RSS reader and feed aggregation web application. It lets you follow updates from different websites, social networks and other platforms in a single place.

It is written in PHP, so it can be run on any PHP web server. Installation involves copying the files to a document root, making a few data directories writable, and setting up a cron job or systemd timer that calls the update endpoint or cliupdate.php to refresh feeds. SQLite works without extra configuration, and other databases can be configured in config.ini.

The project includes OPML import for moving subscriptions from another reader. Its client side is built with Parcel, and development requires Composer and npm.

Key features

  • 01Aggregates RSS feeds and other web updates into one interface.
  • 02Supports OPML import for migrating existing subscriptions.
  • 03Runs on any PHP server, with SQLite available out of the box.
  • 04Updates feeds through a web URL, cron job, systemd timer, or command line script.
  • 05Customizable through a config.ini file.

Use cases

  • Keeping up with many blogs and news sites in one self-hosted reader.
  • Running a private feed aggregator on your own web server.
  • Migrating subscriptions from another RSS reader using OPML.

Quick start

  1. 1

    Download a stable release from the releases page

  2. 2

    Copy all files (including the .htaccess files) to a PHP server document root and make the data directories writable

  3. 3

    Set up a cronjob or systemd timer to request the /update URL for feed updates

Things to know

  • Maintained by a single person in their free time, so maintenance takes priority over new features.
  • Licensed under GPL-3.0, a copyleft license that requires derivative works to be distributed under the same terms.
  • Self-hosting requires a PHP server, database setup and a scheduled job for feed updates.

In collections

RSS readers and feed toolsSelf-hosted apps

Topics

#rss-reader#rss#feed-aggregator#php#self-hosted#news-feed#aggregator#hacktoberfest#mashup#selfoss

FAQ

What is selfoss?
Self-hosted PHP web app that aggregates RSS feeds and other sources into one reader with a live stream view. selfoss is a multipurpose RSS reader and feed aggregation web application. It lets you follow updates from different websites, social networks and other platforms in a single place.
Is selfoss free to use? What license does it have?
selfoss is open source under the GPL-3.0 license. Check the license terms before using it in commercial products.
Is selfoss still maintained?
Actively maintained. The last commit to selfoss was on Nov 1, 2026.
What can I use selfoss for?
Keeping up with many blogs and news sites in one self-hosted reader. Running a private feed aggregator on your own web server. Migrating subscriptions from another RSS reader using OPML.
How do I install selfoss?
Download a stable release from the releases page Copy all files (including the .htaccess files) to a PHP server document root and make the data directories writable Set up a cronjob or systemd timer to request the /update URL for feed updates
Where can I get selfoss?
The source code and installation instructions are on GitHub: https://github.com/fossar/selfoss

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects