Skip to content
Branch: master
Find file Copy path
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
173 lines (111 sloc) 4.65 KB
.. author:: Nico Graf <>
.. tag:: lang-php
.. tag:: web
.. tag:: rss




.. tag_list::

selfoss is a free and open source web-based news feed reader and aggregator.


The software is licensed under GPLv3. All relevant information can be found in the repository of the project.


We're using :manual:`PHP <lang-php>` in the stable version 7.1:

[isabell@stardust ~]$ uberspace tools version show php
Using 'PHP' version: '7.1'
[isabell@stardust ~]$

The domain you want to use must be set up:


Download and extract ZIP archive

Check the selfoss website or GitHub repo for the latest release and copy the download link to the ZIP file. Then cd to your :manual:`DocumentRoot <web-documentroot>` and use wget to download it. Replace the URL with the one you just copied.

Unzip the archive to the html folder and then delete it. Replace the version in the file name with the one you downloaded.


Setup your database

We recommend setting up a new database for selfoss.


Copy the default.ini to config.ini:

[isabell@stardust isabell]$ cd html
[isabell@stardust html]$ cp default.ini config.ini
[isabell@stardust html]$

Now edit config.ini file, change the database type to mysql and provide your MySQL credentials.

We also recommend password protection for your installation. First, generate a random string to use as salt.

[isabell@stardust html]$ head /dev/urandom | tr -dc A-Za-z0-9 | head -c 20 ; echo ''

Copy the output and set it as salt in your config.ini.

Save the file and visit in your browser. Replace with your domain. Use the web form to generate a hash of your password and copy the hash.

Edit config.ini again and insert your user name and password hash:

You can now log in to your installation and start adding and reading feeds.

Check out the official selfoss documentation for explanation of further configuration parameters.

Cron job

It is recommended to set up a cron job to automatically update your feeds. Edit your cron tab using the crontab -e command and insert this cron job to update every 15 minutes. Make sure to replace with your own domain.

*/15 * * * * curl -so /dev/null

Tested with selfoss 2.18, Uberspace

.. author_list::
You can’t perform that action at this time.