Info
Content

TTRSS

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.

Setup

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

mysql_secure_installation

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> FLUSH PRIVILEGES;
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 https://tt-rss.org/git/tt-rss.git 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 http://your.site.com/tt-rss/. 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:

[Unit]
Description=ttrss_backend
After=network.target mysql.service postgresql.service

[Service]
User=www-data
ExecStart=/var/www/ttrss/update_daemon2.php

[Install]
WantedBy=multi-user.target

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 youraddress.net/ttrss 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.

Tipps

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

Links

No Comments
Back to top