Tiny Tiny RSS is an open source web-based news feed (RSS/Atom) reader and aggregator, designed to allow you to read news from any location, while feeling as close to a real desktop application as possible.


1. Install the depencies

For ubuntu they are:

sudo apt-get install apache2 git
sudo apt-get install php5 php5-mysql php-apc
sudo apt-get install mariadb-server

2. Configure MySQL


I disabled/removed everything except remote root login because I don't know if breaks mysql access over ssh. During the process it will prompt for the root password. Choose something strong and keep it save.

Now login to mysql:

sudo mysql -u root -p

within mysql:

mysql> CREATE USER 'ttrss'@'localhost' IDENTIFIED BY 'strongpassword';
mysql> CREATE DATABASE ttrssdb;
mysql> GRANT ALL ON ttrssdb.* TO 'ttrss'@'localhost';
mysql> exit

3. Install ttrss

Download ttrss with git into your prefered folder in the webroot. E.g. /var/www/html/ttrss

cd /var/www/html/
sudo git clone ttrss

And change the user to the webserver:

sudo chown -R www-data:www-data /var/www/html/ttrss

4. Continue with the web installer

Proceed with the installation using the easy installer. It will ask your database credentials and a full URL on which tt-rss will be accessed, for example It is required that the URL is an externally accessible one (if any), don't use localhost there, it will break PUSH support. The default admin login is "admin" and "password" for the password.

5. Background updates

To allow automatic background updates of TTRSS we will add a Systemd Unit file. Create a .service file in /etc/systemd/system. I will call mine ttrss.service.

Now add this lines to it:

Description=ttrss_backend mysql.service postgresql.service



Save and exit it. Now we can start and test it with this commands:

systemctl start ttrss
systemctl status ttrss

If everything works like it should we enable it so that it starts after a reboot.

systemctl enable ttrss

6. Configure ttrss

Now go to and login with the default credentials:

user: admin
password: password

Here you can adjust the prefences to your liking. Make sure that you change the admin password.


I recommend that you check out the ssl tutorial to ensure that your webmail application is save.


Revision #1
Created Sat, Feb 9, 2019 12:16 PM by Andreas Zweili
Updated Tue, Feb 12, 2019 10:33 AM by Andreas Zweili