Installing Tiny Tiny RSS on macOS

Prerequisites

Before proceeding, you need to have some software installed on your system. You will need the following:

• Homebrew
• Mysql / MariaDB
• Git

Step 1: Install Homebrew

Homebrew is a free and open-source package manager for macOS. To install it, you can run the following command in your terminal:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Step 2: Install Mysql / MariaDB

You can choose to install Mysql or MariaDB as a database for Tiny Tiny RSS. Run the following command to install Mysql:

brew install mysql

Or, run this command to install MariaDB:

brew install mariadb

Step 3: Install PHP

Tiny Tiny RSS requires PHP along with some PHP extensions. You can install PHP 7.2 with the required extensions using Homebrew by running the following commands:

brew install php@7.2
brew install php72-intl php72-mcrypt php72-mbstring php72-gd php72-curl php72-opcache

Step 4: Download and Install Tiny Tiny RSS

Clone the Tiny Tiny RSS repository using Git:

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

Next, we need to create a new database for Tiny Tiny RSS. Open up your terminal and type:

mysql -u root -p

Enter your MySQL root password to log in to MySQL server.

Then, type the following commands to create a new database:

CREATE DATABASE ttrss;
GRANT ALL PRIVILEGES ON ttrss.* TO 'ttrss'@'localhost' IDENTIFIED BY 'yourpassword';
FLUSH PRIVILEGES;

Finally, navigate to the directory where the Tiny Tiny RSS repository was cloned and rename the config.php-dist file to config.php.

Edit the newly renamed file and modify the database settings:

define('DB_TYPE', 'mysql');
define('DB_HOST', 'localhost');
define('DB_USER', 'ttrss');
define('DB_NAME', 'ttrss');
define('DB_PASS', 'yourpassword');

Step 5: Start Tiny Tiny RSS Web Server

Tiny Tiny RSS comes with a built-in PHP web server which can be used for testing or for production use if you don't have a web server installed. To start the web server, navigate to the directory where you downloaded the repository and run:

php -S localhost:8000

Open up your web browser and go to localhost:8000. If everything is set up correctly, you should see the Tiny Tiny RSS login page.

Step 6: Create Tiny Tiny RSS Admin User

To create an admin user, register a new user on the login page. Once you have registered your user, navigate to your terminal and run the following commands:

cd /path/to/tt-rss
php ./update.php --create-user yourusername yourpassword ADMIN

Replace "yourusername" and "yourpassword" with the values you provided when registering.

Conclusion

You have now successfully installed Tiny Tiny RSS on your macOS machine. You can now add and read all of your RSS feeds in one convenient location. Enjoy!

If you want to self-host in an easy, hands free way, need an external IP address, or simply want your data in your own hands, give IPv6.rs a try!

Alternatively, for the best virtual desktop, try Shells!