How to use FreshRSS feed reader

You know that feeling when you open your browser, and somehow you've got 47 tabs open, and each one is a different blog, news site, or forum you wanted to check? RSS was supposed to fix that. And FreshRSS is one of the best modern tools for bringing that fix back into your life.

In this guide, you'll learn what FreshRSS actually is, how to set it up, and how to turn it into a personal news hub that works exactly the way you want. No algorithm, no doomscrolling, no endless recommendation feeds. Just the content you chose, delivered to one place.

What Is FreshRSS, Anyway?

FreshRSS is a self-hosted RSS feed aggregator. In plain terms, it's a web application you run on your own server that collects articles from websites you follow and displays them in a clean, unified reading interface.

But what does that actually mean?

Think of RSS (Really Simple Syndication) as a notification system for the web. When a website publishes something new, its RSS feed gets updated. A feed reader—like FreshRSS—checks those feeds regularly, grabs new posts, and shows them to you in one organized stream.

The key difference between FreshRSS and something like a social media feed is control. You pick the sources. You decide the order. You choose what gets marked as read. No one is optimizing for your attention except you.

Why Self-Host FreshRSS?

You might be wondering why you'd run your own feed reader when there are plenty of hosted options out there. Here's why self-hosting matters:

Self-hosting FreshRSS also means you can access it from any device with a browser. It's your personal newsroom, available everywhere.

Setting Up FreshRSS

Prerequisites

Before you start, you'll need:

• A server or hosting environment (a VPS, home server, or a managed hosting platform)
• PHP 7.4 or higher (or a platform that handles this for you)
• A domain or subdomain pointing to your server
• Basic comfort with web applications

If you're on a managed platform like SonicBit, deployment is literally one click. But let's walk through the general process so you understand what's happening behind the scenes.

Installation Methods

There are two main ways to install FreshRSS:

Method 1: Docker Deployment

If you're comfortable with Docker, this is the cleanest approach:

docker run -d \
  --name freshrss \
  -p 8080:80 \
  -v /path/to/data:/var/www/FreshRSS/data \
  freshrss/freshrss:latest

This command pulls the official FreshRSS image, starts it as a detached container, maps port 8080 on your host to port 80 in the container, and mounts a persistent volume for your data.

Once it's running, open http://your-server-ip:8080 in your browser and follow the web installer.

Method 2: Manual Installation

If you prefer installing directly on your server:

## Download the latest release
wget https://github.com/FreshRSS/FreshRSS/archive/latest.tar.gz

## Extract the archive
tar -xzf latest.tar.gz

## Move to your web directory
sudo mv FreshRSS-latest/ /var/www/freshrss

## Set permissions
sudo chown -R www-data:www-data /var/www/freshrss/data

After that, point your web server (Nginx, Apache, or Caddy) to the FreshRSS directory and visit your domain to complete the setup wizard.

Initial Configuration

When you first open FreshRSS, the setup wizard walks you through:

1. Language selection – FreshRSS supports dozens of languages
2. Database choice – SQLite is simplest for single-user setups, MySQL/MariaDB for larger deployments
3. Admin account creation – Set your username and password
4. Authentication method – Basic HTTP auth, form-based login, or no auth for private networks

Once the wizard completes, you'll land in the FreshRSS dashboard with a default feed or two already added. Now the real fun begins.

Adding Your First Feeds

This is where FreshRSS becomes yours. You need to tell it what to follow.

Finding RSS Feeds

Most websites still have RSS feeds, even if they don't advertise them prominently. Here's how to find them:

• Look for the RSS icon – That orange square with white radio waves is the universal symbol
• Check common URL patterns – Many sites use /feed, /rss, or /atom.xml
• Use browser extensions – Extensions like "RSS Subscription Extension" can detect feeds automatically
• Try the site URL directly – FreshRSS has a feed discovery feature that can find feeds from a homepage URL

Adding a Feed in FreshRSS

Once you have a feed URL, adding it is straightforward:

1. Click the + (plus) icon in the left sidebar
2. Paste the feed URL
3. Click Add
4. FreshRSS fetches the feed and shows a preview
5. Assign it to a category (or create a new one)
6. Click Submit

Here's a tip: create categories before adding lots of feeds. Categories like "Tech News," "Personal Blogs," "Comics," or "YouTube Channels" make browsing much easier.

Organizing with Categories

Categories in FreshRSS work like folders. They group related feeds together so you can:

