# Install FreshRSS RSS Aggregator on Debian/Ubuntu Linux

## What is FreshRSS?

> FreshRSS is a self-hosted RSS feed aggregator like Leed or Kriss Feed. It is lightweight, easy to work with, powerful, and customizable. It is a multi-user application with an anonymous reading mode. It supports custom tags. There is an API for (mobile) clients, and a Command-Line Interface. -https://github.com/FreshRSS/FreshRSS

## Installation

1. Log into the Linux based device
2. Run the following commands in the terminal
   # update software repositories
   sudo apt update
   # install available software updates
   sudo apt upgrade -y
   # install some dependencies
   sudo apt install git apt-transport-https ca-certificates curl -y
   # install Apache HTTPD and MySQL
   sudo apt install apache2 mariadb-server mariadb-client -y
   # install PHP components
   sudo apt install php php-curl php-gmp php-intl php-pdo-mysql php-mbstring php-xml php-zip php-ctype php-dom php-fileinfo php-iconv php-json php-simplexml php-xmlreader -y
   # configure the MySQL database
   sudo su
   mysql_secure_installation
3. Press Enter to login as root
4. Type Y and press Enter to set a root password, type the password twice to confirm
5. Type Y and press Enter to remove anonymous users
6. Type Y and press Enter to disallow root login remotely
7. Type Y and press Enter to remove the test database
8. Type Y and press Enter to reload privilege tables
9. Run the following command to login into MySQL:
   mysql -u root -p
10. Authenticate with the root password set earlier
11. Run the following commands to create the FreshRSS database and database user
    CREATE DATABASE freshrss DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
    GRANT ALL ON freshrss.* TO 'freshrss_rw'@'localhost' IDENTIFIED BY 'Fr3shRSS!!';
    FLUSH PRIVILEGES;
    EXIT;
    exit
12. Continue with the following commands to download and extract FreshRSS in the Apache webroot
    # download freshrss
    wget -O freshRSS.zip https://github.com/FreshRSS/FreshRSS/archive/master.zip
    # extract the zip file
    unzip freshRSS.zip
    # move the extracted folder to webroot
    sudo mv ./FreshRSS-master /var/www/html/freshrss
    # set permissions on the freshrss directory
    sudo chown -R www-data:www-data /var/www/html/freshrss
13. Open a web browser and navigate to http://DNSorIP/freshrss
14. Select a Language > Click Submit
15. Click the Go to the next step button
16. Complete the database configuration form as follows

    Type of database: MySQL
    Host: localhost
    Database username: freshrss_rw
    Database password: Fr3shRSS!!
    Database: freshrss
    Table prefix:

17. Click the Go to the next step button
18. Enter a username and password > Click Submit
19. Click the Complete Installation button
20. Login with the username created earlier
21. Welcome to FreshRSS

More Info: https://freshrss.org/