Ubuntu Server – Installing Tiny Tiny RSS

ubuntu-server-logo

I have been using Gregarius as my web-based RSS aggregator for quite some time now but have wanted to try Tiny Tiny RSS for a while.

Now that WebUpd8 have created a PPA (Personal Package Archives) for Tiny Tiny RSS I really had no excuse for not installing it.

Note: I am installing Tiny Tiny RSS on Ubuntu Server 12.04. PPAs have been available for Ubuntu since Ubuntu 9.10 – so this will not work on prior editions of Ubuntu Server.

The first step is to update our repositories and install Apache and MySQL:

sudo apt-get update
sudo apt-get install mysql-server mysql-client apache2 libapache2-mod-php5

When prompted enter a password for your MySQL root user:

MySQL Password

Confirm your MySQL password:

Confirm MySQL Password

Now that we have our prerequisites installed we can add the Tiny Tiny RSS PPA.

Note: On a minimal virtual machine installation of Ubuntu Server we need to install the  python-software-properties package to be able to add a PPA:

sudo apt-get install python-software-properties

Add the Tiny Tiny RSS PPA:

sudo add-apt-repository ppa:webupd8team/tt-rss
sudo apt-get update
sudo apt-get install tt-rss

Set Apache as the Tiny Tiny RSS web server:

tt-rss apache

Set the URL for the Tiny Tiny RSS installation – for a local install on my LAN i used http://localhost/tt-rss/:

tt-rss url

Select Yes for database configuration:

tt-rss database config

Confirm MySQL as the database for Tiny Tiny RSS:

tt-rss database mysql

Enter your root MySQL password:

tt-rss root mysql password

Enter a password for Tiny Tiny RSS to register with MySQL – a random password will be generated if left blank:

tt-rss application password

Confirm your application password:

tt-rss confirm application password

Next we need to use nano to edit some configuration files.

First we need to edit our server address in /etc/tt-rss/config.php:

sudo nano /etc/tt-rss/config.php

Find the line  define('SELF_URL_PATH', 'http://yourserver/tt-rss/'); and change it to  define('SELF_URL_PATH', 'http://localhost/tt-rss/'); (as per the server address that we set previously):

tt-rss config.php

Press Ctrl + O then Enter to save the changes to config.php and then Ctrl +X to exit nano.

To get Tiny Tiny RSS to update feeds we need to edit /etc/default/tt-rss:

sudo nano /etc/default/tt-rss

Change DISABLED=1 to DISABLED=0 to allow the Tiny Tiny RSS daemon to be started:

tt-rss tt-rss

Press Ctrl + O then Enter to save the changes to config.php and then Ctrl +X to exit nano.

Start the Tiny Tiny RSS service:

sudo service tt-rss start

Obtain the IP address of your Ubuntu Server installation:

ipconfig

tt-rss ifconfig

Open a browser on another machine and navigate to your Tiny Tiny RSS URL:

tt-rss login

Login with the username: admin and the password: password.

Click Actions, Preferences and Users to change your admin password and add users. You can import feeds under the Feeds tab or click Exit Preferences and then Actions, Subscribe to feed to add feeds manually.

Source: http://www.webupd8.org/2013/05/tiny-tiny-rss-ubuntu-ppa-google-reader.html

Ubuntu Server – Installing Gregarius, a Web-based RSS Aggregator

Gregarius is a Web-based RSS, RDF, and ATOM news aggregator that will allow you to access your news feeds from anywhere (if you so desire).

I installed Gregarius in an Ubuntu Server minimal virtual machine on VMware ESXi. During the installation I elected to install the LAMP webserver and SSH roles.

To install Gregarius download it from here and then copy it to the home directory on your server.

Install unzip and extract the Gregarius download:

sudo apt-get update
sudo apt-get install unzip
unzip gregarius-*.zip

You will now see a folder called gregarius in your home directory. I chose to rename the folder to rss:

mv gregarius rss

Copy the rss folder to your Apache web directory:

sudo cp -R rss /var/www/rss

At this point I needed to edit php.conf so that I could open .php files in a browser and create a virtual host. I have previously covered editing php.conf here and how to install Webmin here.

With Webmin installed creating a virtual host is a simple process.

In Webmin click Servers and Apache Webserver in the left hand menu – then click the Create virtual host tab.

Click the file browser button for the Document Root field and then navigate to /var/www/rss and then click OK. Click the Create Now button.

Open a browser and begin installation of Gregarius: http://<server-ip>/rss.

Gregarius will notify you of any un-met requirements, but I did not experience any issues here:

The next step is to enter settings for the Gregarius database. For database UserName and Password enter a username and password of your choice. For the Database Table Prefix I entered rss.

To allow Gregarius to create a database for you enter root as the Admin UserName and your MySQL password as the Admin Password.

Note: The MySQL password was defined during the installation of the LAMP role earlier.

Scroll to the bottom of the page and click the Download dbinit.php file button. Save the file and upload dbinit.php to the home directory on your server and then copy it to /var/www/rss/:

sudo cp dbinit.php /var/www/rss

As dbinit.php contains your MySQL password you should delete the file from your home directory:

rm dbinit.php

Now open a browser and browse to: http://<server-ip>/rss/index.php.

Click on the Admin button and define a username and password.

Log in and click the Feeds button.

Note: You should be able to access Gregarius using the following URL from now on: http://<server-ip>/rss

To add this site as a feed, for example, just copy and paste the feed URL https://pricklytech.wordpress.com/feed/ into the Add a feed field and then click the Add button:

Click the Home button and you will be able to see your feeds:

The only issue that I have experienced is that Gregarius takes some time respond every time I click the Admin button. After that the application seems to respond quite well though. My workaround was to bookmark the Feeds page, which allowed me to add feeds much more quickly that clicking Admin followed by Feeds.

I am quite looking forward to accessing my feeds without having a local client installed on any of my machines …

Update: Since adding more feeds I encountered an issue and could not browse my feeds, even though they were listed. The quick fix was to edit the rss.output.usemodrewrite setting and set its value to false. This setting can be found here: http://<server-ip>/rss/admin/index.php?view=config. See here for more details.