OpenSource RSS Reader – Leed (Light Feed)

leed logoAs stated in my very first article on building a list of interesting RSS Readers, to install and try some of them on my own server to replace Flipboard, Newsstand, Feedly and others RSS Readers, here is my next article on Leed.

Leed (Contraction of Light Feed) is a RSS Reader free and opensource, under  CC-BY-NC-SA. With a responsive design, Leed can be consulted on any platform/device (PC, Tablet, Smartphone,…), made to be self hosted, Leed is optimized to improve the user experience through good performance and based on latest web technologies (HTML5, CSS3,…). Although it doesn’t support yet the multi-user, it will come in their V2, as the roadmap shows.

 

Leed - Screenshot

Leed has a growing community (mostly French) that have developed & shared some plugin and themes to enhance Leed.

Obviously, the best for you is to try their demo!

Interested? Here is how to install it on your server.

 

Installation

They recommend using Apache (Not testing with others), >PHP 5.3, MySQL and some “common sense“. If you don’t have Apache, PHP and MySQL, please follow my previous tutorial. For common sense….well can’t help there…no tutorial to offer \o/

1) In your /var/www download the latest stable version

cd /var/www
wget https://github.com/ldleman/Leed/archive/master.zip

2) Extract the archive and rename it as “leed”

unzip master.zip
rm master.zip
mv Leed-master/ leed

3) Change folder owner to www-data (To give permissions to Apache)

chown -R www-data:www-data /var/www/leed

4) Go to http://IP/leed with your favourite Web Browser to access to the web installer.

You will need to provide the information of your MySQL database. You can use PHPMyAdmin to create a dedicated database on your server.

Leed - Installation

When done, you will have access directly to the admin interface to modify the preferences. It should be pretty straightforward.

And finally remove the install.php for security.

rm /var/www/leed/install.php

5) Set up a cron job to update regularly your feeds.

Access to the crontab file (in root)

crontab -e

and copy/paste at the end:

0 * * * * cd var/www/leed && php action.php >> logs/cron.log 2>&1

It will refresh your feeds every hour.

That’s all! You should now have a working Leed RSS Reader, so don’t forget to add my RSS feed!!

 

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/leed 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 leed (In root):

nano /etc/apache2/sites-enabled/leed

and paste/adapt the following content:

<VirtualHost *:80>
        ServerAdmin webmaster@domain.tld
        ServerName rss.domain.tld
        Redirect / https://rss.domain.tld
</VirtualHost>

<IfModule mod_ssl.c>
<VirtualHost *:443>
        SSLEngine on
        SSLCertificateFile /etc/ssl/certs/myblog.pem
        SSLCertificateKeyFile /etc/ssl/private/myblog.key

        ServerAdmin webmaster@domain.tld
        ServerName rss.domain.tld

        DocumentRoot /var/www/leed
        <Directory />
                Options FollowSymLinks
                AllowOverride All
        </Directory>
        <Directory /var/www/leed>
                Options Indexes FollowSymLinks MultiViews
                AllowOverride All
                Order allow,deny
                allow from all
        </Directory>
</VirtualHost>
</IfModule>

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

The first part will redirect all the connection from port 80 (HTTP) to port HTTPS (port 443) to force secure connection. If so, please configure your SSL certificate.

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

/etc/init.d/apache2 reload

You should now be all set!

Gravatar

Loves to discover web-based apps to install on his own server@home and write articles about it

0 Comments:

Add a comment