.. author:: Nico Graf <hallo@uberspace.de>

.. tag:: lang-php

.. tag:: web

.. tag:: rss

Logo

.. 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:

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.

[isabell@stardust ~]$ cd /var/www/virtual/$USER/
[isabell@stardust isabell]$ wget https://github.com/SSilence/selfoss/releases/download/47.11/selfoss-47.11.zip
[…]
Saving to: ‘selfoss-47.11.zip’

100%[========================================================================================================================>] 2,881,068    819KB/s   in 3.7s

2018-09-24 10:49:50 (766 KB/s) - ‘selfoss-47.11.zip’ saved [2881068/2881068]

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

[isabell@stardust isabell]$ unzip -d html/ selfoss-47.11.zip
[…]
  inflating: html/common.php
  inflating: html/run.php
  inflating: html/cliupdate.php
[isabell@stardust isabell]$ rm selfoss-47.11.zip
[isabell@stardust isabell]$

We recommend setting up a new database for selfoss.

[isabell@stardust ~]$ mysql -e "CREATE DATABASE ${USER}_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.

[globals]
db_type=mysql
db_host=localhost
db_database=isabell_selfoss
db_username=isabell
db_password=MySuperSecretPassword
db_port=3306

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.

salt=FqFvsGWABfpPK6zQnVzD

Save the file and visit https://isabell.uber.space/password in your browser. Replace isabell.uber.space 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:

username=isabell
password=c6d064709111ff0a689f206524cec8952417b9f16121a06b4ec8c58a11b570cdb7df4d6912e49415d6c615c2961c35166f0ed98eb027425100a1ebdd55a97906
salt=FqFvsGWABfpPK6zQnVzD

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.

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 isabell.uber.space with your own domain.

*/15 * * * * curl -so /dev/null https://isabell.uber.space/update

Tested with selfoss 2.18, Uberspace 7.1.12.0

.. author_list::