As 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.
Obviously, the best for you is to try their demo!
Interested? Here is how to install it on your server.
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.
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.
5) Set up a cron job to update regularly your feeds.
Access to the crontab file (in root)
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!!
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):
and paste/adapt the following content:
<VirtualHost *:80> ServerAdmin email@example.com 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 firstname.lastname@example.org 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)
You should now be all set!