← Back to wiki index

Installation Guide

Installing Tiny Tiny RSS for the first time

Installing in a Docker container (using docker-compose)

You will need access to a server running Docker, with docker-compose installed and available to use. Setting those up is beyond the scope of this guide. Basic Docker knowledge is required.

Container scripts are under development and not fully tested yet. Some features may be broken or not implemented. As an alternative you can use one of the available third party containers or continue to a host installation section below.

Docker scripts and installation guide

Installing on a host machine

Before you begin, you’ll need to verify the following:

Host installation overview

git clone https://git.tt-rss.org/fox/tt-rss.git tt-rss

Alternatively, you can clone the repository on your local machine and upload files to the server using FTP or any other means available to you.

Don’t forget to read UpdatingFeeds otherwise your feeds won’t update automatically.

See also: SecuringCacheDirectories

Take a look at available plugins

There are many plugins written for tt-rss. You can see the list here: Plugins.

Upgrading Tiny Tiny RSS

It is highly recommended to temporarily disable any third party themes and user CSS customizations before upgrading. Don’t forget to empty your browser cache if you experience weird bugs right after upgrading.

Note that you should upgrade to the latest version available, installing intermediate releases sequentially is not needed.

Upgrading with Git

Update base tt-rss code

Change to tt-rss directory on your server and run git pull origin master.

Merge new config.php directives and/or update the database

After the files have been upgraded to newer versions, open tt-rss. It may complain about missing directives in config.php. If that happens, you will need to either merge new stuff from config.php-dist to your config.php or remove config.php and rerun the installer.

DO NOT INITIALIZE DATABASE when upgrading. This will remove all your tt-rss data.

Afterwards, you may be redirected to the database updater. Log in with admin credentials and follow instructions.

Finishing that, you should be able to use tt-rss normally by logging in with your normal account.

Post-upgrade tasks

  1. You might need to clear your browser cache if you experience CSS or script-related issues, older scripts might have stuck in it.
  2. Do not copy cache directories from your old tt-rss version, it is unnecessary and potentially creates problems if you don’t preserve file modification times.
  3. If you are using an accelerator like php-apc you might need to restart apache if older cached versions of PHP files got stuck in cache (this happens rarely, but is a possibility).

Generated at Sat Dec 7 06:18:20 UTC 2019