• Read all feeds in a category at once
• Filter your main stream by category
• Apply different settings to different categories

For example, you might have a "News" category that you check daily, a "Slow Reads" category for long-form essays you save for weekends, and a "Firehose" category for high-volume sources you only skim.

Reading and Managing Your Feeds

The Reading Experience

FreshRSS offers multiple reading views:

• Normal view – Shows article titles and excerpts in a list, click to expand
• Global view – Shows full articles from all feeds in one continuous stream
• Reader view – Fetches the full article content, even from truncated feeds, and strips away ads and clutter

The Reader view is a game-changer. Many sites only include partial content in their RSS feeds to force you to visit their site. FreshRSS can often retrieve the full article anyway, giving you a clean, distraction-free reading experience.

Keyboard Shortcuts

If you want to speed through your feeds, FreshRSS has excellent keyboard support:

Learning even a handful of these shortcuts makes processing hundreds of articles feel effortless.

Filters and Search

FreshRSS includes a powerful filtering system. You can create custom filters that show:

• Only unread articles
• Articles with specific keywords
• Articles from certain categories
• Starred items only
• Articles published in the last 24 hours

The search function also supports boolean operators, so you can do things like:

linux AND (server OR self-hosted) NOT windows

This level of control means you can build custom views for different reading moods.

Advanced Features Worth Knowing

User Queries

User Queries are saved filters that appear in your sidebar. They're like smart folders that update automatically.

For example, create a User Query that shows only articles containing "Raspberry Pi" from all your tech feeds. Or one that displays starred articles from the last week so you can revisit things you saved.

To create one, click the menu next to the search bar and select "Save as query." Give it a name, and it appears in your sidebar.

Extensions

FreshRSS has an extension system that adds functionality without bloating the core app. Some popular extensions include:

• Auto-Refresh – Automatically reload feeds at intervals
• Reading Time – Estimates how long each article takes to read
• Share with Pocket – Send articles to Pocket for later reading
• Custom CSS – Override the theme with your own styles
• Image Proxy – Load images through a proxy for privacy

You can browse and install extensions from the FreshRSS settings menu. Each extension is a simple ZIP file you upload, no command line needed.

Mobile Access

FreshRSS is a web app first, but it works beautifully on mobile browsers. The responsive design adapts to small screens, and you can even install it as a Progressive Web App (PWA) on Android and iOS for a native-app feel.

There are also third-party mobile apps that connect to FreshRSS via its API. Apps like Readrops (Android) and Fiery Feeds (iOS) sync with your FreshRSS instance, giving you offline reading and native notifications.

Multi-User Support

FreshRSS isn't just for individuals. It supports multiple users, each with their own feeds, categories, and reading history. If you have a family or a small team, one FreshRSS instance can serve everyone.

The admin user can create accounts, set permissions, and manage system-wide settings from the admin panel. Each user gets their own isolated reading experience.

Tips for a Better FreshRSS Experience

After using FreshRSS for a while, you'll develop your own workflow. Here are some tips to get there faster:

1. Start small – Add 10-15 feeds, not 100. You can always add more later
2. Use categories from day one – It's much harder to reorganize later
3. Be aggressive with mark-as-read – Don't feel obligated to read everything
4. Star liberally – Stars are for articles you want to reference later
5. Schedule your reading – Check FreshRSS at set times instead of constantly refreshing
6. Trim feeds monthly – Remove sources that don't consistently deliver value
7. Explore the settings – FreshRSS has dozens of options you might miss at first

Conclusion

FreshRSS brings back the promise of RSS: a clean, personal reading space where you're in control. It takes a little effort to set up and curate, but once it's running, it becomes one of those tools you wonder how you lived without.

The self-hosting aspect is what makes FreshRSS special. You're not dependent on a company's goodwill or a service's uptime. Your feeds, your history, your preferences—they all live on infrastructure you control.

If you want to get started with FreshRSS without dealing with server management, platforms like SonicBit make it easy. SonicBit offers one-click app deployment for FreshRSS alongside other self-hosted apps, so you don't need to touch Docker commands or configure reverse proxies manually. You get a managed environment with automatic SSL, a web dashboard for management, and the freedom to run FreshRSS alongside other tools like Plex, Jellyfin, or Nextcloud. It's a practical way to enjoy self-hosting without the sysadmin overhead.

Sign up free at SonicBit.net and get 4GB storage. Download our app on Android and iOS to access your seedbox on the go.