How to Self-Host FreshRSS on a VPS (Complete Guide)

FreshRSS is a self-hosted RSS feed reader that allows you to aggregate and manage your feeds seamlessly. In this guide, you will learn how to install and configure FreshRSS on a VPS. We will cover both traditional installation methods and using Docker for those who prefer containerization.

Step-by-Step Installation

Prerequisites

1. VPS Hosting: Choose a VPS provider. You can refer to the following table for basic pricing:

2. Server Access: SSH access to your VPS is essential. Ensure you have a terminal application such as PuTTY or use the terminal on your Linux/Mac system.

3. Basic Knowledge: Familiarity with Linux command line is necessary.

Installing FreshRSS Manually

1. Connect to your VPS:

   ssh username@your_vps_ip

2. Update Your System:

   sudo apt update && sudo apt upgrade -y

3. Install Required Packages: You will need PHP, a web server (Apache or Nginx), and a database (MySQL or SQLite). For example, you can install Apache and MySQL using:

   sudo apt install apache2 php php-mysql mysql-server

4. Download FreshRSS:

   cd /var/www/html
   sudo git clone https://github.com/FreshRSS/FreshRSS.git

5. Set Directory Permissions:

   sudo chown -R www-data:www-data FreshRSS
   sudo chmod -R 755 FreshRSS

6. Configure the Database: Access MySQL and create a database and user:

   CREATE DATABASE freshrss;
   CREATE USER 'freshrssuser'@'localhost' IDENTIFIED BY 'password';
   GRANT ALL PRIVILEGES ON freshrss.* TO 'freshrssuser'@'localhost';
   FLUSH PRIVILEGES;
   EXIT;

7. Configure FreshRSS: Navigate to http://your_vps_ip/FreshRSS in your browser and follow the installation wizard. Input database details, and complete the process.

Installing FreshRSS Using Docker

If you prefer containerization, Docker makes the process even simpler.

1. Install Docker:

   sudo apt install docker.io
   sudo systemctl start docker
   sudo systemctl enable docker

2. Run FreshRSS with Docker:

   docker run -d \
   -p 9279:80 \
   -v freshrss_data:/var/www/FreshRSS/data \
   --name freshrss \
   freshrss/freshrss

3. Access FreshRSS: Open your browser and navigate to http://your_vps_ip:9279. Follow the on-screen instructions to configure your FreshRSS instance.

Configuring FreshRSS

Once installed, you will want to configure FreshRSS settings for optimal performance.

• User Administration: Create user accounts as necessary and configure your feed sources.
• Performance: You can schedule background tasks for fetching feeds. This will ensure your feeds are up-to-date without manual intervention.

FAQs

Is FreshRSS secure for self-hosting?

Absolutely. FreshRSS allows you complete control over your data by hosting it yourself. You can enable HTTPS using Let’s Encrypt for added security. Always ensure your software is up-to-date to protect against vulnerabilities.

Can I customize FreshRSS?

Yes, FreshRSS is open-source, and you can customize it to suit your needs. You can modify themes, and templates, and even create custom extensions if you’re comfortable with PHP. Refer to the awesome-selfhosted list for more inspirations on customization.

How does using Docker simplify installation?

Using Docker abstracts away the complexities of software dependencies and environment configurations. You can quickly deploy FreshRSS without worrying about PHP or database versions. Additionally, Docker containers can be easily backed up, migrated, or scaled based on your needs.

Conclusion

Self-hosting FreshRSS on a VPS is a straightforward process whether you choose manual installation or Docker. Both methods are efficient for developers and homelabbers looking to manage their own RSS feeds. By using the VPS providers mentioned, you can find a cost-effective solution that meets your requirements. For a complete VPS comparison, check out our full VPS comparison.