How to put in TT-RSS on a Raspberry Pi

pmullins

5 years ago

Now that you realize what TT-RSS is and why you might wish to use it, I will clarify the whole lot it’s worthwhile to learn about putting in it on a Raspberry Pi or a Debian 10 server.

To set up TT-RSS on a Raspberry Pi, you could additionally set up and configure the newest model of PHP (7.Three as of this writing), PostgreSQL for the database backend, the Nginx net server, Git, and at last, TT-RSS.

1. Install PHP 7

Installing PHP 7 is, by far, probably the most concerned a part of this course of. Thankfully, it isn’t as troublesome as it’d seem. Start by putting in the next help packages:

$ sudo apt set up -y ca-certificates apt-transport-https

Now, add the repository PGP key:

$ wget -q https://packages.sury.org/php/apt.gpg -O- | sudo apt-key add -

Next, add the PHP repository to your apt sources:

$ echo "deb https://packages.sury.org/php/ buster main" | sudo tee /and many others/apt/sources.checklist.d/php.checklist

Then replace your repository index:

$ sudo apt replace

Finally, set up PHP 7.Three (or the newest model) and a few widespread parts:

$ sudo apt set up -y php7.Three php7.Three-cli php7.Three-fpm php7.Three-opcache php7.Three-curl php7.Three-mbstring php7.Three-pgsql php7.Three-zip php7.Three-xml php7.Three-gd php7.Three-intl

The command above assumes you are utilizing PostgreSQL as your database backend and installs php7.Three-pgsql. If you’d moderately use MySQL or MariaDB, you’ll be able to simply change this to php7.Three-mysql.

Next, confirm that PHP is put in and operating in your Raspberry Pi:

$ php -v

Now it is time to set up and configure the webserver.

2. Install Nginx

Nginx might be put in by way of apt with:

$ sudo apt set up -y nginx

Modify the default Nginx digital host configuration in order that the webserver will acknowledge PHP recordsdata and know what to do with them:

$ sudo nano /and many others/nginx/sites-available/default

You can safely delete the whole lot within the unique file and substitute it with:

server 

        pay attention 80 default_server;

        pay attention [::]:80 default_server;        root /var/www/html;
        index index.html index.htm index.php;
        server_name _;
        location / 
        location ~ .php$

Use Ctrl+O to save lots of your new configuration file after which Ctrl+X to exit Nano. You can check your new configuration with:

$ nginx -t

If there aren’t any errors, restart the Nginx service:

$ systemctl restart nginx

Three. Install PostgreSQL

Next up is putting in the database server. Installing PostgreSQL on the Raspberry Pi is tremendous simple:

$ sudo apt set up -y postgresql postgresql-client postgis

Check to see if the database server was efficiently put in by getting into:

$ psql --version

Before you are able to do anything, it’s worthwhile to create a database that the TT-RSS software program will use to retailer information. First, log into the PostgreSQL server:

sudo -u postgres psql

Next, create a brand new consumer and assign a password:

CREATE USER username WITH PASSWORD 'your_password' VALID UNTIL 'infinity';

Then create the database that will probably be utilized by TT-RSS:

CREATE DATABASE tinyrss;

Finally, grant full permissions to the brand new consumer:

GRANT ALL PRIVILEGES ON DATABASE tinyrss to user_name;

That’s it for the database. You can exit the psql app by typing q.

5. Install Git

Installing TT-RSS requires Git, so set up Git with:

$ sudo apt set up git -y

Now, change listing to wherever Nginx serves net pages:

$ cd /var/www/html

Then obtain the newest supply for TT-RSS:

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

Note that this course of creates a brand new tt-rss folder.

6. Install and configure Tiny Tiny RSS

It’s lastly time to put in and configure your new TT-RSS server. First, confirm that you may open http://your.site/tt-rss/install/index.php in an online browser. If you get a 403 Forbidden error, your permissions aren’t set correctly on the /var/www/html folder. The following will often repair this problem:

$ chmod 755 /var/www/html/ -v

If the whole lot goes as deliberate, you will see the TT-RSS Installer web page, and it’ll ask you for some database info. Just inform it the database username and password that you simply created earlier; the database title; localhost for the hostname; and 5432 for the port.

Click Test Configuration to proceed. If all went nicely, it’s best to see a pink button labeled Initialize Database. Click on it to start the set up. Once completed, you will have a configuration file that you may copy and save as config.php within the TT-RSS listing.

After ending with the installer, open your TT-RSS set up at http://yoursite/tt-rss/ and log in with the default credentials (username: admin, password: password). The system will advocate that you simply change the admin password as quickly as you log in. I extremely advocate that you simply observe that recommendation and alter it as quickly as attainable.

If all went nicely, you can begin utilizing TT-RSS immediately. It’s beneficial that you simply create a brand new non-admin consumer, log in as the brand new consumer, and begin importing your feeds, subscribing, and configuring it as you see match.

Finally, and that is tremendous essential, do not forget to learn the Updating Feeds part on TT-RSS’s wiki. It describes how you can create a easy systemd service that can replace your feeds. If you skip this step, your RSS feeds won’t replace robotically.

Conclusion

Whew! That was numerous work, however you probably did it! You now have your very personal RSS aggregation server. Want to study extra about TT-RSS? I like to recommend trying out the official FAQ, the support discussion board, and the detailed installation notes. Feel free to remark under when you have any questions or points.