Guides

Using a self-hosted feed reader

Running your own reader gives you the most control over your feeds. But do it wrong and it's also the best way to find out how many websites would rather you didn't.

What's a self-hosted reader?

A self-hosted feed reader is one you install and run yourself, whether that's on your own web server or on your laptop, desktop, or phone, even as a web browser extension. It gives you a level of control over your feeds you don't usually get with feed readers that aren't self-hosted.

Self-hosted vs. non self-hosted

Self-hosted readers Non self-hosted readers
How the reader gets your feeds Your device contacts each feed's website, the same way it would if you visited it in your web browser The company's servers contact the feed's website on your behalf
Who owns and controls your data Only you You own it on paper, but the company holds it, decides what happens to it, and can share it with whoever they choose
How much data can be stored As much as you want (or as much as your device can hold) Limited, and super old content usually drops off, though some readers may charge you to keep it around or access it
The data you can access Everything the reader stores, including your read history, saved items, and any tracking it does Whatever the company chooses to give you—it's on their terms, not yours—but privacy laws in some regions let you request more
Where the data's stored Anywhere you like On a server owned by the reader's company
Can you modify the reader software Usually, since most self-hosted readers are open source, though some licenses limit what you're allowed to do No
When something goes wrong You update the reader yourself, or wait for the developer to release a fix The company handles it, usually before you even notice
If you somehow lose your data It's gone forever, unless you kept a backup The company can usually restore it, unless they've shut down for good — though most let you export a backup in case they do

Some self-hosted readers

These are the self-hosted readers we know about, and how you can run them.

Reader Can be installed on Has non self-hosted version Open source
CommaFeed Chrome, Edge, Firefox Yes Yes
Feedbin Any device Yes Yes
FreshRSS Any device Yes Yes
miniflux Any device Yes Yes
NetNewsWire macOS, iOS, Safari No Yes
NewsBlur Android, macOS, iOS Yes Yes
rss2email Linux No Yes
Tiny Tiny RSS Android Yes Yes
Yarr Windows, Linux, macOS No No

Staying unblocked

Self-hosted readers get blocked more often than others and it's not really their fault. Each reader requests feed content on its own, so when thousands of people use the same reader, a website gets hit with thousands of separate requests for the exact same content, often at the same time.

Four self-hosted readers each send their own request to the same website, making four requests.

One well-behaved reader hitting a website for its feed is nothing. It's the pile-up of many of them that does the damage. And while big websites shrug it off, smaller ones with smaller budgets take the hit. But it's nothing new. Feed readers have been hammering websites since feeds were invented. It's practically tradition.

But when a reader isn't self-hosted, it can make smarter decisions about how it requests feeds. If several of its users need updates to the same feed, it only has to ask the website once, then share what it got with everyone else.

Four readers go through a company server that sends a single request to the website, making one request.

Unfortunately, self-hosted readers will keep overwhelming websites, since that's just how they work when a lot of people are using them at the same time. But you can still use one in a way that doesn't make the situation worse.

Keep the request frequency down

A reader's "poll frequency" is how often it checks a feed for new content. Setting it too high is one of the best ways to overwhelm the feed's website and one of the fastest ways to get blocked.

Websites usually tell you the frequency they'd prefer, either in their documentation or in the response they send back. Each website will have its own limits, but a good rule of thumb is:

  1. No more than one request to a feed per second, per website. For example, if you're subscribed to 4 feeds from the same website, your reader should check them one at a time, with at least a second between each request.
  2. Wait at least 15-20 minutes before checking the same feed again for new content.

These are the same constraints we use for the feeds we offer, btw. Websites prefer it, and it keeps us from getting blocked too.

If you're unsure whether the reader you're using adjusts its requests according to what websites ask for, reach out to the developer to confirm. When in doubt, it's safest to just leave the polling frequency at its default value.

Stick with the default user agent

A reader's "user agent" is the name it gives a website when it asks for a feed. It's sent every time the reader checks for new content, and again when a feed's images or videos load.

Fortunately, most self-hosted readers already send a proper one. Some let you change it and it's tempting to do so, especially to try to get problematic feeds working. But if you don't have any specific reason to change it, you probably shouldn't. A user agent that's vague, incorrect, or inaccurate is something websites can detect, and they'll likely limit or block the reader for it.

