selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

Miniflux logo

Self-host Miniflux

2.3.5

Minimal, keyboard-driven RSS and Atom feed reader

ReleaseOpen SourceApache-2.0
Updated2 weeks ago
LanguageGo
Setup difficultyEasy
MobileResponsive
ThemeDark mode
Stars
9 943
Port
8080 (HTTP(S) web UI and API, LISTEN_ADDR default 127.0.0.1:8080; the Docker examples publish it as "80:8080")
Requires
PostgreSQL
Docker
docker.io/miniflux/miniflux
Install with Docker
Main overview of unread entries in the default light themeKeyboard navigation over the entry list in the dark themeResponsive layout of the entry list on a smartphoneEntry list view with save, star and original actionsArticle view with the fetch-original-content optionFeed editing screen: cookies, scraper rules and rewrite rules

What is Miniflux?

Miniflux alternatives

Should you self-host Miniflux?

Miniflux scores 73/100 on selfhost.directory (how scoring works) and ranks #3 of 86 in Feed Reader. It has 9 943 GitHub stars, +150 in the last 30 days.

It shipped 9 stable releases in the past year. The latest, 2.3.5, came out on 2 November 2026. New versions land roughly every 4 weeks.

Setup is easy: most people get it running in one sitting. An official Docker image is available. It is Apache-2.0-licensed and written mostly in Go.

Its closest alternative on selfhost.directory is RSSHub (86/100, 47 049 stars). It scores higher overall, so compare the two before you pick. See Miniflux vs RSSHub side by side.

Features

  • Categories and bookmarks
  • Content rewriting rules
  • CSS selector scraper rules
  • Fever and Google Reader API compatibility
  • Full-Text Search
  • Keyboard Shortcuts
  • Media proxy
  • OPML import and export
  • Original content fetching
  • Podcast and media enclosures
  • Public article sharing
  • Regex entry filters
  • REST API
  • RSS/Atom/JSON Feed Support
  • Tracking protection

Miniflux README

Miniflux 2

Miniflux is a minimalist and opinionated feed reader. It's simple, fast, lightweight and super easy to install.

Official website: https://miniflux.app

Features

Feed Reader
  • Supported feed formats: Atom 0.3/1.0, RSS 1.0/2.0, and JSON Feed 1.0/1.1.
  • OPML file import/export and URL import.
  • Supports multiple attachments (podcasts, videos, music, and images enclosures).
  • Plays videos from YouTube directly inside Miniflux.
  • Organizes articles using categories and bookmarks.
  • Share individual articles publicly.
  • Fetches website icons (favicons).
  • Saves articles to third-party services.
  • Provides full-text search (powered by Postgres).
  • Available in 20 languages: Portuguese (Brazilian), Chinese (Simplified and Traditional), Dutch, English (US), Finnish, French, German, Greek, Hindi, Indonesian, Italian, Japanese, Polish, Romanian, Russian, Taiwanese POJ, Ukrainian, Spanish, and Turkish.

How to install Miniflux

Install Miniflux with Docker

Environment variables
DATABASE_URL, RUN_MIGRATIONS, CREATE_ADMIN, ADMIN_USERNAME, ADMIN_PASSWORD
docker run -d \
  -p 80:8080 \
  --name miniflux \
  -e "DATABASE_URL=postgres://miniflux:*password*@*dbhost*/miniflux?sslmode=disable" \
  -e "RUN_MIGRATIONS=1" \
  -e "CREATE_ADMIN=1" \
  -e "ADMIN_USERNAME=*username*" \
  -e "ADMIN_PASSWORD=*password*" \
  docker.io/miniflux/miniflux:latest

Images are published to Docker Hub, GitHub Container Registry and Quay.io for amd64, arm64, arm/v7 and arm/v6; a pinned version tag is recommended over latest.

How to configure Miniflux

  • ADMIN_PASSWORDAdmin user password, used only when CREATE_ADMIN is enabled.
  • ADMIN_USERNAMEAdmin user login, used only when CREATE_ADMIN is enabled.
  • AUTH_PROXY_HEADERReverse-proxy authentication HTTP header; requires TRUSTED_REVERSE_PROXY_NETWORKS.
  • AUTH_PROXY_USER_CREATIONSet to 1 to create users from proxy authentication information. Disabled by default.

    values: 1/0, yes/no, true/false, on/off

  • BASE_URLhttp://localhostBase URL used to generate HTML links and the cookie base path.

Miniflux releases & version history

@ Every self-hosted release, weekly

One Monday email with the week's stable releases across the directory.

FAQ

Why aren't SQL migrations executed automatically?

Running them automatically caused problems, since only one process should touch the schema at a time and multiple containers can conflict; set RUN_MIGRATIONS=1 to have them applied at startup.

Which Docker architecture should I use?

Pulling latest or a pinned version tag downloads the correct image for your machine automatically; multi-architecture images exist since Miniflux 2.0.12.

Which binary should I use on Scaleway ARM machines?

The armv6 binary for a C1 server and the armv8 binary for ARM64 machines.

Which Debian package architecture should I use for my Raspberry Pi?

armhf for Pi 2 and 3, arm64 for Pi 3 and 4; the older A/B/Zero models are not supported by the Debian packages yet.

Which binary should I use on my Raspberry Pi?

Model A/A+/B/B+/Zero take the armv6 binary, Pi 2 and 3 the armv7 one, and Pi 3/4 the arm64 build.

What does "Save this article" mean?

It pushes the entry to a configured external service such as Pinboard or Instapaper.

Why is there no plugin system?

The project keeps a minimalist approach: a plugin system would add complexity, and plugins tend to be abandoned by their authors over time.

How can I create themes for Miniflux 2?

External stylesheets are not loaded, so themes are compiled into the binary; a new official theme has to arrive as a pull request that you then keep maintained, otherwise it gets removed.

Why does Miniflux store favicons in the database?

Because it follows Twelve-Factor App principles: nothing is written to the local filesystem, so the application can run in ephemeral containers without persistent storage.

Why is Feature X missing in Miniflux v2?

Version 2 does not try to re-implement everything from version 1; minimalism was taken further, so missing features must be contributed within that philosophy.

Why are you not developing my feature request?

Development time is limited on a free open-source project, the feature set is intentionally small, and improving what already exists comes before adding new things; users who want a feature are encouraged to contribute it.

Why are you not merging my pull request?

Pull requests are declined when they change too much to review, introduce breaking changes or regressions, add dependencies, slow the software down, conflict with its philosophy, are poorly written, depend on another PR, or radically alter the interface.

More in Feed Reader

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…