A server or some web space

Multiple update options to help you save server load, or allow feeds to update even when you’re not looking

Highly customisable to work like Google Reader, or any other feed reader you might prefer

Recover all your own feeds from Google Reader, or make some new ones for your own feed reader

01

On your web space or server, make sure you have a user account that can access the space or server via SSH, as we’ll be setting up Tiny Tiny RSS over an SSH connection at fi rst. Usually, you’ll be able to then log in at the terminal with: $ ssh [email protected]

…by entering the relevant password.

02

Some web hosts have their own database creation tools, but if you’re managing it yourself you’ll have to create it in the command line. Create our new database with:

$ mysql -u root -p -h mysqlhost.mydomain. com CREATE DATABASE mydomain_ttrss

…replacing mysqlhost and mydomain with your relevant information.

04

Download the latest tarball of Tiny Tiny RSS from the feed reader’s website, then make sure to extract it. We’ll use specifi c fi les from here to fi nish the database creation, then set up the rest of Tiny Tiny RSS with it.

03

You’ll also need a user connected to the database. Most GUI tools will do this automatically; otherwise set it up with:

$ mysql -u root -p -h mysqlhost.mydomain. com GRANT alter,create,delete,drop,inse rt,update,select ON mydomain_ttrss.* TO [username] IDENTIFIED BY [password]

05

Find the MySQL sql fi le in the scheme

06

You can alternatively upload the scheme using SSH – cd to the folder, log in via SSH and then use this command:

mysql -u [username] -D mydomain_ttrss -p -h mysqlhost.mydomain.com < schema/ttrss_ schema_mysql.sql

You’ll be prompted for the user’s password.

07

We’ll now need to edit the confi guration fi le that Tiny Tiny RSS uses to connect to the database and other services on your website, confi g.php-dist. Before we start messing around with it, make sure to create a copy so you can restore it and/or start again. You can fi nd it in the top level of the directory we extracted.

08

Rename the copied fi le to be confi g. php and then open it in a text editor. Edit the following lines with the relevant information:

09

Now set an URL that you’ll be installing Tiny Tiny RSS to. Scroll down to and locate: define(‘SELF_URL_PATH’, ‘http://example. org/tt-rss/’);

Change example.org to your domain name, and you can either keep tt-rss or choose something else – this is where you’re going to be installing Tiny Tiny RSS.

folder of fi les you just extracted. If you have phpMyAdmin or some other graphical MySQL interface, navigate there and import that fi le to the database we created. Click on Go once you’ve selected the fi le, and wait.

define(‘DB_TYPE’, “mysql”); define(‘DB_HOST’, “mysqlhost.mydomain. com”); define(‘DB_USER’, “[username]”); define(‘DB_NAME’, “mydomain_ttrss”); define(‘DB_PASS’, “[password]”); //define(‘DB_PORT’, ‘’);

12

Move the confi g fi le we created to your web space via FTP or a download method, or just edit the confi g fi le the same way we did earlier. You can also use a graphical FTP program to move the fi les to the space without having to do anything in the terminal.

13

Now we can log in. Go to the URL we specifi ed and you’ll see the login screen – for now, this will be admin and password. Once logged in, go to Actions>Preferences>Personal Data/Authentication and change the password.

15

Be aware that Tiny Tiny RSS won’t work

10

After you’ve saved the fi le, go back in the terminal and log into your web space. Create the tt-rss folder with:

$ mkdir tt-rss

Move into the directory, then download the latest version of Tiny Tiny RSS with:

$ wget https://github.com/gothfox/Tiny- Tiny-RSS/archive/1.9.tar.gz

11

Extract the fi les into the directory using the following:

$ tar -zxvf 1.9.tar.gz

Make sure that all the fi les extracted are moved from the folder created into the tt-rss parent folder, so that when we’re navigating there, it opens the right fi les.

14

If you still have the Takeout data from Google Reader, you can now import this into Tiny Tiny RSS. Go back to the Actions menu and click Feeds, then OPML. Click ‘Choose fi le’, navigate to your subscriptions.xml and then click Import. It will keep your folder structure if you had one.

like Google Reader right away, but you can exit the preferences to see how the rough layout is. Don’t be concerned if your feeds don’t show anything in them – we will be fi xing that in a bit. For now, if you double-click on the individual feeds in your folders, you can load up some of the latest entries. You can also start editing the way feed items are displayed, with oldest or newest fi rst and whether or not to show read items.