How to install Tiny Tiny RSS on OpenBSD

Tiny Tiny RSS is a web-based news feed aggregator that allows users to customize and read their news sources in one place. In this guide, we will walk you through the steps required to install Tiny Tiny RSS on OpenBSD.

Prerequisites

Before you start the installation process, make sure you have the following prerequisites:

• OpenBSD installed with root access
• Basic knowledge of OpenBSD and command line

Step 1: Install Dependencies

The first step is to install the necessary dependencies required by Tiny Tiny RSS. To do this, run the following commands in your terminal:

$ doas pkg_add php php-fpm php-curl php-intl php-pdo-pgsql postgresql-server postgresql-contrib

Step 2: Configure PostgreSQL

By default, PostgreSQL is not enabled on OpenBSD. To enable and configure PostgreSQL, run the following commands:

$ doas rcctl enable postgresql
$ doas rcctl start postgresql
$ su - _postgresql
$ createdb -E UTF8 ttrss
$ createuser ttrss
$ exit

Step 3: Download and Install Tiny Tiny RSS

Once the dependencies and PostgreSQL are installed and configured, we can proceed with the installation of Tiny Tiny RSS. To do this, run the following commands:

$ cd /var/www/htdocs
$ doas ftp https://git.tt-rss.org/fox/tt-rss/archive/master.tar.gz
$ doas tar xvf master.tar.gz
$ doas mv tt-rss-master tt-rss
$ doas chown -R www:www tt-rss
$ doas cp -p tt-rss/config.php-dist tt-rss/config.php

Step 4: Configure Tiny Tiny RSS

In the previous step, we copied the config.php-dist file and renamed it to config.php. Now, we need to edit this file to configure Tiny Tiny RSS. Run the following command to edit the file:

$ doas vi /var/www/htdocs/tt-rss/config.php

In the file, look for the following line:

define('DB_TYPE', "pgsql");

Uncomment this line by removing the // at the beginning and replace the pgsql with pgsql7. Save and close the file.

Step 5: Enable and Start PHP-FPM

To enable and start PHP-FPM, run the following commands:

$ doas rcctl enable php73_fpm
$ doas rcctl start php73_fpm

Step 6: Configure HTTP Server

Tiny Tiny RSS is a web application, so we need to configure an HTTP server, such as Apache or Nginx. In this guide, we will use httpd. Run the following command to edit the httpd configuration file:

$ doas vi /etc/httpd.conf

Add the following lines at the end of the file:

server "ttrss" {
	listen on * port 80
	root "/htdocs/tt-rss"
	location ".php" {
		fastcgi socket "/run/php73_fpm.sock"
	}
}

Save and close the file. Now, restart the httpd service for the changes to take effect:

$ doas rcctl restart httpd

Step 7: Access Tiny Tiny RSS

Tiny Tiny RSS is now installed and configured on your OpenBSD server. You can access it by opening a web browser on your local machine and entering the URL http://<server-ip>/tt-rss in the address bar, replacing <server-ip> with the IP address of your OpenBSD server.

Conclusion

Congratulations! You have successfully installed Tiny Tiny RSS on OpenBSD. You can now configure your preferred news sources and start using the application to stay up-to-date with your favorite content.