Skip to main content

OpenSource RSS Reader – Selfoss

Selfoss web based RSS reader logo

Selfoss is an open source multipurpose web based rss reader, live stream, mashup, aggregation web application written in PHP under GPLv3 licence.

Android and iOS are supported and a restful json api is provided for accessing or changing all selfoss data.The installation is relatively simple and the requirements are quite standards: – Apache Webserver (ngnix and lighttpd also possible)- MySQL, PostgreSQL or Sqlite- And PHP 5.3 or higher.So let’s see how to install Selfoss on your LAMP server. If you don’t have Apache, MySQL and PHP installed already, I suggest you to read this tutorial on how to install a LAMP server.



1) Create a dedicated folder in your /var/www such as

2) Download and unzip the latest version (The 2.10 at this day)

You should have all the files from the archive to /var/www/selfoss now (Including the .htaccess)

3) Change the owner of the folder by apache web user:

4) Optional – Create a MySQL database (or install and use sqlite directly to avoid having to configure a database)

If you want to use MySQL instead of the default Sqlite, I can create a dedicated user/database (with PHPMyAdmin for example) and configure the default.ini file to link Selfoss with your database.

In my case, I just want to use SQLite as I will not run a lot of feeds hence SQLite should be good enough.

Don’t forget to install it with:

5) Add username/password to connect to your Selfoss instance

If you want to username/password protect Selfoss, you can modify the default.ini file and modify the 2 lines:

For the password, you will need to use the Hash generator located at http://YOURIP/selfoss/password

Selfoss - Hash Generator

6) Enable mod_rewrite and mod_headers if not done yet

7) Restart Apache

and you should now have access to http://YourIP/selfoss/

Selfoss - Login

If you don’t see any images, and all is blank with a simple format, you need to add

to your virtualhost (see next step) or in /etc/apache2/conf.d/selfoss.conf with:

for example.

8) Set up Cron task for regular feeds update

If you want to have a refresh of your feeds every 15mn, you can use the following way:

and add

It should all be good now and don’t forget to add this blog in your RSS feeds:

Selfoss - Add Freedif RSS


Virtualhost configuration

Now you got your RSS reader working and you want to access it from rss.domain.tld or directly from mywebmail.tld, instead of using the IP/selfosss link, you will need to set up a virtualhost. And you could force HTTPS connection.

You will need to:

1) Create a A redirection in your DNS server/registrar

2) Have SSL certificate ready. If not you can read this tutorial.

3) Create your virtualhost as following:

In /etc/apache2/sites-enabled/, create a file called selfoss (In root):

and paste the following content:

Adapt the content (Servername, webmaster, SSL certificate and directory, …).

When done, save the file (CTRL+X then Yes) and reload apache: (In root)

I Know You're Listening

One thought on “OpenSource RSS Reader – Selfoss

Leave a Reply

Your email address will not be published. Required fields are marked *