If a particular website needs it to be different from its default value, you should only change it for that site's feeds rather than for every site. And if you do still end up having to change it, it should include the following:

  1. The name of the reader
  2. The reader's version (so potential issues can be traced properly)
  3. A link to the reader's website or a support email address (in case the owner needs to be contacted)

A good user agent would be something like MyRSSReader/1.23.24 (https://example.com/docs).

If you're already using a self-hosted reader and unsure of what the user agent is, or don't know how to change it, you should contact the developer of the reader (or us, we don't mind).

Use the reader from a trusted location

Websites judge how suspicious a feed reader's requests are by the IP address they come from, and your home internet connection is likely the address they trust most.

You can run a self-hosted reader on a rented web server or behind a VPN to use a different IP address. But those are usually the same addresses most bad traffic comes from, so plenty of websites treat them with suspicion by default, and some block them outright.

If you go that route, pick a reputable provider. Just know that if the address it gives you has a history of abuse attached to it, your self-hosted reader will get blocked no matter how carefully it behaves.

What if I'm blocked?

When a website gets overwhelmed from too many requests, it starts turning readers away to protect itself, a concept called "rate limiting".

You'll know it when you see it. The feed takes forever to load, or quietly stops updating, or just sits there. Then you open the same feed in your browser and it's fine, new posts and all, making you think something's broken on your end. But the website's just telling your reader "no". And it usually isn't shy about telling your reader exactly why. If it's nice, it'll even say exactly how long to wait before asking again.

When it happens, you might be tempted to change the user agent, switch IP addresses, or even try a different reader, thinking that the site won't notice. But it really just makes you look even more suspicious, and that never ends well. Just wait it out. Blocks like this tend to lift on their own, and the website usually tells you when. If the block doesn't resolve in a reasonable amount of time, you'll likely need to reach out to the website owner to get it fixed.

Privacy and security

Self-hosting your reader may give you more control, but it doesn't make you invisible, and it certainly doesn't guarantee that everything you do is 100% secure.

You can still be tracked

The feeds in a self-hosted reader have to come from somewhere, and getting them means telling websites certain things about yourself. On their own, none of these say much. But collectively, they're enough to pick you out of a crowd.

What's tracked How What it exposes What you can do
Your location Your IP address gets sent out whenever the reader requests feed content Roughly where in the world you are, sometimes down to your city, and your internet provider Use a web server or a VPN to hide your IP, but it could increase the chances the reader gets blocked
Your reader and device The reader identifies itself in every feed request, and some readers on phones or tablets say what device they're on Which reader you use, its version, and your operating system. Uncommon readers and old versions stand out most Keep the reader updated so it looks less suspicious. Changing how it identifies itself is possible, but will likely get you blocked
Your habits and interests Images load from whichever item you open, the moment you open it. Videos go further, tracking how long you played, what you replayed or skipped, and where your mouse hovered When you read, what you like, and what keeps your attention, to show you personalized content and target you with ads Turn off auto-loading of images and videos, and think twice before playing one embedded in a feed
Where you came from When clicking a link What you read and where you read it Copy the link and paste it into your browser instead of clicking it

Open source doesn't mean safe

Most readers you run yourself are open source, which means the code is public and anyone can read it, spot problems, and suggest fixes. But all that openness doesn't mean the reader is actually safe to use, well built, or that it even works correctly.

Open source feed readers are usually worked on by a handful of people in their spare time, sometimes just one person. So it's not unusual for them to have all sorts of bugs that sit there, missed or ignored, for years.

This doesn't mean "don't self-host". It means being open source isn't a guarantee of privacy or that your data is safe, because a reader can still send out information about you, show you feed content without checking it first, or load scripts that let websites track you. So always use a self-hosted reader that's actively maintained, and make sure you install updates when they're available.

Last Updated:


Open RSS is a registered 501(c)(3) nonprofit headquartered in the District of Columbia, USA and funded only by voluntary donations of its users. If you enjoy using Open RSS, we'd be so grateful if you'd consider donating to help us grow and continue to provide you with a quality and reliable service.