tt_rss

xsrv.tt-rss

This role will install Tiny Tiny RSS, a web-based News feed reader and aggregator.

A feed reader allows subscribing to many blogs/websites updates (using the RSS/ATOM standard), and access all articles in a single, unified application. It comes with extensive fiiltering/sorting/searching/presentation options, and plugins to improve integration of content from subscribed pages.

• Homepage/features
• Community/forums

Requirements/dependencies/example playbook

See meta/main.yml

# playbook.yml
- hosts: my.CHANGEME.org
  roles:
    - nodiscc.xsrv.common # bruteforce prevention
    - nodiscc.xsrv.monitoring # (optional)
    - nodiscc.xsrv.backup # (optional) automatic backups
    - nodiscc.xsrv.postgresql # database engine
    - nodiscc.xsrv.apache # webserver, PHP interpreter and SSL certificates
    - nodiscc.xsrv.tt_rss

# host_vars/my.CHANGEME.org/my.CHANGEME.org.yml  
tt_rss_fqdn: "rss.CHANGEME.org"

# ansible-vault edit host_vars/my.example.org/my.example.org.vault.yml
tt_rss_user: "CHANGEME"
tt_rss_password: "CHANGEME"
tt_rss_db_password: "CHANGEME"
tt_rss_password_salt: "CHANGEME"

See defaults/main.yml for all configuration variables

Usage

Clients

Tiny Tiny RSS can be accessed through:

• a web browser
• TTRSS-Reader (Android)
• Liferea (Linux)
• Awesome RSS Firefox extension

Backups

See the included rsnapshot configuration for the backup role.

To restore backups:

# remove the file indicating the database is populated
sudo rm /etc/ansible/facts.d/tt_rss.fact

# remove cached database credentials
sudo rm /root/tt_rss_admin_user_info.sql

# remove the application
sudo rm -r /var/www/my.example.com/tt-rss/

# remove the database and user
sudo -u postgres psql -c "DROP DATABASE ttrss; DROP USER ttrss;"

# from the ansible controller, reinstall the application, eg. ansible-playbook playbook.yml

# restore database backups
sudo -u postgres pg_restore /var/backups/rsnapshot/daily.0/localhost/var/backups/postgresql/ttrss.sql

Upgrades

Re-apply the role on a regular basis to ensure the application stays up to date.

_Note: due to TT-RSS "rolling" release model (always install the latest master branch), the role may upgrade the application without warning. Pin tt_rss_version to a specific commit hash from https://git.tt-rss.org/fox/tt-rss/commits/branch/master if you need to prevent this (but remember to update it manually/periodically).

License

GNU GPLv3

References

• https://stdout.root.sx/links/?searchtag=rss