Repolode
Submit
miniflux

miniflux/v2

A minimalist, self-hostable feed reader for RSS, Atom and JSON Feed, backed by PostgreSQL.

Open-source alternative to:FeedlyInoreader

View on GitHubWebsite
Stars
9,819
Forks
949
Open issues
279
Last commit
3 days ago

What is it?

Miniflux is a feed reader that aggregates RSS, Atom and JSON Feed subscriptions into a single web interface. It is written in Go and compiles to a single binary with static files embedded, and it requires PostgreSQL as its only database. Feeds are refreshed in the background by an internal scheduler or a cron job.

The project focuses on reading rather than organizing. It supports OPML import and export, categories, bookmarks, full-text search, and a local Readability parser that can fetch original articles when feeds only contain summaries. Custom CSS selector scraper rules and regex filters let users adjust what gets shown.

Privacy features include stripping tracking parameters, removing pixel trackers, using a media proxy, and blocking external JavaScript. Users can sign in with a local password, passkeys, Google, a generic OpenID Connect provider, or a reverse proxy. A REST API, Fever and Google Reader compatibility, and integrations with services such as Wallabag, Readeck and Pinboard let it work with existing clients and bookmarking tools.

Key features

  • 01Reads Atom, RSS and JSON Feed subscriptions, with OPML import and export.
  • 02Strips tracking parameters and pixel trackers, and runs a media proxy.
  • 03Extracts full article text with a local Readability parser and custom scraper rules.
  • 04Supports local, passkey, Google, OpenID Connect and reverse-proxy login.
  • 05Ships as a single Go binary that requires PostgreSQL.
  • 06Offers a REST API and Fever/Google Reader compatibility for third-party clients.

Use cases

  • Self-hosting a private RSS reader on a home server or VPS.
  • Following news, blogs and podcasts from one place with a minimal interface.
  • Reading feeds on mobile through a home-screen web app or compatible clients.
  • Sending articles to Wallabag, Readeck or Pinboard while reading.

Quick start

  1. 1

    Read the installation instructions linked in the README

  2. 2

    Install from the Docker image, Debian/RPM package, or pre-built binary, following the docs

Things to know

  • Works only with PostgreSQL, so you need a PostgreSQL database to run it.
  • Compatible only with modern browsers.

In collections

Self-hosted appsPrivacy & local-first toolsDatabases & SQL tools

Topics

#rss#feed-reader#self-hosted#go#postgresql#atom#json-feed#privacy#feed#golang

FAQ

What is v2?
A minimalist, self-hostable feed reader for RSS, Atom and JSON Feed, backed by PostgreSQL. Miniflux is a feed reader that aggregates RSS, Atom and JSON Feed subscriptions into a single web interface. It is written in Go and compiles to a single binary with static files embedded, and it requires PostgreSQL as its only database. Feeds are refreshed in the background by an internal scheduler or a cron job.
Is v2 free to use? What license does it have?
v2 is open source under the Apache-2.0 license. Check the license terms before using it in commercial products.
Is v2 still maintained?
Actively maintained. The last commit to v2 was on Oct 21, 2026.
What can I use v2 for?
Self-hosting a private RSS reader on a home server or VPS. Following news, blogs and podcasts from one place with a minimal interface. Reading feeds on mobile through a home-screen web app or compatible clients. Sending articles to Wallabag, Readeck or Pinboard while reading.
How do I install v2?
Read the installation instructions linked in the README Install from the Docker image, Debian/RPM package, or pre-built binary, following the docs
Where can I get v2?
The source code and installation instructions are on GitHub: https://github.com/miniflux/v2

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects