Tiny Tiny RSS
=============

Upgrade
-------

+----+-----------------------------------------------------------------------------------------+-----------------------------------------------------+
| Id | Reference                                                                               | License                                             |
+----+-----------------------------------------------------------------------------------------+-----------------------------------------------------+
| 1  | https://wiki.archlinux.org/title/Tiny_Tiny_RSS#Pacman_hook                              | GNU Free Documentation License 1.3 or later [#f1]_  |
+----+-----------------------------------------------------------------------------------------+-----------------------------------------------------+

+--------------+
| Run as user  |
+--------------+
| ``root``     |
+--------------+

Updating to a major TT-RSS version requires a database migration. This happens for example when
you upgrade from Debian 10 (TT-RSS 18) to Debian 11 (TT-RSS 21)

#. make a backup of the database
#. update TT-RSS

   .. code-block:: shell-session

      sudo -u www-data -- /usr/bin/php /usr/share/tt-rss/www/update.php --update-schema=force-yes

Torification
------------

+----+-----------------------------------------------------------------------------------------+-----------------------------------------------------+
| Id | Reference                                                                               | License                                             |
+----+-----------------------------------------------------------------------------------------+-----------------------------------------------------+
| 2  | https://blog.franco.net.eu.org/notes/tt-rss-torification.html                           | CC BY-SA 4.0 [#f2]_                                 |
+----+-----------------------------------------------------------------------------------------+-----------------------------------------------------+

+--------------+
| Run as user  |
+--------------+
| ``root``     |
+--------------+

TT-RSS can download all feeds through TOR.

.. important:: Some websites actively block TOR exit node addresses. In this case you will need
               to configure an RSS bridge/proxy which can be simply a script that downloads
               the RSS XML file through clearnet. This file must then be served on a system
               that is accessible to your TT-RSS instance.

#. install TOR and Privoxy

   .. code-block:: shell-session

      apt-get install tor privoxy

#. Check that TOR is running

   .. code-block:: shell-session

      systemctl status tor@default.service

#. configure Privoxy. Add this content to the
   :download:`configuration file <includes/etc/privoxy/config>`

   .. literalinclude:: includes/etc/privoxy/config
      :language: ini
      :linenos:
      :caption: /etc/privoxy/config

   .. note:: You can add more forwarding rules to ignore routing the
             traffic through TOR for specific domains. Have a look
             at the ``/etc/privoxy/config`` file provided
             by the package which is well documented.

#. append the following at the end of
   :download:`TT-RSS's configuration file <includes/etc/tt-rss/config.php>`

   .. literalinclude:: includes/etc/tt-rss/config.php
      :language: php
      :linenos:
      :caption: /etc/tt-rss/config.php

   These variables should cover recent TT-RSS versions.

#. restart the services

   .. code-block:: shell-session

      systemctl restart tt-rss privoxy ${webserver}

.. rubric:: Footnotes

.. [#f1] Copyright (c) ArchWiki contributors
.. [#f2] Copyright (c) 2021 Franco Masotti